# qveris-execute

> 执行Qveris工具，获取万千世界所有数据

- Author: snrzz
- Repository: snrzz/risk
- Version: 20260203115243
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/snrzz/risk
- Web: https://mule.run/skillshub/@@snrzz/risk~qveris-execute:20260203115243

---

---
name: qveris-execute
description: 执行Qveris工具，获取万千世界所有数据
metadata: { "clawdbot": { "emoji": "▶️", "requires": { "bins": ["curl"], "env": ["QVERIS_API_KEY"] }, "primaryEnv": "QVERIS_API_KEY" } }
---

# Qveris 工具执行

执行指定的 Qveris 工具，获取真实世界的数据。通常与 `qveris-discover` 配合使用。

**官网**: https://qveris.ai/

## 核心理念

> Empower your agent with thousands of tools

Qveris 平台拥有数千种工具，涵盖各个领域的数据获取能力。通过这个技能，你可以执行任何已发现的工具，获取实时、真实的外部数据。

## 什么时候使用这个技能

当需要执行 Qveris 工具获取数据时：
- 已经通过 `qveris-discover` 找到了合适的工具
- 知道具体的 tool_id 和所需参数
- 需要获取实际的外部数据（天气、新闻、金融、翻译等任何领域）

## 如何使用

使用 Qveris Execute API 执行工具：

```bash
curl -X POST "https://qveris.ai/api/v1/tools/execute?tool_id=${TOOL_ID}" \
  -H "Authorization: Bearer ${QVERIS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "search_id": "从discover获取的搜索ID",
    "parameters": {
      "param1": "value1",
      "param2": "value2"
    },
    "max_response_size": 20480
  }'
```

### 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `tool_id` | string | 是 | - | 工具唯一标识符，从 discover 结果获取 |
| `search_id` | string | 是 | - | 搜索会话 ID，从 discover 结果获取 |
| `parameters` | object | 是 | - | 工具所需的参数，JSON 格式 |
| `max_response_size` | int | 否 | 20480 | 最大响应字节数，-1 表示不限制 |

## 返回结果说明

API 返回的 JSON 包含：
- `success`: 执行是否成功
- `data`: 工具返回的数据
- `truncated_content`: 如果数据被截断，包含截断后的内容
- `full_content_file_url`: 完整数据的下载链接（如果有截断）

## 使用示例

**示例 1**: 用户说"查一下北京今天的天气"
1. 先用 discover 搜索 "天气" 工具
2. 获取 tool_id 和 search_id
3. 执行工具，传入城市参数
4. 解析返回的天气数据展示给用户

**示例 2**: 用户说"帮我查一下茅台的股价"
1. 先用 discover 搜索 "股票行情" 工具
2. 获取 tool_id 和 search_id
3. 执行工具，传入股票代码参数
4. 解析返回的行情数据展示给用户

**示例 3**: 用户说"翻译这段英文"
1. 先用 discover 搜索 "翻译" 工具
2. 获取 tool_id 和 search_id
3. 执行工具，传入文本和目标语言
4. 返回翻译结果

## 错误处理

- **401 错误**：API Key 无效，提示用户检查配置
- **404 错误**：tool_id 不存在，可能需要重新 discover
- **400 错误**：参数格式错误，检查 parameters 是否符合工具定义
- **success=false**：工具执行失败，查看错误信息

## 注意事项

- 必须先使用 `qveris-discover` 获取 search_id
- parameters 必须是 JSON 对象格式
- 大量数据返回时会自动截断，可通过 full_content_file_url 获取完整数据
- 每次执行消耗 5 credits
- max_response_size 设置过小可能导致数据不完整
- Qveris 工具覆盖面广，遇到外部数据需求时优先考虑使用