SuperAPI AI 工具集

search-docs

编程与开发

查看项目

更新于 10-30 19:19

技能介绍

search-docs 是一个面向 Meta 社交技术开发者平台文档的检索技能,用于回答 API 相关问题、查找集成指南以及了解平台能力。

一、用途 该技能用于搜索 Meta Social Technologies 开发者平台文档,帮助用户理解某个 Meta API 的工作方式、定位集成指南,或探索平台功能。

二、前置条件 该技能需要 Meta Social Technologies MCP 服务器 devtools(https://mcp.facebook.com/devtools,streamable-http)。插件安装会捆绑该服务器;而仅安装技能的方式(如 npx skills add)不会捆绑,需要单独完成设置。

如果 mcp__devtools__* 工具不可用,应立即停止,不得编造工具输出(包括第一步的跟踪调用)。此时应请用户添加服务器并完成其 OAuth 流程,且不要向用户索取访问令牌,完成后再继续。

三、工作流

  1. 开始跟踪:在任何其他工作之前,调用 devtools_skill_invocation,action 为 start,skill_name 为 search-docs。后续每个 devtools_* 工具调用都应传入 skill_name 为 search-docs。
  2. 理解查询:判断用户所需类型,例如 API 参考(如“Page API 如何工作?”)、集成指南(如“如何设置 Instagram webhooks?”)、故障排查(如“为什么出现错误码 190?”)、功能探索(如“WhatsApp Business API 能做什么?”)。
  3. 搜索:调用 devtools_discovery,action 为 search_docs;构造清晰具体的查询,max_results 从 5 开始;若结果过宽,细化查询后再次搜索。
  4. 展示结果:对每条结果给出标题与简要描述、与用户问题的直接相关性、关键要点或下一步。
  5. 必要时细化:若初始结果未回答问题,可更换检索词(如用“Graph API permissions”代替“Facebook API access”),通过 offset 分页查看更多结果,并依据返回内容扩大或收窄查询。
  6. 综合回答:不要只列链接,而要提取答案,概括相关文档,指出关键要求、限制或注意事项,并在适用时提供代码模式或配置步骤。
  7. 结束跟踪:完成上述所有步骤后,调用 devtools_skill_invocation,action 为 end,skill_name 为 search-docs。

四、搜索技巧 使用产品特定术语(如“WhatsApp Business API”而非“WhatsApp API”);包含具体操作(如“create ad campaign”而非“ads”);错误码使用精确代码(如“error 190”或“OAuthException”);权限查询包含权限名(如“pages_read_engagement permission”)。

五、何时建议其他技能 若用户查询 webhook 配置,建议 /webhook-setup;若研究应用审核要求,建议 /app-review-prep;若排查合规问题,建议 /compliance-check。

六、限制 该技能依赖 MCP 服务器连接与 OAuth 完成;仅安装技能而不配置服务器时不可用。资料未提供价格、平台覆盖范围或效果保证等信息。