QVeris CLI 用于发现并调用第三方 API 工具,适合在需要查找外部 API、集成 Web 服务或获取实时数据时使用。首次运行需先设置 QVERIS_API_KEY(在 qveris.ai 创建),然后执行 npx @qverisai/cli init,一条命令会串联认证、发现、检视、实际调用以及用量与账单核对流程,无需安装。可用 --query "..." 更换目标能力,或用 --dry-run 在不消耗额度的情况下校验。日常命令包括:qveris discover "weather forecast API" --json --limit 10 按能力发现工具;qveris inspect 1 --json 查看工具详情;qveris call 1 --params '{"wfo": "BOU", "x": 50, "y": 30}' --json 调用;加 --dry-run 校验不消耗额度;仅在成功调用后可加 --codegen curl 生成生产代码片段(支持 curl/python/js)。建议始终使用 --json 获取结构化输出。响应默认限制 4KB(终端)或 20KB(管道/--json),可用 --max-size -1 取消限制,超限会自动截断并给出完整结果下载链接。结果按每次 discover 缓存,需立即使用数字索引;重新 discover 后索引会重置。查询应描述工具能力而非想要的数据,且始终用英文,例如用 "company earnings report API" 而非 "Nvidia earnings"。选择工具时优先 success_rate 不低于 90%、avg_execution_time_ms 低于 2000ms 且 final_score 较高者。出错时先按错误信息修正参数,再简化(去掉可选参数、使用标准值),然后换用 discover 结果中的下一个工具;失败 3 次后应报告已尝试的内容。
qveris-cli
编程与开发
更新于 10-16 04:56