88 lines
2.6 KiB
Markdown
88 lines
2.6 KiB
Markdown
---
|
|
name: qveris
|
|
description: "通过QVeris API搜索和执行动态工具。在需要查找和调用外部API/工具时使用。"
|
|
triggers:
|
|
- pattern: "股票|stock|股价|股市"
|
|
description: "检测股票相关查询"
|
|
- pattern: "交易|trading|买卖|成交"
|
|
description: "检测交易相关查询"
|
|
- pattern: "分析|analysis|数据|指标|技术分析|基本面"
|
|
description: "检测分析相关查询"
|
|
- pattern: "市值|涨跌|收盘|开盘|市盈率|pe|pb"
|
|
description: "检测股票指标查询"
|
|
auto_invoke: true
|
|
examples:
|
|
- "帮我查一下特斯拉的股价"
|
|
- "分析一下苹果公司的财报数据"
|
|
- "查询今日A股涨停板"
|
|
- "获取比特币实时价格"
|
|
---
|
|
|
|
# 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
|
|
```bash
|
|
uv run scripts/qveris_tool.py search "weather forecast API"
|
|
```
|
|
|
|
### Execute a tool
|
|
```bash
|
|
uv run scripts/qveris_tool.py execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'
|
|
```
|
|
|
|
## Script Usage
|
|
|
|
```
|
|
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
|
|
```
|
|
|
|
## 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 `avg_execution_time`
|
|
|
|
3. **Execute**: Call tool with `tool_id`, `search_id`, and `parameters`
|
|
|
|
## Example Session
|
|
|
|
```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"}'
|
|
```
|
|
|
|
## 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
|