AgentCard.net APIMiễn phí trong giai đoạn beta

Bộ công cụ Agent Card, được tạo cho phần mềm.

Tạo, xác thực và kiểm tra Agent Card A2A v1.0 từ ứng dụng, quy trình CI, công cụ phát triển hoặc Agent tự động.

Bắt đầu với cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Bắt đầu nhanh

Gửi yêu cầu đầu tiên.

Gửi JSON qua HTTPS. Trong giai đoạn beta, bạn không cần tài khoản hoặc API Key. Ví dụ này tạo và xác thực Agent Card hoàn chỉnh trong một lần gọi.

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 · Endpoint

Ba thao tác chuyên biệt.

Dùng từng REST endpoint trong ứng dụng thông thường hoặc endpoint kỹ năng hợp nhất khi bên gọi là một Agent khác.

POST

Tạo Agent Card

/api/agent-card/generate

Chuyển thông tin dịch vụ thành JSON A2A v1.0 có thể xuất bản và trả về báo cáo xác thực trong cùng phản hồi.

Xem ví dụ
POST

Xác thực JSON Agent Card

/api/agent-card/validate

Kiểm tra danh tính, giao diện, khả năng, chế độ, kỹ năng, siêu dữ liệu bảo mật, trường cũ và bí mật nhúng.

Xem ví dụ
POST

Kiểm tra khám phá từ xa

/api/agent-card/check

Kiểm tra cả hai đường dẫn well-known và xác thực mọi Agent Card do máy chủ từ xa trả về.

Xem ví dụ
POST/generate

Tạo Agent Card

Chuyển thông tin dịch vụ thành JSON A2A v1.0 có thể xuất bản và trả về báo cáo xác thực trong cùng phản hồi.

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

Xác thực JSON Agent Card

Kiểm tra danh tính, giao diện, khả năng, chế độ, kỹ năng, siêu dữ liệu bảo mật, trường cũ và bí mật nhúng.

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

Kiểm tra khám phá từ xa

Kiểm tra cả hai đường dẫn well-known và xác thực mọi Agent Card do máy chủ từ xa trả về.

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 · Tích hợp Agent

Cho phép Agent khám phá và gọi API.

AgentCard.net xuất bản các định dạng khám phá bổ trợ. Agent có thể kiểm tra khả năng trước rồi gọi kỹ năng qua một endpoint ổn định.

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

04 · Phản hồi

Có cấu trúc để ra quyết định.

Kết quả xác thực tách lỗi chặn, cảnh báo hữu ích và kiểm tra thành công để phần mềm quyết định mà không cần phân tích văn bản.

errorsđặt valid thành false

warningschỉ ra thiếu sót sẵn sàng

passesxác nhận kiểm tra đã đạt

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

05 · Giới hạn

Mặc định an toàn cho API công khai.

Giới hạn payload 256 KB

Áp dụng cho JSON đầu vào và mọi phản hồi từ xa.

Hết thời gian sau 8 giây

Yêu cầu từ xa dừng nhanh khi máy chủ không khả dụng.

Kiểm tra mạng an toàn

Từ chối địa chỉ riêng và chuyển hướng không an toàn.

Không cần API Key trong beta

API hiện mở với giới hạn tốc độ theo IP ở mức best-effort.

Kiểm tra từ xa chỉ chấp nhận máy chủ HTTP hoặc HTTPS công khai.

Dải IP riêng và dành riêng bị chặn; mọi chuyển hướng được kiểm tra, kích thước phản hồi bị giới hạn và lỗi được trả riêng theo đường dẫn.

06 · Kiếm tiền

Beta miễn phí hiện tại, truy cập theo mức dùng sau này.

API hiện không yêu cầu thanh toán hoặc API Key. AgentCard.net dự kiến dùng x402 qua Cloudflare Monetization Gateway cho một số thao tác tốn tài nguyên, đồng thời giữ tài liệu khám phá công khai.

OpenAPI JSONThử công cụ web
Schema Agent CardVí dụ Agent CardHướng dẫn URL well-known