把 ShenaAI 国学能力接入 Coze / Dify
通过标准 OpenAPI + API Key,将国学/易学/中医/哲学/专著检索与报告生成能力,作为自定义插件接入扣子(Coze)与 Dify 工作流。返回结果含可核验出处与 AI 标识(GB 45438-2025)。
一、准备 API Key
- 登录 开发者中心,选择 开发者版及以上 套餐
- 创建 API Key(形如
sk-shenaai-…),明文仅展示一次,请妥善保存 - 可为 Key 限定能力域(如仅
guoxue.query)与速率/配额
二、导入 OpenAPI(二者通用)
扣子 Coze
- 创建插件 → 选择「导入」
- 粘贴 OpenAPI 地址:/api/v3/integrations/coze/openapi.json
- 鉴权方式选 Service / API Key,位置 Header,参数名
X-API-Key
Dify
- 工具 → 自定义工具 → 「导入 OpenAPI Schema」
- 地址:/api/v3/integrations/dify/openapi.json
- 鉴权 API Key,Header,
X-API-Key
三、可调用能力域
guoxue.query 国学检索yijing.analyze 易经分析
zhongyi.knowledge 中医知识philosophy.reason 哲学商道
book.read 专著研读report.generate 报告生成
四、直接调用(cURL)
curl -X POST {{BASE}}/api/v3/integrations/v1/query \
-H "X-API-Key: sk-shenaai-你的密钥" \
-H "Content-Type: application/json" \
-d '{"capability":"guoxue.query","query":"上善若水 的含义"}'
五、在线自测
(结果显示在此)