Skip to content

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 KeyAuthorization: Bearer <key>托管计费——平台从你的托管钱包结算
Private Key (x402)PAYMENT-SIGNATURE(或 X-PAYMENT自主 Agent——Agent 直接用自己的钱包签名支付

x402 模式: SDK 自动处理 402 Payment Required → 签名 → 重试 流程。你的代码写法不变,只是初始化不同。每次请求都在链上结算。

PAYMENT-SIGNATUREX-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/discoverGET /v1/providers 是公开的。POST 形式的 解析和所有执行路径都需要认证 —— 它们会消耗 embedding 与上游资源。


支持的意图类型

本地定义 13 种意图类型:

意图类型说明典型价格
chat_completion文本生成 / 对话$0.0001–0.05/次
image_generationAI 图片生成$0.015–0.11/次
video_generationAI 视频生成按秒计费,见视频生成
text_to_speech语音合成$0.05–0.12/千字符
web_search网页搜索$0.0095/次
knowledge_search语义检索$0.004–0.012/次
prompt_optimizationAI 驱动的 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其他工具类服务不定

网络节点会在此之上贡献更多意图类型(blockchaingeodnsemailstoragewebaudio_generationgeneral 等,随节点加入而变化)。

speech_to_texttool_callx-{vendor}/{type} 都不存在

前两者不在服务端意图常量表内;语音识别请直接调 /v1/audio/transcriptions,MCP 工具请走 POST /mcptools/call。自定义供应商前缀格式在服务端也没有实现。

请以 GET /v1/intent/types 返回的实时列表为准 —— 它是本地常量与提供商注册表的并集,会随节点 上下线变化,不要硬编码上表。


API Endpoints

POST /v1/intent/resolve

查找最佳提供商,不执行。

请求:

json
{
  "intent": "chat_completion",
  "constraints": {
    "max_price_usd": 0.05,
    "max_latency_ms": 3000,
    "features": ["function_calling", "json_mode"]
  },
  "preferences": {
    "optimize_for": "quality",
    "limit": 10
  }
}
字段类型说明
intentstring必填。意图类型标识
querystring可选。用于语义相关性打分的自由文本
constraints.max_price_usdnumber传入时必须为正数
constraints.max_latency_msinteger传入时必须为正数
constraints.featuresstring[]要求提供商具备的能力
preferences.optimize_forstringcost | quality | latency | budget
preferences.limitinteger返回候选数上限(默认 10)

响应:

json
{
  "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/xfederation/<id>/<name>
matches[].score综合排序分,0–1
matches[].estimated_price_usd单次预估成本。token 计费时按 500 输入 / 500 输出估算
matches[].pricing原始报价:input_per_millionoutput_per_millionper_call
matches[].endpoint该提供商对应的调用路径
matches[].model上游模型名(若适用)
matches[].reason排序原因的可读说明
total_available约束过滤前匹配该意图的提供商总数

解析不是预留

响应中没有 resolution_id,也没有 expires_at —— 什么都不会为你锁定。解析只是一次排序查询, 价格可能在解析与执行之间变动。同时也不支持 preferred_providersexcluded_providerscontext 字段:请用 featuresmax_price_usd 过滤,或自行从 matches 中挑选。

注意方法差异: GET /v1/intent/resolve 免费且无需认证,但只返回用法说明。真正的排序解析是 POST,需要认证并消耗 embedding 资源。


POST /v1/intent/execute

核心 endpoint。解析最佳提供商、执行请求、结算支付、返回结果——一次调用完成。

请求:

json
{
  "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
  }
}
字段类型说明
intentstring意图类型。与 resource_id 二选一
resource_idinteger网络资源 ID —— 直接指定提供商并跳过解析
payloadobject转发给提供商的请求体。GET 类 marketplace 端点可省略
constraints / preferencesobject/resolve 同构
endpointstring多端点服务内的子路径,含查询串
methodstring转发使用的 HTTP 方法,默认 POST
headersobject需转发到上游的额外请求头

路由分三级:resource_id 优先,其次 intent,两者都缺则返回 400。支付由 x402 中间件在本处理器 之前完成结算,因此请求体里没有 payment 对象 —— 金额来自 402 报价。

响应(本地 / marketplace / builtin 提供商):

上游响应原样透传。chat_completion 即标准 OpenAI 格式补全:

json
{
  "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" }
}

