Xikapi 接入文档

实时搜索 ​

Grok 的一项重要能力是结合实时信息回答问题。对于新闻、网页、X 信息、市场动态、版本变化等时效性问题，建议启用搜索工具，而不是只依赖模型内部知识。

什么是实时搜索 ​

实时搜索让模型在生成答案前查询外部信息源，例如 Web 或 X。它适合处理已经变化、可能变化或需要引用来源的问题。

常见场景包括：

  • 最新新闻
  • 公司、产品或模型更新
  • 社交媒体动态
  • 公开网页信息
  • 近期政策和公告
  • 需要来源链接的回答

适合哪些场景 ​

场景建议
最新信息启用搜索
稳定知识可以不搜索
需要来源启用搜索并返回引用
企业私有数据使用自定义工具或知识库
高风险决策搜索结果仍需人工复核

Web Search 适合查询公开网页、文档、公告和新闻。

json
{
  "model": "grok-4.3-latest",
  "tools": [
    {
      "type": "web_search"
    }
  ],
  "input": [
    {
      "role": "user",
      "content": "Find the latest xAI API model updates and summarize the main changes"
    }
  ]
}

如果 Xikapi 后台对搜索工具字段做了兼容封装，请以后台配置为准。

X Search 适合查询 X 平台上的实时帖子和公开讨论。

json
{
  "model": "grok-4.3-latest",
  "tools": [
    {
      "type": "x_search"
    }
  ],
  "input": [
    {
      "role": "user",
      "content": "Search public discussions on X about a product launch and summarize the key concerns"
    }
  ]
}

搜索结果如何进入回答 ​

搜索工具通常由模型决定是否调用。工具返回结果后，模型会基于搜索内容生成最终回答。

服务端建议记录：

  • 是否调用搜索
  • 搜索工具类型
  • 搜索查询词
  • 引用链接
  • 工具调用成本
  • 最终回答的时间戳

成本和延迟 ​

实时搜索可能增加成本和延迟。生产环境建议：

  • 只在需要最新信息时启用搜索
  • 对搜索次数设置上限
  • 对用户或应用设置额度
  • 缓存可复用的搜索结果
  • 给前端展示“正在搜索”的状态

注意事项 ​

  • 搜索结果不等于事实，需要判断来源可靠性
  • 对金融、法律、医疗等高风险信息要保留人工复核
  • 不要把私有数据通过公开搜索工具发送出去
  • 对需要精确引用的场景，保留来源 URL 和访问时间
  • 搜索工具字段可能随供应商更新而变化，接入前应对照 Xikapi 后台支持情况