用途:通过自然语言与火山引擎云拨测(Cloud Detect)API 交互,完成创建检测任务、获取结果、生成报告和管理检测节点等操作。所有 API 调用由 scripts/volc_detect.py 统一处理,详细参数见 references/api_docs.md。
主要能力:支持创建任务(类型映射 1=HTTP(S)、2=DNS、3=PING、5=UDP、6=TCP、8=Upload、9=Download、11=PageElement)、获取任务结果、生成统计报告、列出/停止/重启/删除/查看任务详情,以及列出节点、按类型过滤和模糊搜索节点。
必要用法:需先配置火山引擎凭证 VOLC_ACCESSKEY、VOLC_SECRETKEY,可用 test -n "$VOLC_ACCESSKEY" && test -n "$VOLC_SECRETKEY" 检查,缺失则需用户提供并写入 shell 环境与 profile;凭证齐备前不得运行 scripts/volc_detect.py。创建任务时须提供 Address,LineIdList 需从 ListNodes 获取;未指定的参数使用默认值(ProjectName=default、Type=1、NodeCount=5、IntervalSeconds=60、FinishTime=创建时间+90 秒等)。常用命令包括 python scripts/volc_detect.py create-task、get-result、list-nodes、fuzzy-search-nodes、generate-report、list-tasks、stop-task、restart-task、delete-task、get-task。节点选择可结合 --is-mainland 与关键词模糊搜索,如 --is-mainland true 配合搜索“电信”。
适用场景:对目标 URL 或服务进行多地、多运营商、多节点类型的可用性与延迟拨测,统计成功率、延迟分位与状态码分布,定位区域或运营商故障。
限制:GetTaskResult 时间范围须不超过 1 小时,PageSize 最大 500;节点命名格式为“国家-省份-城市-运营商(类型)”;任务状态 2=Running、4=Paused、6=Ended;删除任务前需与用户确认。其余价格、配额等暂未提供。