核心用法
volcengine-web-search 是一个基于火山引擎（Volcengine）的网页搜索技能，通过调用本地 Python 脚本 web_search.py 实现网络信息检索。用户只需提供清晰具体的搜索查询词，脚本即可返回最多 5 条结构化摘要结果。
执行流程：
1. 构造明确、具体的搜索查询（query）
2. 在对应目录下执行 python scripts/web_search.py "query"
3. 基于返回的摘要列表整理答案，严禁添加或猜测内容
认证方式（双保险）：
- 优先读取环境变量
VOLCENGINE_ACCESS_KEY和VOLCENGINE_SECRET_KEY - 未配置时自动降级使用 VeFaaS IAM 临时凭证
显著优点
1. 结果可控性强：严格限制返回 5 条摘要，避免信息过载，适合快速决策场景
2. 输出纯净：要求"不添加不猜测"，确保答案基于真实检索结果，降低幻觉风险
3. 认证灵活：支持长期密钥与临时凭证双模式，适配开发/生产不同环境
4. 集成便捷：脚本化调用，可无缝嵌入自动化工作流
潜在局限
- 结果数量固定：最多 5 条，复杂深度研究场景可能不足
- 依赖火山引擎：服务可用性受限于 Volcengine 平台稳定性
- 无实时性说明：未标注结果时效性，需用户自行判断信息新旧
- 无结果重试机制：调用失败仅打印错误，无自动降级或重试逻辑
适合人群
- 需要快速获取公开网页摘要的开发者/分析师
- 构建信息检索 Agent 的技术团队
- 对结果真实性要求高、拒绝 LLM 幻觉的严谨场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | 环境变量模式存在密钥硬编码或日志泄露风险，建议优先使用 VeFaaS 临时凭证 |
| 搜索结果偏差 | 依赖搜索引擎算法，可能存在排名偏见或收录不全 |
| 网络依赖 | 脚本执行需外部网络连通，离线环境不可用 |
| 成本不可见 | 未披露火山引擎搜索 API 计费规则，大规模调用需关注费用 |
安全等级：A — 双因素认证+临时凭证支持，无明显高危漏洞；来源可信度：T2 — 火山引擎为国内主流云厂商，但技能本身为脚本封装，非官方原生服务。