QVeris Tool Search & Execution
QVeris provides dynamic tool discovery and execution - search for tools by capability, then execute them with parameters.
Setup
Requires environment variable:
- -
QVERIS_API_KEY - Get from https://qveris.ai
Quick Start
Search for tools
CODEBLOCK0
Execute a tool
CODEBLOCK1
Script Usage
CODEBLOCK2
Workflow
- 1. Search: Describe the capability needed (not specific parameters)
- Good: "weather forecast API"
- Bad: "get weather for London"
- 2. Select: Review tools by
success_rate and INLINECODE2
- 3. Execute: Call tool with
tool_id, search_id, and INLINECODE5
Example Session
CODEBLOCK3
Use Cases
- - Weather Data: Get current weather, forecasts for any location
- Stock Market: Query stock prices, historical data, earnings calendars
- Search: Web search, news retrieval
- Data APIs: Currency exchange, geolocation, translations
- And more: QVeris aggregates thousands of API tools
QVeris 工具搜索与执行
QVeris 提供动态工具发现与执行功能——按能力搜索工具，然后使用参数执行它们。
环境配置
需要设置环境变量：
- - QVERISAPIKEY - 从 https://qveris.ai 获取
快速开始
搜索工具
bash
uv run scripts/qveris_tool.py search 天气预报API
执行工具
bash
uv run scripts/qveris
tool.py execute openweathermapcurrent_weather --search-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. 搜索：描述所需的能力（而非具体参数）
- 正确示例：天气预报API
- 错误示例：获取伦敦天气
- 2. 选择：根据 successrate（成功率）和 avgexecution_time（平均执行时间）评估工具
- 3. 执行：使用 toolid（工具ID）、searchid（搜索ID）和 parameters（参数）调用工具
示例会话
bash
查找天气工具
uv run scripts/qveris_tool.py search 当前天气数据
使用返回的toolid和searchid执行
uv run scripts/qveristool.py execute openweathermapcurrent_weather \
--search-id abc123 \
--params {city: Tokyo, units: metric}
应用场景
- - 天气数据：获取任意地点的当前天气、预报信息
- 股票市场：查询股价、历史数据、财报日历
- 搜索功能：网页搜索、新闻检索
- 数据API：货币汇率、地理位置、翻译服务
- 更多功能：QVeris 聚合了数千个API工具
