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 指南