AgentCard.net APIBezpłatnie podczas wersji beta

Narzędzia Agent Card, stworzone dla oprogramowania.

Generuj, weryfikuj i sprawdzaj Agent Card A2A v1.0 z aplikacji, potoku CI, narzędzia programistycznego lub autonomicznego Agenta.

Zacznij od cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Szybki start

Wyślij pierwsze żądanie.

Wyślij JSON przez HTTPS. W wersji beta nie potrzebujesz konta ani API Key. Ten przykład generuje i weryfikuje pełną Agent Card w jednym wywołaniu.

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

Trzy ukierunkowane operacje.

Używaj osobnych endpointów REST w zwykłych aplikacjach lub jednolitego endpointu umiejętności, gdy wywołuje go inny Agent.

POST

Generuj Agent Card

/api/agent-card/generate

Zamienia dane usługi w publikowalny JSON A2A v1.0 i zwraca raport weryfikacji w tej samej odpowiedzi.

Zobacz przykład
POST

Weryfikuj JSON Agent Card

/api/agent-card/validate

Sprawdza tożsamość, interfejsy, możliwości, tryby, umiejętności, metadane bezpieczeństwa, stare pola i osadzone sekrety.

Zobacz przykład
POST

Sprawdź zdalne wykrywanie

/api/agent-card/check

Sprawdza obie ścieżki well-known i weryfikuje każdą Agent Card zwróconą przez zdalny host.

Zobacz przykład
POST/generate

Generuj Agent Card

Zamienia dane usługi w publikowalny JSON A2A v1.0 i zwraca raport weryfikacji w tej samej odpowiedzi.

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

Weryfikuj JSON Agent Card

Sprawdza tożsamość, interfejsy, możliwości, tryby, umiejętności, metadane bezpieczeństwa, stare pola i osadzone sekrety.

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

Sprawdź zdalne wykrywanie

Sprawdza obie ścieżki well-known i weryfikuje każdą Agent Card zwróconą przez zdalny host.

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 · Integracja Agentów

Pozwól Agentowi odkryć i wywołać API.

AgentCard.net publikuje uzupełniające formaty wykrywania. Agent może najpierw sprawdzić możliwości, a następnie wywołać umiejętność przez stabilny endpoint.

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

04 · Odpowiedzi

Struktura do podejmowania decyzji.

Weryfikacja oddziela błędy blokujące, przydatne ostrzeżenia i udane kontrole, aby oprogramowanie decydowało bez analizowania tekstu.

errorsustawia valid na false

warningswskazuje braki gotowości

passespotwierdza udane kontrole

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

05 · Limity

Bezpieczne ustawienia publicznego API.

Limit ładunku 256 KB

Dotyczy wejściowego JSON i każdej zdalnej odpowiedzi.

Limit czasu 8 sekund

Zdalne żądania szybko kończą się, gdy host jest niedostępny.

Bezpieczne kontrole sieci

Prywatne adresy i niebezpieczne przekierowania są odrzucane.

Bez API Key podczas beta

API jest otwarte z przybliżonym limitem na IP.

Zdalne kontrole przyjmują tylko publiczne hosty HTTP lub HTTPS.

Prywatne i zastrzeżone zakresy IP są blokowane; sprawdzane jest każde przekierowanie, rozmiary odpowiedzi są ograniczone, a błędy zwracane osobno dla ścieżek.

06 · Monetyzacja

Teraz bezpłatna beta, później dostęp według użycia.

API nie wymaga obecnie płatności ani API Key. AgentCard.net planuje używać x402 przez Cloudflare Monetization Gateway dla wybranych operacji, zachowując publiczną dokumentację wykrywania.

OpenAPI JSONWypróbuj narzędzia webowe
Schemat Agent CardPrzykłady Agent CardPrzewodnik po well-known URL