QVeris 工具搜索与执行

QVeris 提供动态工具发现与执行功能——可依据能力搜索工具，并使用参数执行它们。

设置

需要设置环境变量：

• QVERIS_API_KEY- 从以下网址获取：https://qveris.ai

快速开始

搜索工具

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

执行工具

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

脚本使用

scripts/qveris_tool.py <命令> [选项]

命令：
  search <查询>     搜索符合能力描述的工具
  execute <工具ID>  使用参数执行特定工具

选项：
  --limit N         搜索的最大结果数（默认：5）
  --search-id ID    来自先前搜索的搜索ID（执行命令必需）
  --params JSON     工具参数，以JSON字符串形式提供
  --max-size N      最大响应大小（字节）（默认：20480）
  --json            输出原始JSON而非格式化显示

工作流程

1. 搜索：描述所需的能力（而非具体参数）

   • 良好示例："weather forecast API"
   • 不良示例："get weather for London"

2. 选择：根据以下指标评估工具success_rate以及平均执行时间

3. 执行：使用工具ID、搜索ID和参数

调用工具

示例会话

# 查找天气工具 uv run scripts/qveris_tool.py search "current weather data" # 使用返回的 tool_id 和 search_id 执行 uv run scripts/qveris_tool.py execute openweathermap_current_weather \ --search-id abc123 \ --params '{"city": "Tokyo", "units": "metric"}'

• 使用案例天气数据
• ：获取任何地点的当前天气、预报股票市场
• ：查询股价、历史数据、财报日历搜索
• ：网络搜索、新闻检索数据API
• ：货币兑换、地理位置、翻译以及更多