AgentCard.net APIBeta 期間免費

Agent Card 工具， 專為軟體而建。

透過應用程式、CI 流程、開發者工具或自主 Agent 產生、驗證及檢查 A2A v1.0 Agent Card。

從 cURL 開始OpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · 快速開始

送出第一個請求。

透過 HTTPS 傳送 JSON。Beta 期間不需要帳號或 API Key。此範例會在一次呼叫中產生完整的 Agent Card 並完成驗證。

Base URLhttps://www.agentcard.net
cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'

02 · API 端點

三個專注的操作。

一般應用程式可使用獨立 REST 端點；呼叫者是另一個 Agent 時，可使用統一技能端點。

POST

產生 Agent Card

/api/agent-card/generate

將服務資訊轉換為可發布的 A2A v1.0 JSON，並在同一回應中取得驗證報告。

查看範例
POST

驗證 Agent Card JSON

/api/agent-card/validate

檢查身分、介面、能力、模式、技能、安全中繼資料、舊版欄位及內嵌密鑰。

查看範例
POST

檢查遠端發現

/api/agent-card/check

檢查兩個 well-known 發現路徑，並驗證遠端主機傳回的每個 Agent Card。

查看範例
POST/generate

產生 Agent Card

將服務資訊轉換為可發布的 A2A v1.0 JSON，並在同一回應中取得驗證報告。

cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'
POST/validate

驗證 Agent Card JSON

檢查身分、介面、能力、模式、技能、安全中繼資料、舊版欄位及內嵌密鑰。

cURL · validate
curl -X POST https://www.agentcard.net/api/agent-card/validate \
  -H "Content-Type: application/json" \
  -d '{
    "card": {
      "name": "Research Agent",
      "description": "Finds and summarizes public research.",
      "version": "1.0.0",
      "supportedInterfaces": [{
        "url": "https://api.example.com/a2a/research",
        "protocolBinding": "HTTP+JSON",
        "protocolVersion": "1.0"
      }],
      "capabilities": {},
      "defaultInputModes": ["text/plain"],
      "defaultOutputModes": ["application/json"],
      "skills": [{
        "id": "research",
        "name": "Research",
        "description": "Finds relevant sources and returns a cited summary.",
        "tags": ["research"]
      }]
    }
  }'
POST/check

檢查遠端發現

檢查兩個 well-known 發現路徑，並驗證遠端主機傳回的每個 Agent Card。

cURL · remote check
curl -X POST https://www.agentcard.net/api/agent-card/check \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

03 · Agent 整合

讓 Agent 發現並呼叫 API。

AgentCard.net 發布互補的發現格式。Agent 可先檢查能力，再透過一個穩定端點呼叫技能。

POST /api/agent-card
{
  "skillId": "validate-agent-card",
  "input": {
    "card": {
      "name": "Example Agent",
      "description": "..."
    }
  }
}

04 · 回應

為程式決策而結構化。

驗證結果分離阻斷錯誤、實用警告及通過項目，讓軟體不必解析自然語言即可決策。

errors使 valid 成為 false

warnings指出就緒缺口

passes確認已完成的檢查

JSON response
{
  "validation": {
    "valid": false,
    "errors": [
      {
        "severity": "error",
        "message": "Missing required field: version."
      }
    ],
    "warnings": [],
    "passes": [
      {
        "severity": "pass",
        "message": "Agent name is present."
      }
    ]
  }
}

05 · 限制

公共 API 的安全預設值。

256 KB 承載限制

適用於傳入 JSON 及每個遠端回應本文。

8 秒逾時

遠端主機無法使用時會快速停止發現請求。

網路安全檢查

拒絕私人位址及不安全的重新導向目標。

Beta 期間不需 API Key

API 目前開放，並提供盡力而為的每 IP 速率限制。

遠端檢查僅接受公開的 HTTP 或 HTTPS 主機。

私人及保留 IP 範圍會被阻擋；每次重新導向都會檢查目標，回應大小受限，網路故障會依發現路徑分別回傳。

06 · 商業化

現在免費 Beta，未來按用量存取。

API 目前不需要付費或 API Key。AgentCard.net 計畫透過 Cloudflare Monetization Gateway 使用 x402，為部分資源密集型操作收費，同時保持發現文件公開。

OpenAPI JSON試用網頁工具
Agent Card SchemaAgent Card 範例Well-known URL 指南