AgentCard.net APIGrátis durante a beta

Ferramentas Agent Card, feitas para software.

Gere, valide e inspecione Agent Cards A2A v1.0 a partir do seu aplicativo, pipeline de CI, ferramenta de desenvolvimento ou agente autônomo.

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

01 · Início rápido

Faça sua primeira solicitação.

Envie JSON por HTTPS. Durante a beta, não é necessário conta nem API Key. Este exemplo gera e valida uma Agent Card completa em uma única chamada.

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

Três operações focadas.

Use os endpoints REST individuais em aplicativos comuns ou o endpoint unificado de skills quando outro agente fizer a chamada.

POST

Gerar uma Agent Card

/api/agent-card/generate

Transforme os detalhes do serviço em JSON A2A v1.0 publicável e receba um relatório de validação na mesma resposta.

Ver exemplo
POST

Validar JSON da Agent Card

/api/agent-card/validate

Verifica identidade, interfaces, recursos, modos, skills, metadados de segurança, campos antigos e segredos incorporados.

Ver exemplo
POST

Verificar descoberta remota

/api/agent-card/check

Inspeciona os dois caminhos well-known e valida cada Agent Card retornada pelo host remoto.

Ver exemplo
POST/generate

Gerar uma Agent Card

Transforme os detalhes do serviço em JSON A2A v1.0 publicável e receba um relatório de validação na mesma resposta.

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

Validar JSON da Agent Card

Verifica identidade, interfaces, recursos, modos, skills, metadados de segurança, campos antigos e segredos incorporados.

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

Verificar descoberta remota

Inspeciona os dois caminhos well-known e valida cada Agent Card retornada pelo host remoto.

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 · Integração de agentes

Permita que um agente descubra e chame a API.

AgentCard.net publica formatos de descoberta complementares. Um agente pode primeiro examinar os recursos e depois invocar uma skill por um endpoint estável.

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

04 · Respostas

Estruturado para decisões.

A validação separa erros bloqueadores, avisos úteis e verificações bem-sucedidas para que o software decida sem analisar texto livre.

errorsdefine valid como false

warningsindica lacunas de preparação

passesconfirma verificações aprovadas

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

05 · Limites

Padrões seguros para uma API pública.

Limite de payload de 256 KB

Aplicado ao JSON recebido e a cada resposta remota.

Timeout de 8 segundos

As solicitações remotas terminam rapidamente se o host estiver indisponível.

Verificações de rede seguras

Endereços privados e redirecionamentos inseguros são rejeitados.

Sem API Key durante a beta

A API está aberta com limite aproximado por IP.

As verificações remotas aceitam apenas hosts HTTP ou HTTPS públicos.

Faixas IP privadas e reservadas são bloqueadas; cada redirecionamento é verificado, as respostas são limitadas e as falhas são retornadas por caminho.

06 · Monetização

Beta gratuita agora; acesso por uso depois.

A API não exige pagamento nem API Key atualmente. AgentCard.net planeja usar x402 via Cloudflare Monetization Gateway para operações selecionadas, mantendo pública a documentação de descoberta.

OpenAPI JSONTestar ferramentas web
Schema da Agent CardExemplos de Agent CardGuia de URL well-known