用途:面向火山引擎产品咨询与文档查询需求,提供官方文档检索和全文获取能力,资料覆盖全产品使用链路。
主要能力:一是文档检索(search),按用户问题检索官方文档,可指定返回数量(默认5篇)和产品编码过滤;核心结果位于 Result.DocList,含 Title、Url、Content、ServiceCodes。二是内容获取(fetch),依据官方文档链接抓取结构化解析后的完整标题和正文。
使用方式:检索命令为 python {skill_dir}/scripts/volcengine_docs.py search "查询关键词" [返回数量] [产品编码1,产品编码2...],例如 search "tos是什么" 1 tos;获取全文命令为 python {skill_dir}/scripts/volcengine_docs.py fetch "火山引擎文档链接"。搜索接口地址为 https://docs-api.cn-beijing.volces.com/api/v1/doc/search,获取接口为 https://docs-api.cn-beijing.volces.com/api/v1/doc/fetch。用户直接给出文档链接时,直接调用 fetch,无需先检索;需要完整内容时先 search 找到链接再 fetch;首次检索匹配度不高,可依据返回的 ServiceCodes 携带产品编码二次检索。
处理规则:fetch 的 Url 若含 query 参数需去掉,仅保留形如 https://www.volcengine.com/docs/6396/624853 的纯净地址;回答应优先使用返回的 Content,最多展示3条最相关结果,并附官方文档链接,链接需使用剥离 query 参数的 CleanUrl。
限制:具体鉴权方式、调用配额、计费与错误处理等资料暂未提供。