AgentCard.net APIБезкоштовно під час бета-тесту

Інструменти Agent Card, створені для програм.

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

Почати з 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-ендпоінти у звичайних застосунках або єдиний ендпоінт навичок, коли викликає інший Agent.

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 · Інтеграція Agent

Дозвольте Agent знайти й викликати API.

AgentCard.net публікує взаємодоповнювальні формати виявлення. Agent може спочатку дослідити можливості, а потім викликати навичку через стабільний ендпоінт.

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