SuperAPI AI 工具集

search

通用与其它

查看项目

更新于 10-16 05:57

技能介绍

Search 是 Spotify Portal 提供的一项搜索能力,用于在 Spotify Portal 的软件目录(software catalog)和技术文档(techdocs)中进行自然语言检索。当用户提出查找服务、API、系统或相关技术文档的需求时,可以使用该技能。

主要能力 该技能以 Portal CLI 的 search 命令作为唯一可信来源。通过命令行调用,可以执行搜索并获取结构化结果。支持使用 --type 参数将搜索范围限定为 software-catalog 或 techdocs,仅在请求明确指向某一来源时使用。结果可以以 JSON 格式输出,并可通过 --limit 控制返回条数。

使用方式 基本调用命令如下:

npx @spotify/portal-cli search --help npx @spotify/portal-cli search <query> --limit 10 --json

搜索工作流建议:

  1. 使用用户的原始措辞作为初始查询。
  2. 仅当请求明确针对某一来源时,才使用 --type software-catalog 或 --type techdocs 限制搜索范围。
  3. 返回简短候选列表,而不是原始结果文档。
  4. 保留精确的实体引用、标题、位置、链接和结果类型。
  5. 如果首次搜索为空,可用更少或更宽泛的词重试一次。
  6. 仅在用户要求或首页结果明显不足时,才获取下一页。
  7. 报告所使用的确切查询和过滤条件。
  8. 当结果稀少时,不要编造服务或文档。

适用场景 适用于需要查找 Spotify Portal 中服务、API、系统或技术文档的场景,尤其适合通过自然语言快速定位软件目录条目或文档内容。

限制 该技能依赖 Portal CLI 的 search 命令,具体可用参数和返回字段以 CLI 实际输出为准。资料中未提供关于收费、价格、平台支持范围或效果保证的信息。