OmniRoute 网页搜索技能通过 OmniRoute 代理整合多个搜索服务商(Tavily、Brave Search、SerpAPI、Exa),并支持自动故障转移,让调用方以统一格式获取实时网页搜索结果。
用途:当用户需要实时网页搜索结果、最新新闻或当前信息时使用该技能。
使用前提:需要配置环境变量 OMNIROUTE_URL 与 OMNIROUTE_KEY,具体设置方式参见入口 SKILL 文档。
接口与发现:搜索端点为 POST $OMNIROUTE_URL/v1/web/search,采用统一搜索格式。可通过 curl $OMNIROUTE_URL/v1/models/web | jq '.data[] | select(.kind == "webSearch")' 发现可用的搜索模型。
调用示例:
curl -X POST $OMNIROUTE_URL/v1/web/search
-H "Authorization: Bearer $OMNIROUTE_KEY"
-H "Content-Type: application/json"
-d '{
"model": "tavily/search",
"query": "OmniRoute github latest release",
"max_results": 5,
"include_answer": true
}'
响应格式为 { answer?, results:[{ url, title, content, score }] }。
参数说明:model 为来自 /v1/models/web 的服务商模型;query 为搜索查询;max_results 为最大结果数(默认 5);include_answer 为是否包含 AI 合成答案;search_depth 为 basic 或 advanced(Tavily)。
错误处理:400 query_too_long 表示查询过长,应缩短搜索查询;503 表示服务商不可用,可尝试 /v1/models/web 中的其他模型。