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
搜索工作流建议:
- 使用用户的原始措辞作为初始查询。
- 仅当请求明确针对某一来源时,才使用 --type software-catalog 或 --type techdocs 限制搜索范围。
- 返回简短候选列表,而不是原始结果文档。
- 保留精确的实体引用、标题、位置、链接和结果类型。
- 如果首次搜索为空,可用更少或更宽泛的词重试一次。
- 仅在用户要求或首页结果明显不足时,才获取下一页。
- 报告所使用的确切查询和过滤条件。
- 当结果稀少时,不要编造服务或文档。
适用场景 适用于需要查找 Spotify Portal 中服务、API、系统或技术文档的场景,尤其适合通过自然语言快速定位软件目录条目或文档内容。
限制 该技能依赖 Portal CLI 的 search 命令,具体可用参数和返回字段以 CLI 实际输出为准。资料中未提供关于收费、价格、平台支持范围或效果保证的信息。