当用户希望查找与以下内容相关的预测市场/事件时，请使用此技能：

• 一段简短文本（主题、问题、标题）
• 一篇新闻文章的 URL
• 一条 X（Twitter）动态链接（后端将自动解析并提取推文正文）

适用场景（何时使用）

当用户提出以下请求时，请使用此技能：

• “为该主题/标题查找相关预测市场”
• “哪些市场匹配这条推文/X 链接？”
• “在 Polymarket/Kalshi 中搜索关于……的事件”

本技能最适合用于：

• 将非结构化文本（或 X 链接）转化为已排序、可直接操作的事件链接
• 快速返回前 5–10 个匹配项，并附带简明的市场快照

以下情况不建议使用本技能：

• 需要完整市场订单簿或历史 K 线数据（请改用 market-data 接口）
• 需要深度情感分析或时间线生成（请改用 event deep-dive 接口）

本技能调用现有的 Prediction Bridge 后端接口：

• POST /api/v1/search/unified

返回匹配的 events（预测市场事件），并可选返回匹配的 news。

配置

API 基地址（默认为生产环境）：

• PREDICTION_BRIDGE_API_URL

默认值：

• 生产环境：https://prediction-bridge.onrender.com/api/v1
• 本地开发（若你本地运行后端）：http://localhost:8000/api/v1

如何运行

1. 构建查询文本

• 若用户提供的是 X 动态链接，请原样将其作为 text 字段传入；后端将负责解析。
• 若用户提供的是纯文本，请直接传入。

2. 调用统一搜索接口

使用 exec 执行 curl 命令：

API_URL="${PREDICTION_BRIDGE_API_URL:-https://prediction-bridge.onrender.com/api/v1}"

curl -sS -X POST "$API_URL/search/unified" 
  -H "Content-Type: application/json" 
  -H "X-Request-ID: pb-$(date +%s)" 
  --data-binary @- <<'JSON'
{
  "text": "",
  "limit": 10,
  "offset": 0,
  "include_inactive": false,
  "include_markets": true,
  "markets_per_event": 1,
  "include_translations": false
}
JSON

说明：

• 使用 markets_per_event: 1 可保持响应体体积较小，同时仍展示主市场。
• 若用户明确要求每个事件返回更多市场，请增大 markets_per_event 的值。

API 响应格式（你将收到的内容）

POST /search/unified 返回如下结构的 JSON（部分字段可能因数据不可用而缺失或为 null）：

{
  "source": {
    "type": "x" ,
    "url": "https://x.com/.../status/...",
    "text": "resolved tweet text (optional)",
    "id": "optional"
  },
  "events": [
    {
      "score": 0.82,
      "event": {
        "id": 123,
        "title": "...",
        "description": "...",
        "source": "polymarket",
        "source_url": "https://polymarket.com/event/...",
        "status": "active",
        "volume_usd": 12345.67,
        "liquidity_usd": 2345.0,
        "end_date": "2026-12-31T00:00:00Z",
        "markets": [
          {
            "id": 999,
            "question": "...",
            "outcomes": ["Yes", "No"],
            "outcome_prices": {"Yes": 0.61, "No": 0.39},
            "volume": 1000.0,
            "active": true,
            "closed": false
          }
        ]
      }
    }
  ],
  "news": [
    {
      "score": 0.74,
      "news": {
        "id": 456,
        "title": "...",
        "summary": "...",
        "url": "https://...",
        "image_url": "https://...",
        "source": "...",
        "published_at": "2026-02-01T12:34:56Z"
      }
    }
  ]
}

关键要点：

• events[] 是主要输出。每项结构为 { score, event }。
• score 表示相关性得分，数值越高表示匹配度越好。
• event.markets 字段仅在请求中设置 include_markets: true 时存在。
  • 当设置了 markets_per_event，后端可能只返回预览子集。
• news[] 是可选的辅助上下文信息，请勿让其干扰或淹没事件结果。

Agent 应如何解析与处理结果

重要提示：

• 切勿向用户直接展示原始 JSON 响应。
• 必须先解析并校验响应，再以清晰、易读的方式呈现匹配的 events 列表。

1. 校验响应结构

• 若 JSON 缺失或无效，视为失败，最多重试一次（或提示用户重试）。
• 若 events 字段缺失或非数组类型，则视为空列表。

2. 排序与筛选

• 始终按 score 降序排列 events（即使后端已排序）。
• 默认展示前 5 条结果；若用户明确要求“更多”，则最多展示 10 条。

3. 为每个事件提取“市场快照”（尽力而为）

• 优先使用 event.source_url 作为点击跳转链接。
• 若 event.source_url 缺失，则回退至前端详情页：
  • https://www.predictionbridge.xyz/event/
• 若 event.markets[0].outcome_prices 存在：
  • 优先显示 YES/Long 价格（即 outcome_prices.Yes 或 outcome_prices.Long）
  • 否则显示第一个可用的结果价格

4. 输出简洁结果

• 对每个事件，输出以下内容：
  • 标题
  • 来源平台（event.source）
  • 相关性得分（四舍五入，例如 0.82）
  • 链接（优先使用 event.source_url）
  • 一行快照：概率（如有）+ 成交量/流动性（如有）

5. 可选：包含相关新闻

• 若 news 存在，最多附加 1–3 条，仅含标题 + URL，作为补充上下文。

6. 空结果处理

• 若 events 为空：
  • 告知用户未找到强匹配项
  • 请求 1 项澄清信息（例如时间范围、地理区域、人物/机构名称，或建议粘贴原文而非短链）

结果呈现方式

收到 JSON 后：

• 若 events 为空，则说明未找到匹配项，并提示用户提供更具体的查询。
• 否则列出最佳匹配结果（通常为 5–10 条）：
  • 事件标题
  • 平台/来源（如 Polymarket、Kalshi）
  • 相关性得分（越高越好）
  • 事件链接（优先使用 event.source_url）
  • 市场快照（取 event.markets 中首个市场，若有）

若 news 存在，可选择性地展示 1–3 条相关新闻作为上下文。

错误处理

• HTTP 400：输入无效或 X 链接解析失败 → 提示用户更换链接或提供纯文本。
• HTTP 503：后端数据库不可用 → 建议稍后重试。
• 任意网络错误：确认 PREDICTION_BRIDGE_API_URL 设置是否正确，以及 API 是否可达。