QVeris动态工具调用

技能简介

QVeris提供动态工具发现与执行能力，通过自然语言描述搜索匹配的外部API或工具，获取工具元数据后直接调用执行。

业务背景

业务人员通过自然语言描述所需功能，自动发现可用的外部API工具并直接调用执行。无需预先了解各平台接口文档，一站式完成工具搜索、评估和执行，快速集成天气、金融、搜索等数据能力到业务流程中。

落地案例：运营人员制作日报时需要实时股价数据，输入"查询股票价格的API"，系统返回多个可用工具及其成功率、响应速度等指标。选择合适工具后，直接传入股票代码参数即可获取格式化行情数据，无需单独对接券商接口，10分钟内完成数据接入。

能做什么

• 按功能描述搜索可用API工具（天气、股票、搜索等）
• 查看工具成功率、平均执行时间等指标筛选工具
• 使用工具ID和搜索ID执行具体调用
• 支持JSON参数传入和格式化输出

使用说明

1. 环境准备

需设置环境变量：QVERIS_API_KEY（从 https://qveris.ai 获取）

2. 安装依赖

项目使用uv管理依赖，确保已安装uv：

pip install uv

3. 搜索工具

uv run scripts/qveris_tool.py search "weather forecast API"

4. 执行工具

uv run scripts/qveris_tool.py execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'

5. 常用选项

• --limit N：搜索结果数量限制（默认5）
• --max-size N：响应大小限制（默认20480字节）
• --json：输出原始JSON格式

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管QVERIS_API_KEY，避免泄露
• 外部API调用可能产生费用，注意用量控制
• 工具执行结果依赖第三方服务稳定性
• 股票等金融数据仅供参考，不构成投资建议

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hqman/qveris/SKILL.md
来源类型：GitHub仓库