用途:为 RAG 与 LLM 提供实时网页依据。与只返回链接和摘要的传统搜索 API 不同,它直接提取页面正文内容(文本块、表格、代码块、结构化数据),让 LLM 或 AI 智能体直接推理。
主要能力:单次请求完成一次搜索;返回 grounding.generic 中的 URL、标题与相关片段,sources 中给出标题、主机名、日期等元数据;支持本地召回(POI 与地图结果);支持 Goggles 自定义重排,可限定或排除来源,提升 RAG 质量。
使用方式:需 API Key(https://api.search.brave.com),包含在 Search 套餐。端点 GET/POST https://api.search.brave.com/res/v1/llm/context,认证头 X-Subscription-Token: <API_KEY>。示例:curl -s "https://api.search.brave.com/res/v1/llm/context?q=tallest+mountains+in+the+world" -H "Accept: application/json" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"。
关键参数:q(必填,1-400 字符、最多 50 词)、country、search_lang、count(默认 20,1-50)、freshness、maximum_number_of_tokens(默认 8192,1024-32768)、maximum_number_of_urls、maximum_number_of_snippets、context_threshold_mode(strict/balanced/lenient/disabled)、safesearch、enable_local、goggles、enable_source_metadata。本地查询可传 X-Loc-Lat/X-Loc-Long 或城市等位置头。
适用场景:AI 智能体工具调用、RAG 管线、聊天机器人、问答、事实核查、内容研究。
限制:需 API Key 与相应套餐;上下文越大延迟与推理成本越高;Goggles 托管规则需在 GitHub/GitLab 并注册;片段可能为纯文本或 JSON 序列化结构化数据;其余未在资料中说明的细节暂未提供。