核心用法
ragtop-planner 是一套面向达人推广场景的智能方案生成 Skill，通过与 RAGTOP 知识库服务集成，将复杂的推广策划流程标准化为可外部调用的编排服务。该 Skill 采用四阶段工作流：首先从"方案"知识库提炼执行规则，其次从"案例"知识库总结成功模式，再从"价格"知识库筛选匹配达人，最终融合多源信息生成完整推广方案。
用户仅需配置 RAGTOP_API_TOKEN 环境变量即可调用，Skill 自动完成知识库发现（list_kb）、文档检索（list_doc）和语义召回（retrieval）的完整链路。支持多路召回策略（queries 数组）和文档级过滤（doc_ids），可根据预算约束自动筛选达人组合，确保输出方案的可执行性与成本可控性。
显著优点
- 零后端改造：外部服务无需修改现有架构，通过标准 API 调用即可获得完整推广策划能力
- 知识驱动决策：基于真实案例库与价格库做决策，避免纯 LLM 幻觉导致的方案失真
- 预算硬约束：内置总价合规检查，自动剔除超预算达人，保障商业可行性
- 可追溯输出：所有关键结论均关联召回来源文档，满足企业审计与复盘需求
潜在局限
- 强依赖知识库质量：案例库覆盖率、价格数据时效性直接影响方案有效性
- 阈值调参门槛：
score_threshold和top_k需根据业务场景经验调整，新手易召回不足或噪声过多 - 网络单点风险：默认内网地址
10.71.10.71若不可达将导致服务完全不可用 - 无自动重排机制：达人筛选依赖向量相似度，缺乏 CTR、CVR 等业务指标加权
适合人群
- 品牌方市场团队：需快速生成达人投放方案但缺乏专职策划人员
- MCN 机构运营：批量处理客户需求，标准化输出报价与执行方案
- 平台型产品：为商家提供嵌入式推广策划工具，增强平台粘性
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | `RAGTOP_API_TOKEN` 需妥善保管，避免硬编码提交至版本库 |
| 价格过时 | 达人报价库未实时同步时，实际执行可能产生预算偏差 |
| 合规争议 | 生成内容需人工复核广告法合规性，Skill 不做自动审核 |
| 服务中断 | 内网服务不可达时将完全不可用，建议配置健康检查与降级策略 |