yqcloud-knowledge

YQCloud Knowledge Base Query Tool. Retrieve relevant knowledge snippets from the YQCloud knowledge base. Use this skill when users need to query the YQCloud knowledge base, search internal documents, find product usage instructions, or mention 'knowledge base', 'look it up', 'YQCloud documentation'. This skill relies on the token provided by yqcloud-login-auth.

YQCloud 知识库查询

概述

从燕千云知识库中检索相关知识片段，返回与问题最匹配的文档内容。基于语义搜索，支持自然语言提问。

依赖

yqcloud-login-auth: 需要先完成 OAuth 登录，token 存储在 ~/.yqcloud_tmp/token.json

触发条件

当用户需要：

查询燕千云知识库内容
搜索内部文档或产品说明
提到"知识库"、"查一下"、"燕千云文档"、"帮我查"
需要燕千云产品的使用方法、配置说明等

API 信息

端点: https://api.yqcloud.com/ai/v1/228549383619211264/aigc_knowledge/chunks
方法: GET
参数:
- question: 查询问题（URL 编码）
- top: 返回结果数量（默认 5）
Headers:
- Authorization: bearer <access_token>
- x-tenant-id: 228549383619211264

执行步骤

1. 检查 Token

cat ~/.yqcloud_tmp/token.json 2>/dev/null

如果 token 不存在，提示用户先运行 yqcloud-login-auth 进行登录认证。

2. 查询知识库

使用脚本查询：

python3 <skill_path>/scripts/query_knowledge.py "你的问题"

或手动 curl：

ACCESS_TOKEN=$(python3 -c 'import json; print(json.load(open("'$HOME'/.yqcloud_tmp/token.json"))["access_token"])')
curl -s --location "https://api.yqcloud.com/ai/v1/228549383619211264/aigc_knowledge/chunks?top=5&question=$(python3 -c 'import urllib.parse; print(urllib.parse.quote("你的问题"))')" \
  --header "Authorization: bearer $ACCESS_TOKEN" \
  --header "x-tenant-id: 228549383619211264"

3. 解读结果

脚本会格式化输出检索到的知识片段，包含：

片段内容
来源文档
相关度评分

执行流程（给 Agent 参考）

使用 Bash 检查 ~/.yqcloud_tmp/token.json 是否存在
如果不存在，告知用户需要先登录（触发 yqcloud-login-auth skill）
使用 Bash 运行 python3 <skill_path>/scripts/query_knowledge.py "<用户问题>"
解读返回的知识片段，整理后回答用户问题
如果返回 401，说明 token 过期，提示用户重新认证