ragtop-planner 技能

该技能将达人推广方案制定流程改造为外部可执行编排，外部服务无需修改后端即可调用。

配置

必须配置以下环境变量：

• - RAGTOPAPITOKEN：API Token（必填）
• RAGTOPAPIURL：API Base URL（可选，默认 http://10.71.10.71:9380）

可用工具（tool_cli）

统一前缀：${RAGTOPAPIURL}/api/v1/ragtop/tool

1) list_kb

• - 方法：POST
• 路径：/listkb
• 认证：Authorization: Bearer ${RAGTOPAPI_TOKEN}
• 返回（关键字段）：data.kbs[]、data.total

bash
curl -L -X POST ${RAGTOPAPIURL}/api/v1/ragtop/tool/list_kb \
-H Authorization: Bearer ${RAGTOPAPITOKEN} \
-H Content-Type: application/json

2) list_doc

• - 方法：POST
• 路径：/listdoc
• 必填：knowledgeid
• 返回（关键字段）：data.docs[]、data.total

bash
curl -L -X POST ${RAGTOPAPIURL}/api/v1/ragtop/tool/list_doc \
-H Authorization: Bearer ${RAGTOPAPITOKEN} \
-H Content-Type: application/json \
-d {knowledgeid:YOURKB_ID}

3) retrieval

• - 方法：POST
• 路径：/retrieval
• 必填：knowledgeid + (query 或 queries)
• 可选：docids、retrievalsetting.topk、retrievalsetting.scorethreshold
• 返回：records[]（注意该接口直接返回 records，不是 data.records）

bash
curl -L -X POST ${RAGTOPAPIURL}/api/v1/ragtop/tool/retrieval \
-H Authorization: Bearer ${RAGTOPAPITOKEN} \
-H Content-Type: application/json \
-d {
knowledgeid:YOURKB_ID,
queries:[查询A,查询B],
retrievalsetting:{topk:16,score_threshold:0.3}
}

FH 工作流（外部执行）

请按顺序执行以下四步：

1. 1. RULESSUMMARY：从名称为“方案”的知识库召回规则并总结执行清单。
2. CASESUMMARY：从名称为“案例”的知识库召回并总结成功模式。
3. KOLSELECTOR：从名称为“价格”的知识库召回候选达人并生成 HTML 筛选表。
4. PLANGENERATION：融合规则、案例、达人表和用户需求生成最终方案。

详细步骤见：

• - references/workflow.md
• references/prompts.md
• references/error_handling.md

执行规则

• - 必须先 listkb，并匹配三个知识库名称：方案、案例、价格。
• 优先使用 queries 多路召回；仅在简单请求时用单 query。
• 如用户指定文件范围，先调用 listdoc，再把 doc_ids 传给 retrieval。
• 最终回答必须做预算合规检查（总价 <= 用户预算）。
• 所有关键结论必须可追溯到召回来源（文档名或记录来源）。
• 输出中统一使用 ragtop 命名。

推荐默认参数

• - 规则召回：topk=24，scorethreshold=0.2
• 案例召回：topk=8，scorethreshold=0.2
• 价格召回：topk=100，scorethreshold=0.1

失败与降级

• - 鉴权失败：提示用户检查 Token 是否有效或是否过期。
• 知识库缺失：明确指出缺少 方案/案例/价格 中的哪个库。
• 召回为空：建议用户细化关键词、指定文档或降低阈值后重试。
• 预算冲突：要求剔除低优先级达人，直至满足预算。