介绍
# QVeris Tool Search & Execution
QVeris 提供动态工具发现与执行功能 —— 按能力搜索工具，然后使用参数执行它们。
## 设置
需要环境变量： - `QVERIS_API_KEY` - 从 https://qveris.ai 获取
## 快速开始
### 搜索工具 ```bash uv run scripts/qveris_tool.py search "weather forecast API" ```
### 执行工具 ```bash uv run scripts/qveris_tool.py execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}' ```
## 脚本使用
``` scripts/qveris_tool.py <command> [options]
Commands: search <query> Search for tools matching a capability description execute <tool_id> Execute a specific tool with parameters
Options: --limit N Max results for search (default: 5) --search-id ID Search ID from previous search (required for execute) --params JSON Tool parameters as JSON string --max-size N Max response size in bytes (default: 20480) --json Output raw JSON instead of formatted display ```
## 工作流
1. **搜索**：描述所需的能力（而非具体参数） - 好："天气预报 API" - 坏："获取伦敦的天气"
2. **选择**：根据 `success_rate` 和 `avg_execution_time` 查看工具
3. **执行**：使用 `tool_id`、`search_id` 和 `parameters` 调用工具
## 示例会话
```bash # Find weather tools uv run scripts/qveris_tool.py search "current weather data"
# Execute with returned tool_id and search_id uv run scripts/qveris_tool.py execute openweathermap_current_weather \ --search-id abc123 \ --params '{"city": "Tokyo", "units": "metric"}' ```
## 使用场景
- **天气数据**：获取当前天气、任意地点的预报 - **股票市场**：查询股价、历史数据、财报日历 - **搜索**：Web 搜索、新闻检索 - **数据 API**：货币汇率、地理定位、翻译 - **以及更多**：QVeris 聚合了数千个 API 工具