AgentCard.net APIベータ期間中は無料

Agent Card ツールを、 ソフトウェアのために。

アプリ、CI パイプライン、開発ツール、自律型エージェントから 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 を送信します。ベータ期間中はアカウントも API Key も不要です。この例では、1 回の呼び出しで完全な 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 · エンドポイント

目的別の 3 つの操作。

通常のアプリでは個別の REST エンドポイントを、別の Agent が呼び出す場合は統一スキルエンドポイントを使用します。

POST

Agent Card を生成

/api/agent-card/generate

サービス情報を公開可能な A2A v1.0 JSON に変換し、同じレスポンスで検証レポートを返します。

例を見る
POST

Agent Card JSON を検証

/api/agent-card/validate

ID、インターフェース、機能、モード、スキル、セキュリティメタデータ、旧フィールド、埋め込みシークレットを確認します。

例を見る
POST

リモート検出を確認

/api/agent-card/check

2 つの 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 を検証

ID、インターフェース、機能、モード、スキル、セキュリティメタデータ、旧フィールド、埋め込みシークレットを確認します。

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

リモート検出を確認

2 つの 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 は機能を確認してから、安定した 1 つのエンドポイントでスキルを呼び出せます。

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

04 · レスポンス

判断しやすい構造。

検証結果はエラー、警告、成功項目に分かれているため、ソフトウェアは文章を解析せずに判断できます。

errorsvalid を 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 秒のタイムアウト

ホストが利用できない場合、リモート要求をすぐに停止します。

安全なネットワーク確認

プライベートアドレスと危険なリダイレクトを拒否します。

ベータ中は API Key 不要

現在は公開され、IP ごとのベストエフォート制限があります。

リモート確認は公開 HTTP / HTTPS ホストのみ受け付けます。

プライベートおよび予約済み IP 範囲をブロックし、各リダイレクト先を確認し、レスポンスサイズを制限して、障害をパスごとに返します。

06 · 収益化

現在は無料ベータ、将来は従量制。

現在、支払いも API Key も不要です。AgentCard.net は検出ドキュメントを公開したまま、一部の高負荷処理に Cloudflare Monetization Gateway 経由の x402 を利用する予定です。

OpenAPI JSONWeb ツールを試す
Agent Card スキーマAgent Card の例well-known URL ガイド