Agent Intent Protocol (AIP)
AIP 是一个开放协议,让 AI Agent 通过声明 需要什么 来发现、支付和使用服务——无需关心底层路由。一次 API 调用搞定提供商选择、执行和链上支付结算。
工作原理
Agent 发送意图 (例如 "chat_completion", 预算 $0.05)
→ AIP 根据约束(价格/质量/速度)匹配最优提供商
→ 执行请求
→ 链上结算 (USDC via x402)
→ 返回结果 + 结算凭证| 阶段 | 说明 |
|---|---|
| Resolve | 根据约束条件(价格、延迟、特性)匹配可用提供商 |
| Execute | 将请求路由到选定提供商并执行 |
| Settle | 通过 x402 扣除精确费用(USDC on Base 或 Solana),返回可验证的链上凭证 |
设计原则
| 原则 | 说明 |
|---|---|
| 意图优先 | Agent 声明期望结果,而非指定具体 endpoint |
| 支付原生 | 每次调用都有支付通道,无免费层歧义 |
| 提供商无关 | 提供商注册能力,协议处理路由 |
| 风险感知 | 内置风险评分,防止预算超支和滥用 |
| MCP 兼容 | AIP endpoint 同时作为 MCP Tool 暴露,便于发现 |
认证
两种方式,选其一:
| 方式 | Header | 适用场景 |
|---|---|---|
| API Key | Authorization: Bearer <key> | 托管计费——平台从你的托管钱包结算 |
| Private Key (x402) | PAYMENT-SIGNATURE(或 X-PAYMENT) | 自主 Agent——Agent 直接用自己的钱包签名支付 |
x402 模式: SDK 自动处理 402 Payment Required → 签名 → 重试 流程。你的代码写法不变,只是初始化不同。每次请求都在链上结算。
PAYMENT-SIGNATURE 与 X-PAYMENT 都被接受、承载相同的 base64 载荷;同时传入时以 PAYMENT-SIGNATURE 为准。
支持的链:Base(EVM 0x... 私钥)和 Solana(Base58 私钥)。Solana 仅在网关已解析出 fee payer 时才会出现在 402 选项里,否则只列 Base。Go SDK 目前仅支持 EVM,Solana 请用 Python SDK。
只读 GET 免费,POST 形式不免费
GET /v1/intent/resolve、/types、/discover 和 GET /v1/providers 是公开的。POST 形式的 解析和所有执行路径都需要认证 —— 它们会消耗 embedding 与上游资源。
支持的意图类型
本地定义 13 种意图类型:
| 意图类型 | 说明 | 典型价格 |
|---|---|---|
chat_completion | 文本生成 / 对话 | $0.0001–0.05/次 |
image_generation | AI 图片生成 | $0.015–0.11/次 |
video_generation | AI 视频生成 | 按秒计费,见视频生成 |
text_to_speech | 语音合成 | $0.05–0.12/千字符 |
web_search | 网页搜索 | $0.0095/次 |
knowledge_search | 语义检索 | $0.004–0.012/次 |
prompt_optimization | AI 驱动的 prompt 重写 | $0.002/次(固定) |
code_generation | 代码编写 / 补全 | $0.001–0.05/次 |
translation | 文本翻译 | $0.0001–0.01/次 |
document_processing | 文档解析 / 抽取 | 不定 |
data_analysis | 结构化数据分析 | 不定 |
code_execution | 沙箱代码执行 | $0.001–0.012/次 |
utility | 其他工具类服务 | 不定 |
网络节点会在此之上贡献更多意图类型(blockchain、geo、dns、email、storage、web、 audio_generation、general 等,随节点加入而变化)。
speech_to_text、tool_call 与 x-{vendor}/{type} 都不存在
前两者不在服务端意图常量表内;语音识别请直接调 /v1/audio/transcriptions,MCP 工具请走 POST /mcp 的 tools/call。自定义供应商前缀格式在服务端也没有实现。
请以 GET /v1/intent/types 返回的实时列表为准 —— 它是本地常量与提供商注册表的并集,会随节点 上下线变化,不要硬编码上表。
API Endpoints
POST /v1/intent/resolve
查找最佳提供商,不执行。
请求:
{
"intent": "chat_completion",
"constraints": {
"max_price_usd": 0.05,
"max_latency_ms": 3000,
"features": ["function_calling", "json_mode"]
},
"preferences": {
"optimize_for": "quality",
"limit": 10
}
}| 字段 | 类型 | 说明 |
|---|---|---|
intent | string | 必填。意图类型标识 |
query | string | 可选。用于语义相关性打分的自由文本 |
constraints.max_price_usd | number | 传入时必须为正数 |
constraints.max_latency_ms | integer | 传入时必须为正数 |
constraints.features | string[] | 要求提供商具备的能力 |
preferences.optimize_for | string | cost | quality | latency | budget |
preferences.limit | integer | 返回候选数上限(默认 10) |
响应:
{
"matches": [
{
"provider_id": "deepseek/deepseek-chat",
"score": 0.95,
"estimated_price_usd": 0.0003,
"pricing": { "input_per_million": 0.1, "output_per_million": 0.2 },
"endpoint": "/v1/chat/completions",
"model": "deepseek/deepseek-chat",
"reason": "lowest cost: $0.000300/req"
}
],
"intent_type": "chat_completion",
"total_available": 45
}| 字段 | 说明 |
|---|---|
matches[].provider_id | 提供商标识(模型 ID、marketplace/x 或 federation/<id>/<name>) |
matches[].score | 综合排序分,0–1 |
matches[].estimated_price_usd | 单次预估成本。token 计费时按 500 输入 / 500 输出估算 |
matches[].pricing | 原始报价:input_per_million、output_per_million 或 per_call |
matches[].endpoint | 该提供商对应的调用路径 |
matches[].model | 上游模型名(若适用) |
matches[].reason | 排序原因的可读说明 |
total_available | 约束过滤前匹配该意图的提供商总数 |
解析不是预留
响应中没有 resolution_id,也没有 expires_at —— 什么都不会为你锁定。解析只是一次排序查询, 价格可能在解析与执行之间变动。同时也不支持 preferred_providers、excluded_providers 和 context 字段:请用 features 和 max_price_usd 过滤,或自行从 matches 中挑选。
注意方法差异: GET /v1/intent/resolve 免费且无需认证,但只返回用法说明。真正的排序解析是 POST,需要认证并消耗 embedding 资源。
POST /v1/intent/execute
核心 endpoint。解析最佳提供商、执行请求、结算支付、返回结果——一次调用完成。
请求:
{
"intent": "chat_completion",
"constraints": { "max_price_usd": 0.05 },
"preferences": { "optimize_for": "quality" },
"payload": {
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "用3句话解释量子计算。"}
],
"temperature": 0.7,
"max_tokens": 200
}
}| 字段 | 类型 | 说明 |
|---|---|---|
intent | string | 意图类型。与 resource_id 二选一 |
resource_id | integer | 网络资源 ID —— 直接指定提供商并跳过解析 |
payload | object | 转发给提供商的请求体。GET 类 marketplace 端点可省略 |
constraints / preferences | object | 与 /resolve 同构 |
endpoint | string | 多端点服务内的子路径,含查询串 |
method | string | 转发使用的 HTTP 方法,默认 POST |
headers | object | 需转发到上游的额外请求头 |
路由分三级:resource_id 优先,其次 intent,两者都缺则返回 400。支付由 x402 中间件在本处理器 之前完成结算,因此请求体里没有 payment 对象 —— 金额来自 402 报价。
响应(本地 / marketplace / builtin 提供商):
上游响应原样透传。chat_completion 即标准 OpenAI 格式补全:
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1717200000,
"model": "deepseek/deepseek-chat",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "量子计算利用量子比特的叠加..." }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": 24, "completion_tokens": 156, "total_tokens": 180 },
"price": { "amount": "0.003200", "currency": "USD" }
}响应(网络提供商):
网络执行有一层包装,因为网关需要回报自己的结算信息:
{
"success": true,
"data": { "...": "提供商响应体" },
"tx_hash": "0xabc123...",
"cost_usd": 0.0032,
"upstream_cost": 0.0029,
"latency_ms": 812,
"settlement": {
"tx_hash": "0xabc123...",
"amount": "0.003200",
"currency": "USDC",
"chain": "base",
"provider_used": "federation/532/Image Generate",
"timestamp": "2026-07-08T10:30:00Z",
"facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
"attestation": {
"intent_hash": "0x...",
"result_hash": "0x...",
"signer": "0x...",
"signature": "0x..."
}
}
}两种不同的响应形态
没有 execution_id,也没有顶层 provider_used,更没有统一的 result 包装层。拿到透传响应还是 网络信封,取决于解析器选中了哪种来源 —— 用 success/data 是否存在来区分。只有真正发生链上结算时 才会带 settlement 对象。
网络提供商失败时,网关会回退到服务同一意图的本地提供商;无可用回退时返回 502, 响应体为 {error, detail, provider}。
POST /v1/intent/execute-budget
同 Execute,但走完整的编排流水线并施加硬预算上限:校验预算 → 风险评分 → 选择支付路径 → 预扣 → 执行 → 确认或回滚。若费用会超出上限,请求在执行前被 拒绝。
请求:
{
"intent": "chat_completion",
"budget": {
"max_total_usd": 0.50,
"preferred_payment_method": "auto",
"allow_overdraft": false
},
"payload": {
"messages": [{"role": "user", "content": "总结这份文档……"}]
}
}| 字段 | 类型 | 说明 |
|---|---|---|
budget.max_total_usd | number | 必填。 本次请求的硬上限 |
budget.preferred_payment_method | string | balance | credit | crypto | auto(默认 auto) |
budget.allow_overdraft | boolean | 余额不足时是否允许走信用额度继续 |
这里没有单次和每日限额字段
per_call_limit_usd 与 daily_limit_usd 不属于此请求。持久化限额在钱包上,请用 PUT /v1/wallet/limits 设置(per_request_max_usd、daily_max_usd、monthly_max_usd、 auto_pause_below_usd)。详见钱包与资金库。
响应:
{
"request_id": "b6f2c1de-...",
"status": "success",
"provider": "deepseek/deepseek-chat",
"model": "deepseek/deepseek-chat",
"result": { "...": "提供商响应" },
"actual_cost_usd": 0.0032,
"risk_level": "low",
"duration_ms": 812,
"settlement": {
"id": "stl_b6f2c1de-..._9a1f...",
"request_id": "b6f2c1de-...",
"user_id": 42,
"payer_address": "0x...",
"decision": { "method": "crypto_x402", "quota_to_deduct": 1600, "reason": "..." },
"actual_cost_usd": 0.0032,
"status": "confirmed",
"created_at": "2026-07-08T10:30:00Z",
"confirmed_at": "2026-07-08T10:30:01Z"
}
}status 取值 success、rejected、error、risk_blocked。HTTP 状态码同步:rejected 与 risk_blocked 返回 403,error 返回 500。注意此端点的 settlement 是内部记账用的 SettlementRecord,与 /execute 网络调用返回的带签名凭证结构不同。
POST /v1/intent/resolve/natural
自然语言解析。用自然语言描述需求,AIP 通过 embedding 相似度(并以关键词兜底)识别意图并排序提供商。
只解析,不执行、不扣费
该端点只返回候选。它不会运行请求,也不会结算支付。请从 matches 里挑选提供商,再自行调用 /v1/intent/execute(或该提供商的 endpoint)。
请求:
{
"query": "我想生成一张赛博朋克城市的图片",
"session_id": "可选,用于多轮澄清",
"constraints": { "max_price_usd": 0.10 },
"preferences": { "optimize_for": "cost" }
}query 必填。constraints.max_price_usd 与 max_latency_ms 传入时必须为正数。没有 budget 字段。
响应(已解析):
{
"status": "resolved",
"intent": "image_generation",
"confidence": 0.96,
"matches": [
{
"provider_name": "federation/532/Image Generate",
"model": "",
"intent": "image_generation",
"score": 0.70,
"price_usd": 0.0115,
"latency_ms": 0,
"endpoint": "/image-generate"
}
]
}响应(需要澄清):
{
"status": "clarify",
"session_id": "s_8f3a...",
"clarify": {
"question": "你想要静态图片还是一段视频?",
"options": ["image_generation", "video_generation"],
"round": 1
},
"message": "多个意图的置信度接近。"
}status 取值为 resolved、clarify、budget_insufficient、no_match。需要澄清时,把返回的 session_id 一并带上继续追问。options 是意图标识的扁平数组,不是对象数组。
GET /v1/intent/audit
查看 AIP 编排的近期生命周期日志。
不接受任何查询参数,返回内存环形缓冲区(容量 10000 条,异步持久化)中最新的记录。
响应:
{
"entries": [
{
"timestamp": "2026-07-08T10:30:01.482Z",
"request_id": "b6f2c1de-...",
"user_id": 42,
"event_type": "settlement_confirmed",
"details": { "amount_usd": 0.0032, "tx_hash": "0xabc123..." }
}
],
"count": 142
}event_type 是流水线生命周期事件,不是意图名称:
| 事件 | 含义 |
|---|---|
intent_resolved | 已选定提供商 |
budget_validated | 预算校验通过 |
risk_flagged | 风险评分器发出告警 |
payment_routed | 已选定支付路径 |
pre_deducted | 已预扣资金 |
execution_started / execution_complete / execution_failed | 上游调用生命周期 |
settlement_confirmed / settlement_rolled_back | 最终支付结果 |
不是可分页的账本
没有 total、page、page_size,也不能按日期或意图类型过滤。要查消费历史和分模型明细,请用 下方的分析端点,或 GET /v1/wallet/history。
GET /v1/intent/types
列出所有可解析的意图类型 —— 本地常量与提供商注册表已索引意图的并集,已排序。无需认证。
{ "intent_types": ["audio_generation", "blockchain", "chat_completion", "code_execution", "..."] }GET /v1/providers
列出所有已注册提供商及其元数据和报价。无需认证。
{ "providers": [ { "id": "...", "name": "...", "intent_types": ["..."], "pricing": {}, "source": "federation" } ], "total": 3412 }路径与响应体积
路径是 /v1/providers,不是 /v1/intent/providers。响应很大(按当前网络规模约 1.6 MB)。 只想展示一个总数时,请改用 GET /v1/network/stats。
GET /v1/network/stats
只返回聚合计数 —— 可解析网络的规模。公开、无需认证、可放心轮询。
{
"success": true,
"data": {
"total_providers": 3412,
"by_source": { "federation": 3350, "marketplace": 15, "local": 47 },
"intent_types": 21,
"federation": { "servers": 128, "healthy_servers": 121, "resources": 3350 }
}
}分析
消费与效率报表。数据范围由服务端依据鉴权上下文强制约束,不接受客户端指定: 使用 API 令牌(sk-...)调用时只能看到自己的数据,此路径下 user_id 会被忽略, 即使该令牌属于管理员也一样;只有在控制台登录(会话鉴权)的管理员才能用 user_id 放宽范围(user_id=0 表示全局)。
| 端点 | 说明 |
|---|---|
GET /api/analytics/aggregate | 聚合后的消费与结算数据 |
GET /api/analytics/quality | 分模型的缓存命中率、错误率与延迟 |
GET /api/analytics/insights | 对消费与市场日志的深度扫描汇总 |
公共查询参数:period(24h、7d 默认、30d、90d)、group_by(可取 day、 model、api_source、principal_type、channel、group、client_id,默认 day,model,api_source)、model、user_id,以及 filter_api_source / filter_principal_type / filter_client_id / filter_channel / filter_group。
AIP 用量出现在同一批数据中,以 api_source="aip" 标识。旧的 /v1/aip/analytics/* 端点已被移除。
订阅(SSE)
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/intent/subscribe | POST | 执行意图并通过 Server-Sent Events 流式返回 |
/v1/intent/subscribe | GET | 列出你的活跃订阅 |
/v1/intent/subscribe/:id | DELETE | 取消订阅 |
事件以 event: / data: 成对到达。两个 SDK 都做了封装 —— 见 SDK 参考。
优化策略
optimize_for 参数控制提供商选择:
| 值 | 行为 |
|---|---|
cost | 满足约束的最便宜提供商 (默认) |
quality | 最高评分提供商(可能更贵) |
latency | 最低延迟提供商 |
budget | 重点权衡支付开销 —— 适合极紧的单次预算 |
未知取值会静默退化为 cost
speed 和 balance 都不是合法值。无法识别的取值会被静默当作 cost 处理 —— 拼错不会报错, 但你要的行为不会生效。请用 latency 而不是 speed。
当请求带 query 且 embedding 后端可用时,语义相关性占最终分数的 55%, 价格/质量/延迟/可靠性的混合分占其余部分。不带 query 时只用混合分。
结算
发生链上结算的执行会返回 settlement 对象:
| 字段 | 说明 |
|---|---|
tx_hash | 链上交易哈希(可在任何区块浏览器验证) |
amount | USDC 精确结算金额 |
currency | 始终为 USDC |
chain | base |
provider_used | 实际服务本次请求的提供商 |
facilitator | 处理支付的 x402 facilitator |
timestamp | RFC 3339 UTC 时间戳 |
attestation | 签名凭证 —— 配置了签名密钥时出现 |
所有结算完全链上、非托管。你可以在对应链的区块浏览器验证任何交易。
可离线验证的签名凭证
启用签名后,凭证会带上一份 EIP-712 签名,无需信任网关即可自行校验:
{
"attestation": {
"intent_hash": "0x...",
"result_hash": "0x...",
"signer": "0x...",
"signature": "0x...",
"canonical": { "scheme": "eip712", "domain": { "name": "JarvisClaw-AIP", "version": "1", "chainId": 8453 } }
}
}验证方式:对规范化后的请求 payload 与响应原始字节分别做 keccak256 得到 intent_hash 和 result_hash,在 SettlementReceipt(intent_hash, result_hash, provider_used, amount, currency, tx_hash, timestamp) 上恢复 EIP-712 签名者,确认它与 /.well-known/agent-intent-protocol.json 的 attestation.signer 一致,然后到链上核对 tx_hash。
错误处理
AIP 端点返回扁平的 {"error": "<消息>"} 结构。这一层没有稳定的机器可读 code 字段 —— 请按 HTTP 状态码分支,必要时再匹配消息文本。
| HTTP 状态 | 场景 | 消息示例 |
|---|---|---|
| 400 | 请求体格式错误或约束非法 | max_price_usd must be a positive value |
| 400 | resource_id 与 intent 均未提供 | either resource_id or intent is required |
| 401 | 预算/网络调用缺少认证上下文 | authentication required |
| 402 | 需要 x402 支付(SDK 自动处理) | 402 报价体,见 x402 |
| 402 | 网络结算失败 | ... settle ... |
| 403 | 预算被拒或被风险拦截(/execute-budget) | status: "rejected" / "risk_blocked" |
| 404 | 没有提供商匹配该意图 | no matching provider for intent |
| 404 | resource_id 不在注册表中 | resource 532 not found in registry |
| 429 | 触发限流 | recommend rate limit exceeded (20 req/min), try again later |
| 500 | 解析器或编排器失败 | status: "error" |
| 502 | 上游执行失败且无回退 | execution failed / federation execution failed, no local fallback available |
| 503 | 节点被禁用或不健康 | ... unhealthy ... |
/execute-budget 同时用响应体的 status 字段表达结果(success、rejected、error、 risk_blocked),两处都要检查。
平台服务
除了标准意图(chat_completion、web_search 等),AIP 也能直接调用平台上架的服务——例如 surf 行情数据服务。这些服务都通过同一个 /v1/intent/execute 端点调用。
一个平台服务通常包含多个功能端点(行情查询、交易对信息等)。调用时用 intent 指定服务类别,用 endpoint 指定服务内的具体功能路径:
curl -X POST https://api.jarvisclaw.ai/v1/intent/execute \
-H "Authorization: Bearer $JC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"intent": "web_search",
"endpoint": "exchange/price?pair=BTC-USDT",
"method": "GET"
}'响应(HTTP 200):
{
"success": true,
"data": { "pair": "BTC-USDT", "price": "64251.94" }
}| 字段 | 说明 |
|---|---|
intent | 服务对应的意图类别 |
endpoint | 服务内的功能路径(含查询参数) |
method | HTTP 方法,默认 POST —— 数据查询类需显式传 GET |
意图与服务基础路径的映射:
| 意图 | 基础路径 |
|---|---|
web_search | /v1/marketplace/surf |
knowledge_search | /v1/marketplace/exa |
image_generation | /v1/images/generations |
video_generation | /v1/videos/generations |
text_to_speech | /v1/audio/speech |
prompt_optimization | /v1/prompt-coach/optimize |
| 其他 | /v1/chat/completions |
若提供商在注册时带了自己的显式 endpoint,则以该 endpoint 为准,不走上表。
计费说明
与所有 AIP 调用一致,平台服务按次通过 x402 在链上结算(USDC),费用在执行时精确扣除。
网络(Network)
AIP 支持资源网络——多个平台通过对等发现共享资源。任何提供 .well-known/agent-intent-protocol.json 的平台都可以加入网络。
工作方式
- 平台通过域名注册为对等节点
- 同步爬虫按固定周期访问各节点的
.well-knownendpoint(默认 30 分钟) - 所有节点的资源聚合到统一目录
- Agent 通过相同 API 发现和执行网络资源
网络端点
| Endpoint | 方法 | 认证 | 说明 |
|---|---|---|---|
/v1/network/search | GET | 无 | 全文搜索网络资源 |
/v1/network/apis | GET | 无 | 浏览所有网络资源 |
/v1/network/servers | GET | 无 | 列出网络对等节点 |
/v1/network/health | GET | 无 | 所有节点的健康状态 |
/v1/network/recommend | POST | 无(deep 档需 x402) | 资源推荐 |
/v1/network/execute | POST | 需要 | 执行网络资源 |
搜索(关键词):
curl "https://api.jarvisclaw.ai/v1/network/search?q=stock&category=finance&limit=5"推荐(自然语言发现):
POST /v1/network/recommend
{
"query": "I need to analyze stock market data",
"category": "finance",
"max_results": 5,
"min_score": 0.5,
"healthy_only": true
}query 为必填 —— 字段不叫 intent,结果上限字段是 max_results 而非 limit。响应:
{
"query": "I need to analyze stock market data",
"results": [ { "resource": { "...": "..." }, "server_name": "...", "server_url": "...", "score": 0.82 } ],
"count": 5,
"cached": false,
"tier": "standard"
}两种推荐档位
默认 standard 档免费、按关键词打分,限流 20 次/分钟。传 X-Recommend-Tier: deep (或 ?tier=deep)启用 LLM 增强语义排序,每次 $0.01 通过 x402 支付 —— 未带支付头时该档返回 402。相同查询会命中缓存。
执行网络资源:
POST /v1/network/execute
{
"resource_id": 532,
"payload": {"ticker": "AAPL"}
}resource_id 是 /v1/network/apis 返回的数字 ID,不是 "stock-analysis" 这样的 slug。 也可以改传 intent 让解析器挑选资源。请求体与 /v1/intent/execute 同构,因此 endpoint、 method、headers 在此同样可用。
成为网络节点
- 提供
GET /.well-known/agent-intent-protocol.json返回你的元数据 - 实现接受 x402 支付的资源执行 endpoint
- 联系我们注册你的域名
最小 .well-known schema:
{
"aip_version": "1.0",
"platform_name": "Your Platform",
"base_url": "https://your-platform.example.com",
"capabilities": ["resolve", "execute", "federation"],
"resources": [
{
"id": "your-resource-id",
"name": "Your Resource Name",
"category": "category",
"description": "这个资源做什么",
"price_per_call": "0.005",
"currency": "USDC"
}
],
"payment": {
"x402": {
"facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
"networks": ["base"],
"supported": true
}
},
"contact": "https://t.me/JarvisClawai"
}facilitator 应指向真正为你结算的 x402 facilitator —— 基于 CDP 的部署即 https://api.cdp.coinbase.com/platform/v2/x402。节点会被持续健康检查;不健康节点的资源会暂停 对外提供,直至恢复。
MCP 兼容
AIP 的部分能力以 MCP Tool 形式暴露。工具名是扁平的 aip_ 前缀标识:
| MCP Tool | 对应 |
|---|---|
aip_resolve | POST /v1/intent/resolve |
aip_execute_with_budget | POST /v1/intent/execute-budget |
aip_list_intents | GET /v1/intent/types |
aip_estimate_cost | 本地成本估算,无对应 HTTP 端点 |
此外还有网关通用工具 list_models、chat、search_apis、get_api_detail、 discover_agents,以及每个已发布用户 API 对应的一个 uapi_{slug}。详见 MCP 配置。
并非所有端点都有 MCP 工具
/v1/intent/execute、/v1/intent/resolve/natural 和 /v1/intent/audit 没有对应的 MCP 工具 —— 请直接走 HTTP。
Endpoint 总览
| Endpoint | 方法 | 认证 | 说明 |
|---|---|---|---|
/v1/intent/resolve | GET | 无 | POST 形式的用法说明 |
/v1/intent/resolve | POST | 需要 | 按意图排序提供商 |
/v1/intent/resolve/natural | POST | 需要 | 自然语言解析(不执行) |
/v1/intent/discover | GET | 无 | 发现意图与提供商 |
/v1/intent/discover | POST | 需要 | 基于 embedding 的语义发现 |
/v1/intent/execute | POST | 需要 | 解析 + 执行 + 结算 |
/v1/intent/execute-budget | POST | 需要 | 带预算上限的编排执行 |
/v1/intent/subscribe | POST | 需要 | 执行并通过 SSE 流式返回 |
/v1/intent/subscribe | GET | 需要 | 列出活跃订阅 |
/v1/intent/subscribe/:id | DELETE | 需要 | 取消订阅 |
/v1/intent/audit | GET | 需要 | 近期编排生命周期日志 |
/v1/intent/types | GET | 无 | 列出意图类型 |
/v1/providers | GET | 无 | 列出提供商及报价 |
/v1/network/stats | GET | 无 | 网络规模聚合计数 |
/api/analytics/* | GET | 需要 | 消费聚合、质量指标、深度洞察 |
/v1/network/search | GET | 无 | 关键词搜索网络资源 |
/v1/network/apis | GET | 无 | 浏览网络资源 |
/v1/network/servers | GET | 无 | 列出网络节点 |
/v1/network/health | GET | 无 | 节点健康状态 |
/v1/network/recommend | POST | 无(deep 档需 x402) | 资源推荐 |
/v1/network/execute | POST | 需要 | 执行网络资源 |
/v1/aip/federation/peers | GET/POST/DELETE | 管理员 | 管理网络节点 |
/v1/aip/federation/crawl | POST | 管理员 | 手动触发节点同步 |
/v1/wallet/* | GET/PUT | 需要 | 余额、流水、限额、资金池 |
/.well-known/agent-intent-protocol.json | GET | 无 | 平台发现 |
链接
- 线上 endpoint:
https://api.jarvisclaw.ai - SDK 使用指南: SDK 参考
- 支付: Agent 支付 (x402)
- 发现协议: Discovery
- 社区: https://t.me/JarvisClawai