核心用法
volc-docs 是火山引擎官方文档的综合查询技能，提供两大核心功能：
| 功能 | 用途 | 调用方式 |
|------|------|----------|
| **search 检索** | 根据用户问题智能检索相关文档，返回标题、摘要、链接及产品编码 | `python scripts/volcengine_docs.py search "查询词" [数量] [产品编码]` |
| **fetch 获取** | 根据官方文档链接获取完整结构化内容（标题+正文） | `python scripts/volcengine_docs.py fetch "文档URL"` |
典型使用流程
1. 问题类需求：先调用 search 返回5条结果，优先使用Content字段内容作答
2. 结果优化：若首次检索匹配度不足，根据返回的 ServiceCodes 执行二次过滤检索
3. 深度内容：需完整文档时，先 search 定位链接，再 fetch 获取全文
关键约束
- URL处理：必须剥离
?lang=zh等query参数，使用纯净URL请求 - 来源标注：所有回答末尾必须以
[标题](纯净URL)格式附上文档来源 - 结果展示：多结果时按相关性排序，最多展示3条，每条附链接
显著优点
- 来源权威性：直接对接火山引擎官方文档API，信息一手、实时、准确
- 覆盖全面性：涵盖火山引擎全产品矩阵——计算、存储、网络、数据库、AI、音视频、安全等，包含产品介绍、快速入门、使用指南、计费说明、API参考、SDK下载、服务条款等完整生命周期
- 双模式灵活：检索模式适合快速答疑，获取模式适合深度研读
- 智能过滤：支持按产品编码二次精筛，提升检索效率
- 结构化输出：返回内容已做结构化解析，可直接引用无需额外处理
潜在缺点与局限性
- 网络依赖：需调用火山引擎北京地域API（
docs-api.cn-beijing.volces.com），网络波动可能影响响应 - 检索深度限制：默认返回5条结果，复杂问题可能需要多次交互才能定位精准文档
- 无离线能力：必须实时联网查询，不支持本地缓存或离线浏览
- 内容时效性：依赖官方文档更新节奏，若官网未及时同步可能存在信息滞后
- 无多语言智能切换：需手动处理URL参数，未内置语言自适应逻辑
适合人群
- 火山引擎用户：正在使用或计划使用火山引擎产品的开发者、运维工程师、架构师
- 技术支持人员：需快速查询官方文档解答客户问题的售前/售后团队
- 企业采购决策者：需要了解产品计费、服务条款、SLA承诺的管理人员
- 学习与认证备考者：准备火山引擎相关认证考试的技术人员
常规风险
| 风险类型 | 说明 | 缓释措施 |
|----------|------|----------|
| API可用性风险 | 官方API服务中断或限流 | 技能已内置重试逻辑，极端情况需引导用户直接访问官网 |
| 信息过期的风险 | 文档更新后API未实时同步 | 回答中强制标注来源链接，建议用户点击链接核实最新版本 |
| 敏感信息泄露风险 | 用户可能在查询中携带业务ID、密钥等 | 技能本身不存储查询历史，但需提醒用户避免在Query中输入敏感凭证 |
| 误引用风险 | 多产品相似功能可能导致文档错配 | 优先展示高相关性结果，建议用户交叉验证ServiceCodes字段 |
安全等级说明
本技能仅执行只读查询操作，无写入、无执行、无敏感数据访问，交互全程HTTPS加密。但需注意：用户可能在查询词中无意泄露业务信息，建议在交互界面增加敏感信息输入提示。