通过 Scavio（v2）调用 Google AI Mode

以结构化 JSON 格式获取 Google 的 AI Mode 回答：该回答由 AI 生成，拆分为多个文本块，并附带其引用的信源，以及针对商业类查询返回的购物结果。每次请求消耗 1 个积分。

触发时机

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

• 获取 Google AI 生成的问题答案及其引用来源
• 查看 Google AI Mode 对某一主题或产品的观点
• 提取 AI 答案背后的引用信源，用于事实核查或内容锚定（grounding）
• 回答商业类问题，并展示 AI 推荐的相关商品

配置方法

请前往 https://scavio.dev 免费获取 API 密钥（注册即赠 50 个免费积分，无需绑定信用卡）：

export SCAVIO_API_KEY=sk_live_your_key

接口地址

POST https://api.scavio.dev/api/v2/google/ai-mode
Authorization: Bearer $SCAVIO_API_KEY

每次请求消耗 1 个积分。

工作流程

1. 将用户的提问作为 query 参数发送。
2. 若答案具有地域性，可通过 gl / hl / location 参数进行本地化适配。
3. 从 text_blocks[] 中读取 AI 生成的回答，从 references[] 中读取所引用的信源，对商业类查询则从 shopping_results[] 中读取商品推荐。

参数说明

调用示例

import os, requests

response = requests.post(
    "https://api.scavio.dev/api/v2/google/ai-mode",
    headers={"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"},
    json={"query": "best running shoes for flat feet 2026", "gl": "us", "hl": "en"},
)
data = response.json()
for b in data.get("text_blocks", []):
    print(b.get("snippet") or b.get("text"))
for ref in data.get("references", []):
    print("source:", ref.get("title"), ref.get("link"))

响应格式

{
  "text_blocks": [
    { "type": "paragraph", "snippet": "AI-generated answer text..." }
  ],
  "references": [
    { "title": "Source article", "link": "https://example.com", "source": "Example" }
  ],
  "shopping_results": [],
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 995,
  "cached": false
}

使用约束

• 每次调用消耗 1 个积分。
• 严禁伪造 AI 回答、引用信源或商品信息；仅可返回 API 实际返回的数据。
• 必须完整呈现 text_blocks 中的内容，并始终同步返回其对应的 references，以便用户验证信源可靠性。
• Google AI Mode 不支持分页或结果筛选 —— 每次查询仅返回一个聚合答案。

错误处理

• 400：参数无效 —— 请检查并修正参数后重试。
• 401：API 密钥无效或缺失 —— 请确认环境变量 SCAVIO_API_KEY 已正确设置。
• 429：超出速率限制或总用量上限 —— 请等待后重试。详情参见 https://scavio.dev/docs/rate-limits。
• 502 / 503：上游服务暂时不可用 —— 建议等待数秒后重试。
• 若未返回 AI 回答，可能因当前查询未触发 Google AI Mode —— 请回退至 scavio-google 搜索技能。
• 若未设置 SCAVIO_API_KEY，请提示用户先执行 export SCAVIO_API_KEY=... 再继续操作。