AgentCard.net APIБесплатно во время бета-теста

Инструменты Agent Card, созданные для программ.

Создавайте, проверяйте и исследуйте Agent Card A2A v1.0 из приложения, CI-конвейера, инструмента разработчика или автономного агента.

Начать с cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Быстрый старт

Отправьте первый запрос.

Отправьте JSON по HTTPS. Во время бета-теста аккаунт и 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 · Эндпоинты

Три целевые операции.

Используйте отдельные REST-эндпоинты в обычных приложениях или единый эндпоинт навыков, если вызов делает другой агент.

POST

Создать Agent Card

/api/agent-card/generate

Преобразует сведения о сервисе в публикуемый JSON A2A v1.0 и возвращает отчёт проверки в том же ответе.

Посмотреть пример
POST

Проверить JSON Agent Card

/api/agent-card/validate

Проверяет идентичность, интерфейсы, возможности, режимы, навыки, метаданные безопасности, устаревшие поля и встроенные секреты.

Посмотреть пример
POST

Проверить удалённое обнаружение

/api/agent-card/check

Исследует оба well-known пути и проверяет каждую Agent Card от удалённого хоста.

Посмотреть пример
POST/generate

Создать Agent Card

Преобразует сведения о сервисе в публикуемый JSON A2A v1.0 и возвращает отчёт проверки в том же ответе.

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

Проверить JSON Agent Card

Проверяет идентичность, интерфейсы, возможности, режимы, навыки, метаданные безопасности, устаревшие поля и встроенные секреты.

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 · Интеграция агентов

Позвольте агенту найти и вызвать API.

AgentCard.net публикует взаимодополняющие форматы обнаружения. Агент может сначала изучить возможности, а затем вызвать навык через стабильный эндпоинт.

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 КБ

Действует для входного JSON и каждого удалённого ответа.

Тайм-аут 8 секунд

Удалённые запросы быстро прекращаются, если хост недоступен.

Безопасные сетевые проверки

Частные адреса и небезопасные перенаправления отклоняются.

Без API Key в бета-версии

API открыт с примерным ограничением запросов на IP.

Удалённая проверка принимает только публичные HTTP- или HTTPS-хосты.

Частные и зарезервированные диапазоны IP блокируются; каждая переадресация проверяется, размер ответа ограничен, ошибки возвращаются для каждого пути.

06 · Монетизация

Сейчас бесплатная бета, позже — оплата по использованию.

Сейчас API не требует оплаты или API Key. AgentCard.net планирует применять x402 через Cloudflare Monetization Gateway для выбранных ресурсоёмких операций, сохраняя документацию обнаружения открытой.

OpenAPI JSONПопробовать веб-инструменты
Схема Agent CardПримеры Agent CardРуководство по well-known URL