Muse 怎么接 Tavily 搜索？从安全建连到核对来源与额度

01｜先想好要查的一件事

自定义搜索连接器适合解决一个边界清楚的问题，比如“查某个产品本周发布了哪些更新，并优先看官方文档”。如果你只说“帮我研究一下这个行业”，Muse 得先猜主题、时间和来源，搜索结果容易散开，也更难控制用量。先把问题缩到一个答案能被公开网页核对的范围。

Meta 的帮助中心说明，用户可以在对话里请 Muse 创建自定义连接器。Muse 会引导使用者提供服务的 API 信息，并将凭据保存在 Secure Credentials Store。Meta 也明确说明自定义连接器不会经过 Meta 审核。因此，开始前要读 Tavily 的服务条款和隐私说明，只接入自己愿意让 Muse 调用的账户与功能。本站没有在真实 Muse 账户中创建或测试连接器。

02｜从 Tavily 官方平台取得自己的 API key

Tavily Quickstart 让用户登录 Tavily Platform，再从账户 Dashboard 复制 API key。当前官方额度页列出每月 1,000 个免费 API credits，且不要求信用卡；具体账户额度和付费设置以你的平台页面为准。先找到使用量和套餐限额，再决定是否允许按量计费。

API key 相当于调用账户服务的凭据。只在你确认属于 Tavily 与 Muse 官方连接流程的安全凭据步骤中提交，不把真实 key 放进普通聊天提示、示例代码、截图、共享笔记或文章。若 Muse 只要求你把 key 明文贴到聊天里，先停下来，不要提交；回到官方说明确认当前安全输入方式。示例中只写 `[在安全凭据步骤中选择 Tavily API key]`，不使用看似真的字符串。

03｜用 Tavily 官方文档作为连接器说明

Tavily 官方账号在 X 上给出的起步方法，是在 Muse 对话中要求根据 Tavily 文档创建连接器，再在接下来的凭据步骤中添加 API key 并测试。Meta 帮助也确认 Muse 能通过对话引导自定义连接器流程。可把要求改写得更明确，先让 Muse 说明它要调用什么，再决定是否继续。

可以这样写。‘请根据 Tavily 官方文档 https://docs.tavily.com/ 帮我创建一个只用于网页搜索的自定义连接器。先说明将连接的 Tavily 服务、会调用的搜索能力、需要的访问范围和可能的费用；不要开始搜索其他主题。创建前等我检查凭据授权步骤。API key 只通过安全凭据流程提交，不要要求我把 key 粘贴到聊天、代码或回复里。连接后只做一条低成本的测试查询，列出 Tavily 实际返回的 HTTP 状态和 credit 用量；如果某项在连接器结果中看不到，就标记为不可见，不要补猜。保留结果标题、来源 URL 和可见日期，不要把生成式摘要当成已核实事实。’

这个提示词只表达任务限制，不会替代连接器授权。若 Muse 展示的域名或授权内容与你预期不符，先取消，不要因为它说“已连接”就继续。Meta 也提醒用户，服务方自己的条款和隐私政策会约束连接器收到的信息。

04｜先用一条低预算查询确认工具确实可用

Tavily 搜索接口的 basic、fast 和 ultra-fast 查询各消耗 1 credit，advanced 消耗 2 credits。第一次只测一条基础查询，并把最大结果数设小一些。Search API 支持 `max_results`、`search_depth`、`include_domains` 等选项；先问 Muse 它实际设置了什么，再按真实返回调整。不要连续让它用多个关键词反复搜索来“证明”连接器正常。

测试成功时，检查返回中有没有 Tavily 的结果列表和每条来源 URL。若只看到一段回答，没有来源条目、请求状态或用量信息，就继续要求它展示接口实际返回字段，或者回到 Tavily 平台核对用量。不能单凭文字回答判断它确实调用了 Tavily。

05｜把问题、来源范围和日期边界写具体

一个能复查的搜索任务至少写清主题、范围、来源偏好、时间窗口和交付格式。Tavily Search 支持限定域名，也能设置开始和结束日期；结果可以带标题、网址、内容片段和估计的发布时间。比如查询“最近一个月某工具的 API 变更”，就把“最近一个月”换成具体日期，并指定官方 docs 与 changelog 域名优先。

官方文档说明，Tavily 对发布时间的识别只是最佳估计，字段仍可能为空。如果把 `filter_by_published_date` 打开，未识别到日期的结果也会被剔除；如果你不希望丢掉这类来源，就保留未开启状态，同时要求它把缺失日期标为“无可识别日期”，不要硬填日期。域名和日期筛选缩小的是检索范围，不等于来源本身已经正确。

可以直接用这段查询要求。‘仅查 [问题]，范围为 [具体日期起止]。优先限定在 [官方域名列表]，每条结果返回原网页标题、完整 URL、Tavily 给出的发布日期（缺失就标无日期）、搜索片段和它支持的具体事实。最多返回 5 条。没有来源支持的结论写待核实。先给结果清单，不要只输出总结。’

06｜逐条打开来源，再决定能不能采用结论

Tavily 会为搜索结果返回网页 URL 和内容片段，也可以选择带上生成式 answer。Answer 是搜索响应中的一项，不会自动证明事实成立。先打开原网页，确认它是否真在说这件事，再核对作者、发布日期、更新日期、引用对象和上下文。关键结论优先回到官方文档、公告或原始数据页面。

把每个结果拆成三列会更好查，分别记录原页面明确写了什么、Muse 从中归纳了什么、还缺哪项证据。来源标题相同但网址跳到了镜像或搜索摘要时，继续找到发布者原页。网页打不开、只有片段或日期不明，就把它当作线索，别填补空白。

07｜看懂额度与 HTTP 报错，避免盲目重试

Tavily 文档列出了常见状态码。400 可表示参数不合法；401 是缺失或无效 API key；422 表示请求字段类型或格式不对；429 是超过请求速率限制，若响应带 `Retry-After`，按该秒数等待；432 可能表示套餐使用上限；433 示例表示超过按量计费上限。状态与错误正文要看实际 response，别把所有失败都当成“额度用完”。

连接报错时，先让 Muse停止继续调用，只回报 HTTP 状态码、脱敏后的错误摘要和 request id。401 时检查密钥是否在安全授权流程中正确保存，不要把 key 发给它让它回显；400 或 422 检查参数和字段类型；429 看 `Retry-After` 并降低频率；432/433 回 Tavily 仪表板核对套餐与额度。不要自动升级套餐或开启付费。

08｜把连接器限制在搜索任务里，并定期检查

检查这次小任务时，看看连接器是否响应正常、查询是否只跑了一次、用量能否对上。结果还应保留来源 URL 和日期信息，关键结论能在原页找到。若输出没有来源、反复重复同一搜索或把估计日期写成事实，就先改提示词或参数，不要直接扩大调用范围。任何生成式摘要都需要回到原始来源核查。

完成后检查 Tavily 的使用量、Muse 的连接器设置与凭据状态。Meta 说明可以在 Settings 的 Connectors 管理连接并断开；断开后，之前用于任务的信息仍可能留在 Muse 记忆或对话历史中。只要不再需要，按当前界面取消授权，并检查对话中是否留有敏感内容。想了解 Muse 的基础使用方式，可继续阅读 <a href="/guides/how-to-use-muse/">Muse 上手教程</a>。