有赞开发者知识检索

开始前

本 Skill 随 @youzan/ai-toolkit 发布并同步到有赞云公网 npm 镜像，且内嵌在 CLI 中。执行检索前读取当前 CLI 版本携带的说明：

youzan-toolkit skills read yzy-open-knowledge-search
youzan-toolkit docs search --help

CLI 负责请求、参数校验、鉴权、TLS、结果缓存和结构化输出；本 Skill 负责场景判断和结果解释。

配置

发行包不包含内网地址或默认凭证。首次使用时配置可从公网访问的 HTTPS 服务：

youzan-toolkit config init --endpoint 'https://<public-service>/search'

也可以仅为当前进程使用环境变量：

export YOUZAN_TOOLKIT_ENDPOINT='https://<public-service>/search'
export YOUZAN_TOOLKIT_AUTHORIZATION='Bearer <token>'

命令行 --authorization 的优先级最高。查看状态不会输出真实凭证：

youzan-toolkit auth status

默认参数

检索流程

1. 提取用户的真实问题作为 --keyword。
2. 用户指定 topN、retrievalType 或 filters 时覆盖默认值。
3. 调用 youzan-toolkit docs search。
4. 优先使用高分结果、原文内容和类目路径回答。
5. 需要完整文档时，从结果提取标识并调用 docs read。
6. 结果不足以支撑结论时，明确说明没有检索到充分依据。

youzan-toolkit docs search --keyword '问题'
youzan-toolkit docs search --keyword '问题' --top-n 5 --retrieval-type 2
youzan-toolkit docs search --keyword '问题' --dry-run
youzan-toolkit docs read --id '<搜索结果 ID>'
youzan-toolkit openapi schema 'youzan.item.get'

输出要求

• 先基于检索结果给出结论，不只输出接口 JSON。
• 归纳关键依据，不编造服务未返回的事实。
• 默认使用 JSON 供 Agent 组合；面向人类时可使用 --format pretty。
• 用户要求原始结果时使用 --full-response。