响应(网络提供商):

网络执行有一层包装,因为网关需要回报自己的结算信息:

json
{
  "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,但走完整的编排流水线并施加硬预算上限:校验预算 → 风险评分 → 选择支付路径 → 预扣 → 执行 → 确认或回滚。若费用会超出上限,请求在执行前被 拒绝

请求:

json
{
  "intent": "chat_completion",
  "budget": {
    "max_total_usd": 0.50,
    "preferred_payment_method": "auto",
    "allow_overdraft": false
  },
  "payload": {
    "messages": [{"role": "user", "content": "总结这份文档……"}]
  }
}
字段类型说明
budget.max_total_usdnumber必填。 本次请求的硬上限
budget.preferred_payment_methodstringbalance | credit | crypto | auto(默认 auto
budget.allow_overdraftboolean余额不足时是否允许走信用额度继续

这里没有单次和每日限额字段

per_call_limit_usddaily_limit_usd 不属于此请求。持久化限额在钱包上,请用 PUT /v1/wallet/limits 设置(per_request_max_usddaily_max_usdmonthly_max_usdauto_pause_below_usd)。详见钱包与资金库

响应:

json
{
  "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 取值 successrejectederrorrisk_blocked。HTTP 状态码同步:rejectedrisk_blocked 返回 403error 返回 500。注意此端点的 settlement 是内部记账用的 SettlementRecord,与 /execute 网络调用返回的带签名凭证结构不同。


POST /v1/intent/resolve/natural

自然语言解析。用自然语言描述需求,AIP 通过 embedding 相似度(并以关键词兜底)识别意图并排序提供商。

只解析,不执行、不扣费

该端点只返回候选。它不会运行请求,也不会结算支付。请从 matches 里挑选提供商,再自行调用 /v1/intent/execute(或该提供商的 endpoint)。

请求:

json
{
  "query": "我想生成一张赛博朋克城市的图片",
  "session_id": "可选,用于多轮澄清",
  "constraints": { "max_price_usd": 0.10 },
  "preferences": { "optimize_for": "cost" }
}

query 必填。constraints.max_price_usdmax_latency_ms 传入时必须为正数。没有 budget 字段。

响应(已解析):

json
{
  "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"
    }
  ]
}

响应(需要澄清):

json
{
  "status": "clarify",
  "session_id": "s_8f3a...",
  "clarify": {
    "question": "你想要静态图片还是一段视频?",
    "options": ["image_generation", "video_generation"],
    "round": 1
  },
  "message": "多个意图的置信度接近。"
}

status 取值为 resolvedclarifybudget_insufficientno_match。需要澄清时,把返回的 session_id 一并带上继续追问。options 是意图标识的扁平数组,不是对象数组。


GET /v1/intent/audit

查看 AIP 编排的近期生命周期日志。

不接受任何查询参数,返回内存环形缓冲区(容量 10000 条,异步持久化)中最新的记录。

响应:

json
{
  "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最终支付结果

不是可分页的账本

没有 totalpagepage_size,也不能按日期或意图类型过滤。要查消费历史和分模型明细,请用 下方的分析端点,或 GET /v1/wallet/history


GET /v1/intent/types

列出所有可解析的意图类型 —— 本地常量与提供商注册表已索引意图的并集,已排序。无需认证。

json
{ "intent_types": ["audio_generation", "blockchain", "chat_completion", "code_execution", "..."] }

GET /v1/providers

列出所有已注册提供商及其元数据和报价。无需认证。

json
{ "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

只返回聚合计数 —— 可解析网络的规模。公开、无需认证、可放心轮询。

json
{
  "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对消费与市场日志的深度扫描汇总

公共查询参数:period24h7d 默认、30d90d)、group_by(可取 daymodelapi_sourceprincipal_typechannelgroupclient_id,默认 day,model,api_source)、modeluser_id,以及 filter_api_source / filter_principal_type / filter_client_id / filter_channel / filter_group

AIP 用量出现在同一批数据中,以 api_source="aip" 标识。旧的 /v1/aip/analytics/* 端点已被移除。


订阅(SSE)

端点方法说明
/v1/intent/subscribePOST执行意图并通过 Server-Sent Events 流式返回
/v1/intent/subscribeGET列出你的活跃订阅
/v1/intent/subscribe/:idDELETE取消订阅

事件以 event: / data: 成对到达。两个 SDK 都做了封装 —— 见 SDK 参考


优化策略

optimize_for 参数控制提供商选择:

行为
cost满足约束的最便宜提供商 (默认)
quality最高评分提供商(可能更贵)
latency最低延迟提供商
budget重点权衡支付开销 —— 适合极紧的单次预算

未知取值会静默退化为 cost

speedbalance 都不是合法值。无法识别的取值会被静默当作 cost 处理 —— 拼错不会报错, 但你要的行为不会生效。请用 latency 而不是 speed

当请求带 query 且 embedding 后端可用时,语义相关性占最终分数的 55%, 价格/质量/延迟/可靠性的混合分占其余部分。不带 query 时只用混合分。


结算

发生链上结算的执行会返回 settlement 对象:

字段说明
tx_hash链上交易哈希(可在任何区块浏览器验证)
amountUSDC 精确结算金额
currency始终为 USDC
chainbase
provider_used实际服务本次请求的提供商
facilitator处理支付的 x402 facilitator
timestampRFC 3339 UTC 时间戳
attestation签名凭证 —— 配置了签名密钥时出现

所有结算完全链上、非托管。你可以在对应链的区块浏览器验证任何交易。

可离线验证的签名凭证

启用签名后,凭证会带上一份 EIP-712 签名,无需信任网关即可自行校验:

json
{
  "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_hashresult_hash,在 SettlementReceipt(intent_hash, result_hash, provider_used, amount, currency, tx_hash, timestamp) 上恢复 EIP-712 签名者,确认它与 /.well-known/agent-intent-protocol.jsonattestation.signer 一致,然后到链上核对 tx_hash


错误处理

AIP 端点返回扁平的 {"error": "<消息>"} 结构。这一层没有稳定的机器可读 code 字段 —— 请按 HTTP 状态码分支,必要时再匹配消息文本。

HTTP 状态场景消息示例
400请求体格式错误或约束非法max_price_usd must be a positive value
400resource_idintent 均未提供either resource_id or intent is required
401预算/网络调用缺少认证上下文authentication required
402需要 x402 支付(SDK 自动处理)402 报价体,见 x402
402网络结算失败... settle ...
403预算被拒或被风险拦截(/execute-budgetstatus: "rejected" / "risk_blocked"
404没有提供商匹配该意图no matching provider for intent
404resource_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 字段表达结果(successrejectederrorrisk_blocked),两处都要检查。


平台服务

除了标准意图(chat_completionweb_search 等),AIP 也能直接调用平台上架的服务——例如 surf 行情数据服务。这些服务都通过同一个 /v1/intent/execute 端点调用。

一个平台服务通常包含多个功能端点(行情查询、交易对信息等)。调用时用 intent 指定服务类别,用 endpoint 指定服务内的具体功能路径:

bash
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):

json
{
  "success": true,
  "data": { "pair": "BTC-USDT", "price": "64251.94" }
}
字段说明
intent服务对应的意图类别
endpoint服务内的功能路径(含查询参数)
methodHTTP 方法,默认 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 的平台都可以加入网络。

工作方式

  1. 平台通过域名注册为对等节点
  2. 同步爬虫按固定周期访问各节点的 .well-known endpoint(默认 30 分钟)
  3. 所有节点的资源聚合到统一目录
  4. Agent 通过相同 API 发现和执行网络资源

网络端点

Endpoint方法认证说明
/v1/network/searchGET全文搜索网络资源
/v1/network/apisGET浏览所有网络资源
/v1/network/serversGET列出网络对等节点
/v1/network/healthGET所有节点的健康状态
/v1/network/recommendPOST无(deep 档需 x402)资源推荐
/v1/network/executePOST需要执行网络资源

搜索(关键词):

bash
curl "https://api.jarvisclaw.ai/v1/network/search?q=stock&category=finance&limit=5"

推荐(自然语言发现):

json
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。响应:

json
{
  "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。相同查询会命中缓存。

执行网络资源:

json
POST /v1/network/execute
{
  "resource_id": 532,
  "payload": {"ticker": "AAPL"}
}

resource_id/v1/network/apis 返回的数字 ID,不是 "stock-analysis" 这样的 slug。 也可以改传 intent 让解析器挑选资源。请求体与 /v1/intent/execute 同构,因此 endpointmethodheaders 在此同样可用。

成为网络节点

  1. 提供 GET /.well-known/agent-intent-protocol.json 返回你的元数据
  2. 实现接受 x402 支付的资源执行 endpoint
  3. 联系我们注册你的域名

最小 .well-known schema:

json
{
  "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_resolvePOST /v1/intent/resolve
aip_execute_with_budgetPOST /v1/intent/execute-budget
aip_list_intentsGET /v1/intent/types
aip_estimate_cost本地成本估算,无对应 HTTP 端点

此外还有网关通用工具 list_modelschatsearch_apisget_api_detaildiscover_agents,以及每个已发布用户 API 对应的一个 uapi_{slug}。详见 MCP 配置

并非所有端点都有 MCP 工具

/v1/intent/execute/v1/intent/resolve/natural/v1/intent/audit 没有对应的 MCP 工具 —— 请直接走 HTTP。


Endpoint 总览

Endpoint方法认证说明
/v1/intent/resolveGETPOST 形式的用法说明
/v1/intent/resolvePOST需要按意图排序提供商
/v1/intent/resolve/naturalPOST需要自然语言解析(不执行)
/v1/intent/discoverGET发现意图与提供商
/v1/intent/discoverPOST需要基于 embedding 的语义发现
/v1/intent/executePOST需要解析 + 执行 + 结算
/v1/intent/execute-budgetPOST需要带预算上限的编排执行
/v1/intent/subscribePOST需要执行并通过 SSE 流式返回
/v1/intent/subscribeGET需要列出活跃订阅
/v1/intent/subscribe/:idDELETE需要取消订阅
/v1/intent/auditGET需要近期编排生命周期日志
/v1/intent/typesGET列出意图类型
/v1/providersGET列出提供商及报价
/v1/network/statsGET网络规模聚合计数
/api/analytics/*GET需要消费聚合、质量指标、深度洞察
/v1/network/searchGET关键词搜索网络资源
/v1/network/apisGET浏览网络资源
/v1/network/serversGET列出网络节点
/v1/network/healthGET节点健康状态
/v1/network/recommendPOST无(deep 档需 x402)资源推荐
/v1/network/executePOST需要执行网络资源
/v1/aip/federation/peersGET/POST/DELETE管理员管理网络节点
/v1/aip/federation/crawlPOST管理员手动触发节点同步
/v1/wallet/*GET/PUT需要余额、流水、限额、资金池
/.well-known/agent-intent-protocol.jsonGET平台发现

链接