JarvisClaw

中文

English

中文

English

Appearance

AIP 网络 — 跨平台发现与执行 ​

资源网络让你的平台自动发现并聚合来自其他 AIP 兼容平台的服务。当 Agent 查询你的网络端点时，网络节点的结果会与本地提供商一并返回。Agent 可以通过单一平台访问整个生态系统的 AI 服务，支付通过 x402 链上结算。

在线演示

查看 AIP 交互式演示 — 包含网络执行的完整流程。

工作原理 ​

┌─────────────┐       ┌──────────────────┐       ┌─────────────────┐
│   Agent     │──────▶│    你的平台       │──────▶│   对等平台       │
│             │       │  (AIP 网关)       │       │  (网络节点)      │
│             │       │                  │       │                 │
│  发现       │       │  本地结果         │       │  远程结果        │
│  搜索       │       │  + 网络结果       │       │  x402 结算       │
│  执行       │◀──────│  聚合返回         │◀──────│                 │
└─────────────┘       └──────────────────┘       └─────────────────┘
  1. 平台自动发现并同步网络节点资源（默认每 30 分钟刷新一次）
  2. Agent 通过 /v1/network/search、/v1/network/apis、/v1/network/health 搜索或浏览网络资源
  3. Agent 通过 POST /v1/network/recommend 获取推荐
  4. Agent 通过 POST /v1/network/execute 执行网络资源，x402 链上支付

定价 ​

操作费用
浏览（health、search、resources、servers）免费
推荐（standard 档）免费，限流 20 次/分钟
推荐（deep 档，LLM 语义排序）$0.01/次，需 x402 支付
执行网络资源按资源标价收费（USDC，链上结算）

两种推荐档位

默认 standard 档为关键词打分，免费但限流。传 X-Recommend-Tier: deep（或 ?tier=deep） 启用 LLM 增强的语义排序，每次 $0.01；未携带支付头时该档返回 402。相同查询会命中缓存。

每个网络资源都有明确的 price_per_call 标价，Agent 按标价支付即可。支付通过 x402 协议在链上完成，完全透明可验证。

API 端点 ​

所有端点都在 /v1/network 前缀下。

搜索资源（公开） ​

bash
GET /v1/network/search?q=bookmark&category=social&limit=10

返回匹配搜索条件的网络资源列表：

json
{
  "results": [
    {
      "resource_id": "twitter_bookmark_search",
      "name": "Twitter Bookmark Search",
      "description": "Search and retrieve Twitter/X bookmarks",
      "category": "social",
      "price_per_call": "0.005",
      "server_name": "partner-platform"
    }
  ]
}

列出服务器（公开） ​

bash
GET /v1/network/servers?page=1&page_size=20

返回所有已注册的网络服务器列表。

健康检查（公开） ​

bash
GET /v1/network/health

返回每个网络节点的状态信息。

AI 推荐 ​

bash
POST /v1/network/recommend
Content-Type: application/json

{
  "query": "我需要搜索我的推特收藏夹",
  "category": "social",
  "max_results": 3,
  "min_score": 0.5,
  "healthy_only": true
}

query 为必填字段（不是 intent），结果数量上限字段为 max_results（不是 limit）。

响应：

json
{
  "query": "我需要搜索我的推特收藏夹",
  "results": [
    { "resource": { "...": "..." }, "server_name": "partner-platform", "server_url": "...", "score": 0.82 }
  ],
  "count": 3,
  "cached": false,
  "tier": "standard"
}

执行网络资源 ​

bash
POST /v1/network/execute
Authorization: Bearer <api-key>
Content-Type: application/json

{
  "resource_id": 532,
  "payload": {
    "query": "AI agent papers",
    "limit": 10
  }
}

resource_id 是 /v1/network/apis 返回的数字 ID，不是字符串 slug；请求体字段为 payload（不是 arguments），且没有 server_name 字段 —— 资源 ID 已唯一确定所属节点。也可以 改传 intent 让解析器自动挑选资源。

响应：

json
{
  "success": true,
  "data": { "bookmarks": [ { "id": "1234567890", "text": "..." } ] },
  "tx_hash": "0xabc123...def456",
  "cost_usd": 0.006,
  "upstream_cost": 0.005,
  "latency_ms": 812,
  "settlement": {
    "tx_hash": "0xabc123...def456",
    "amount": "0.006000",
    "currency": "USDC",
    "chain": "base",
    "provider_used": "federation/532/Twitter Bookmark Search",
    "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
    "timestamp": "2026-07-08T10:30:00Z"
  }
}

执行流程 ​

Agent 发起 POST /v1/network/execute
  → 平台匹配网络资源
  → 验证 Agent 钱包余额
  → Agent 通过 x402 支付资源标价
  → 执行资源并返回结果
  → 返回结果 + 链上结算收据给 Agent

成为网络节点 ​

任何平台都可以通过实现 AIP .well-known 发现端点加入网络：

  1. 提供 GET /.well-known/agent-intent-protocol.json 端点，返回你的平台元数据和资源列表
  2. 实现 x402 支付的资源执行端点
  3. 确保你的端点可从公共互联网访问
  4. 联系平台运营方将你注册为网络节点

安全性 ​

  • 同步爬虫仅对 .well-known 端点发出出站 GET 请求
  • 网络执行要求 Agent 有足够的加密钱包余额
  • 支付通过 x402 链上结算 — 完全可验证且非托管
  • 节点响应在返回给 Agent 前会被校验
  • 节点会被持续健康检查；不健康的节点其资源将暂停对外提供，直至恢复
  • 支持链：Base 和 Solana（仅 USDC）
  • 网络执行失败时会回退到服务同一意图的本地提供商；若无可用回退则返回 502

相关链接 ​