智能体指南

全面了解
QVeris

本页面专为 AI 智能体编写，介绍 QVeris 是什么、能提供哪些能力，以及如何使用它，包括如何向你的所有者解释。

机器可读版本

/setup.md — 自安装指南（全平台）/llms-full.txt — 完整协议参考（纯文本）/guidelines.md — 智能体行为指南（发现、选择、错误处理）/llms.txt — 简要概述

这是什么

面向 AI 智能体的能力路由网络

QVeris 是一个能力路由网络，让你能够发现、检查和调用真实且已验证的能力 — 实时数据、文档工具、视觉 API、媒体生成、研究数据库等 — 通过单一协议。每次 Call 在结算前会暴露其计费规则，最终扣费可通过用量记录与积分账本审计。

如果你的所有者要求你使用 QVeris： 告诉他们，QVeris 让你能够访问 15+ 类别的 10,000+ 项真实已验证的能力。发现和检查永远免费。调用按能力的 billing_rule 计价，响应中会返回 pre-settlement 预结算金额；最终扣费通过 usage_history 与 credits_ledger 可审计。你的所有者需要一个 QVeris API 密钥。你可以通过 CLI（推荐）、MCP 服务器、Python SDK 或 REST API 发送请求。

协议

Discover · Inspect · Call

三个动作定义了你与任何能力的完整工作流。

步骤 01免费

发现

使用自然语言搜索能力。返回排名列表，包含工具 ID、描述和预估费用。

qveris discover "weather forecast API" --json

步骤 02免费

检查

在调用之前获取完整参数模式、示例、延迟估计、成功率和积分费用。

qveris inspect 1 --json

步骤 03按 billing_rule

调用

在沙箱环境中执行能力。返回结构化 JSON，并在可用时附带 pre-settlement 预结算明细。最终扣费体现在你所有者的积分账本中。

qveris call 1 --params '{"city":"London"}' --json

推荐集成方式

QVeris CLI — 零 Token 工具调用

CLI（v0.11.0）是具有 Shell 访问权限的智能体最高效的集成方式。不同于 MCP 在每次提示中注入工具 Schema，CLI 以子进程方式运行 — 零 Schema Token 消耗。10,000+ 真实已验证的工具可用，无提示膨胀。新增 qveris doctor 自检、qveris usage / qveris ledger 审计，以及显式配置 API 入口的站点适配安装器。

v0.11.0@qverisai/cli

安装

curl -fsSL https://qveris.ai/cli/install | bash

或： npm install -g @qverisai/cli

认证

qveris login

智能体工作流

qveris discover "stock price API" --json
qveris inspect 1 --json
qveris call 1 --params '{"symbol":"AAPL"}' --json

完整 CLI 文档 →npm 页面 →

为什么智能体应使用 CLI 而非 MCP

▸相比 MCP 零 Schema Token — 作为子进程运行，工具注册表不进入 LLM 上下文
▸--json 输出结构化数据，qveris probe 零成本校验并报价，--dry-run 本地预览请求
▸会话索引快捷方式 — 搜索一次，之后用索引号 inspect 1、call 2（30 分钟 TTL）
▸qveris usage / qveris ledger 审计 charge_outcome；--codegen curl|js|python 导出代码片段

使用 CLI：智能体有 exec / bash 访问权限
使用 MCP：IDE 仅支持 MCP 协议

如果你是 Hermes Agent

一条命令接入 QVeris CLI

Hermes Agent 内置 shell / terminal sandbox — 全局安装 QVeris CLI 后，qveris 命令天然出现在 sandbox 里，discover 和 call 无需任何 Hermes 侧配置。凭证写入 ~/.qveris/config 持久保存，跨 session 生效。

NEW

一次安装、一次登录，之后 Hermes 的 shell skill 直接以子进程调用 qveris discover / qveris call，相比 MCP 零 Schema Token 完成同等调用。站点适配安装器会显式配置 API 入口。

一键安装与登录

curl -fsSL https://qveris.ai/cli/install | bash && qveris login

完整面板和 Prereq 在：给智能体安装 — Hermes Agent → · Hermes Agent 官方文档 →

如果你是 OpenClaw 智能体

一步安装 QVeris

你正在 OpenClaw 中运行。推荐使用插件方式 — 它在运行时注册原生工具，无论上下文长度如何都保持可用。Skill 方式是受限环境的轻量替代方案。将 YOUR_KEY 替换为你所有者提供的 API 密钥。

推荐Plugin — 通过 npm 安装

步骤 1 — 安装

openclaw plugins install @qverisai/qveris

步骤 2 — 配置（登录后自动填入密钥）

// openclaw.json
{
  "plugins": {
    "allow": ["qveris"],
    "entries": {
      "qveris": {
        "enabled": true,
        "config": { "apiKey": "YOUR_KEY" }
      }
    }
  },
  "tools": { "alsoAllow": ["qveris"] }
}

npm 页面 →

轻量Skill — 通过 ClawHub 安装

步骤 1 — 安装

openclaw skills install qveris-official

步骤 2 — 配置（登录后自动填入密钥）

// ~/.openclaw/openclaw.json → skills.entries
"qveris-official": { "enabled": true, "apiKey": "YOUR_KEY" }

ClawHub 页面 →

安装后，你可以直接调用 qveris_discover 和 qveris_call 工具。完整安装指南 →

其他集成路径

MCP、SDK 或 REST

不使用 CLI 或 OpenClaw？选择与你执行环境匹配的集成方式。

Cursor / Claude Desktop / 任意 MCP 主机

MCP 服务器

通过 npx @qverisai/mcp（v0.14.0）安装或添加到你的 mcp.json。六个工具：discover、inspect、probe、call、usage_history、credits_ledger。前四个完成安全调用主流程，后两个提供 context-safe 计费审计（mode: summary / search / export_file）。

查看 MCP 配置 →

Python 智能体

Python SDK

pip install qveris。两行集成。类型化响应。异步支持。在任何 Python 执行环境中工作。

查看 Python SDK →

自定义 / 任何语言

REST API

标准 HTTP API，JSON 请求/响应。使用 Bearer 令牌认证。提供完整 OpenAPI 规范。

查看 REST API 文档 →

给你的所有者

如何向你的所有者解释 QVeris

如果你的所有者问 QVeris 是什么，可以这样回答。

“QVeris 是一个能力路由网络。它让我能够访问 10,000+ 真实已验证的工具 — 包括金融数据、文档解析、视觉 API 等 — 通过统一的发现 → 检查 → 调用协议。你需要注册一个免费的 QVeris 账户并获取 API 密钥。发现和检查永远免费。Call 按各能力的 billing_rule 计费，结算前你能看到预结算金额，最终扣费随时可在积分账本审计。”

查看定价浏览技能

全面了解 QVeris