Composio 中 Tavily 搜索工具的使用指南工具 Slug 迁移、API Key 连接与免鉴权搜索方案【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio导读本文聚焦 Composio 平台中 Tavily 搜索集成的三个实战问题如何用最新工具 SlugCOMPOSIO_SEARCH_TAVILY稳定调用 Tavily 搜索、如何在旧版 JS SDK 中通过generic_api_key建立 Tavily API Key 连接以及如何在无需单独鉴权的前提下使用composio_search工具集获得 Exa/Tavily 风格的搜索能力。读完本文你将掌握 Tavily 在 Composio 中的正确调用方式、旧 SDK 的兼容方案以及免鉴权搜索与独立 Tavily 集成的取舍依据。一、在 Composio 中使用 Tavily 搜索优先使用COMPOSIO_SEARCH_TAVILYTavily 是面向 AI Agent 的搜索与数据检索服务帮助团队快速从文档、数据库与网页中定位并筛选相关信息。在 Composio 生态中Tavily 以独立工具集toolkit的形式提供其元信息可在 docs/public/data/toolkits.json 中查到slug 为tavily认证方式为API_KEY共包含 5 个工具版本为20260717_00类别为 ai web scraping。1.1 新版工具 SlugCOMPOSIO_SEARCH_TAVILY当你需要通过 Composio 调用 Tavily 搜索时应当使用更新后的工具 SlugCOMPOSIO_SEARCH_TAVILY。该工具对应工具集composio_search其正式名称为 Composio LLM Search在 docs/public/data/toolkits.json 中定义如下SlugCOMPOSIO_SEARCH_TAVILY能力作为 Composio LLM Search API 的网关支持跨广泛内容的搜索与多种过滤选项可处理包含关键词与短语的复杂查询并支持指定搜索深度、是否包含图片与直接答案、按域名过滤、控制返回结果数量等参数覆盖从快速查询到深度调研的多种场景。在 ts/packages/cli/src/generated/toolkit-slugs.ts 中composio_search被列入已知的工具集 slug 列表这说明该工具集是 CLI 工具链官方认可的解析目标其下的COMPOSIO_SEARCH_*系列工具包括COMPOSIO_SEARCH_TAVILY均可正常路由。为什么需要切换 Slug根据 docs/kb/source/toolkits/tavily/public.md 的说明如果旧版 Tavily 搜索 Slug 返回 schema 相关的网关错误gateway errors应切换到COMPOSIO_SEARCH_TAVILY后再进行深度调试。也就是说遇到 schema 类错误时优先怀疑 Slug 是否过时先切换再排查其他问题可以省去大量不必要的排障时间。1.2 独立 Tavily 工具集与其内置工具如果你需要 Tavily 作为独立的、由自身提供商provider支撑的集成则使用独立的tavily工具集。该工具集包含 5 个工具docs/public/data/toolkits.json工具 Slug名称用途TAVILY_CRAWLTavily crawl基于图结构的智能网站爬取支持并行路径探索与内容提取可控制深度/广度、域名过滤并支持自然语言指令引导TAVILY_EXTRACTTavily extract从指定 URL 提取并解析网页内容支持可选图片提取与基于查询相关性的内容重排TAVILY_GET_USAGEGet Tavily usage查询 API Key 与账户的使用统计搜索、提取、爬取、地图、研究等端点的信用消耗与限额TAVILY_MAPTavily map website扫描网站并发现其页面返回结构化 URL/页面列表不提取完整内容TAVILY_SEARCHTavily search通过 Tavily API 执行网页搜索支持搜索深度、内容类型、结果数量与域名过滤需有效 Tavily 连接401 表示认证失败速率限制约 2 req/s遇到 HTTP 429 应使用指数退避结果嵌套在response_data.results下非扁平列表二、在旧版 JS SDK 中通过generic_api_key建立 Tavily 连接当你在旧版legacyJS SDK 中使用 Tavily 的 API Key 认证时需要分两步完成连接建立2.1 列出 Tavily 集成并获取 integration ID首先调用toolset.integrations.list并指定appName: tavily获取 Tavily 集成信息const integrations await toolset.integrations.list({ appName: tavily }); // 从返回结果中取出目标 integration 的 ID const integrationId integrations[0].id;2.2 使用generic_api_key发起连接随后用以下参数发起 connected account已连接账户await toolset.initiateConnection({ appName: tavily, authMode: API_KEY, integrationId: integrationId, // 上一步列出的集成 ID authConfig: { generic_api_key: tavily-api-key // 你的 Tavily API Key } });关键参数说明appName固定为tavily用于定位目标应用authMode固定为API_KEYTavily 仅支持 API Key 认证在 docs/public/data/toolkits.json 中tavily的authSchemes只有API_KEY一项authConfig.generic_api_keyTavily API Key 的字段名。根据 docs/public/data/toolkits.json 中的authConfigDetails定义Tavily 的 API Key 以tvly-开头例如tvly-dev-abc123可在 app.tavily.com 的 API Keys 区域复制两种 key 类型均可使用。注意这一流程是作为 JS SDK 某已知问题的 workaround 提供的。官方建议当当前currentSDK 流程可用时优先使用当前 SDK 的标准连接流程仅当遇到旧版 SDK 的兼容问题时才回退到上述generic_api_key方案。三、免鉴权搜索使用composio_search工具集如果工作流需要的是开箱即用的网页搜索能力且不想为每个搜索服务单独配置认证composio_search是更合适的选择。3.1composio_search的定位与能力composio_search是 Composio 提供的综合搜索工具集在 docs/public/data/toolkits.json 中定义如下认证方式NO_AUTH无需任何外部认证工具数量22 个覆盖范围旅行航班、酒店、活动、电商Amazon、Walmart、购物、金融市场、新闻、学术研究、图片与位置服务等。其工具命名遵循COMPOSIO_SEARCH_*前缀例如工具 Slug能力COMPOSIO_SEARCH_WEB通用网页搜索Exa/Tavily 风格搜索的核心入口之一COMPOSIO_SEARCH_TAVILY基于 Tavily 的 LLM 搜索即本文 1.1 节推荐的 SlugCOMPOSIO_SEARCH_NEWS新闻搜索支持when时间窗口与site:域名过滤COMPOSIO_SEARCH_IMAGE图片搜索返回图片元数据与 URLCOMPOSIO_SEARCH_FINANCE实时股价、市场数据与财经新闻COMPOSIO_SEARCH_FLIGHTS/COMPOSIO_SEARCH_HOTELS航班与酒店搜索COMPOSIO_SEARCH_DUCK_DUCK_GODuckDuckGo 搜索COMPOSIO_SEARCH_GOOGLE_MAPS地图与本地商户搜索COMPOSIO_SEARCH_TRENDS趋势话题与搜索热度分析COMPOSIO_SEARCH_FETCH_URL_CONTENT抓取网页并提取干净的 Markdown 文本由于composio_search声明为NO_AUTH调用这些工具时无需单独建立认证连接可直接在会话中执行适合原型验证、快速集成或需要聚合多种搜索源的 Agent 场景。3.2 与独立 Tavily 工具集的取舍选composio_search当工作流只需要搜索这一能力、不关心底层由哪家搜索服务提供时使用composio_search可获得 Exa/Tavily 等多种搜索能力且免鉴权集成成本最低。选独立tavily工具集当工作流明确需要 Tavily 作为自己的、由 provider 支撑的集成时例如需要精确控制 Tavily 特有的 crawl/extract/map 能力、查询用量或进行品牌级集成应使用独立的tavily工具集并配置 API Key。3.3 从 CLI 工具链看 slug 解析机制在 ts/packages/cli/src/utils/toolkit-from-tool-slug.ts 中工具 Slug 到工具集的解析遵循最长前缀匹配策略对A_B_C_D形式的 Slug依次尝试a_b_c、a_b、a取第一个出现在已知工具集列表中的候选。例如COMPOSIO_SEARCH_TAVILY会命中前缀composio_search从而正确归属到该工具集。同时需要注意 ts/packages/cli/src/utils/meta-tool-slugs.ts 中定义的元工具meta tool列表COMPOSIO_SEARCH_TOOLS、COMPOSIO_MULTI_EXECUTE_TOOL、COMPOSIO_MANAGE_CONNECTIONS等 Slug 属于会话级元工具并非某个工具集的工具。其中COMPOSIO_SEARCH_TOOLS在命名上看似属于composio_search工具集但解析器会先检查元工具列表见isMetaToolSlug避免将元工具误归到真实工具集。这一点在排障时值得留意COMPOSIO_SEARCH_TOOLS元工具与COMPOSIO_SEARCH_TAVILY真实搜索工具是不同的东西。四、常见问题与排障建议旧 Tavily 搜索 Slug 报 schema 网关错误优先切换到COMPOSIO_SEARCH_TAVILY再深入排查。该错误通常源于 Slug 过时而非连接或参数配置问题。TAVILY_SEARCH返回 401表示 Tavily 连接认证失败请检查 API Key 是否有效、连接是否已成功建立参照第二节的generic_api_key流程或当前 SDK 标准流程。TAVILY_SEARCH返回 HTTP 429触发速率限制约 2 req/s应对返回结果使用指数退避重试避免快速连续请求。TAVILY_SEARCH结果为空结果嵌套在response_data.results下而非扁平列表解析时注意数据结构层级。不想为搜索单独配置认证改用composio_search工具集下的COMPOSIO_SEARCH_WEB或COMPOSIO_SEARCH_TAVILY两者均无需额外认证。五、相关文档与源码索引关联文档docs/kb/source/toolkits/tavily/public.md本文的事实来源Tavily 工具集定义docs/public/data/toolkits.jsoncomposio_search工具集定义docs/public/data/toolkits.json工具集 slug 白名单ts/packages/cli/src/generated/toolkit-slugs.tsSlug→工具集解析逻辑ts/packages/cli/src/utils/toolkit-from-tool-slug.ts元工具 Slug 识别ts/packages/cli/src/utils/meta-tool-slugs.ts会话配置中禁用高级搜索工具集的方法以 SerpAPI 为例同类方式适用于composio_searchdocs/content/kb/guide/toolkits-serpapi.mdx【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考