Сравнение
Static vs Dynamic agent-card: статичный файл или SSR
Статичный agent-card.json проще, кешируемее и надёжнее; SSR нужен только если данные реально меняются по запросу. Для большинства — static.
Коротко
Оба валидны, но для большинства сайтов статичный файл лучше: проще, кешируется, не падает. Динамический (SSR) оправдан, только когда содержимое карточки реально меняется от запроса к запросу.
Что такое каждое
- Static — JSON-файл по пути (
/.well-known/ai-agent.json, agent.json, MCP card), отдаётся как есть, кешируется CDN. - Dynamic (SSR) — эндпоинт генерирует JSON на каждый запрос: можно подставлять актуальный rate-limit, разные capabilities по контексту и т.п.
Сравнение
| Static | Dynamic (SSR) | |
|---|---|---|
| Обновление | Пересборка/деплой | На каждый запрос |
| Производительность | CDN, очень быстро | Серверная нагрузка |
| Надёжность | Файл не «упадёт» | Зависит от рантайма |
| Когда | Стабильные данные | Данные меняются по запросу |
Главное различие
Static — это снимок, обновляемый при деплое. Dynamic — живой ответ, собираемый рантаймом. SSR даёт гибкость ценой нагрузки и точки отказа.
Что выбрать
Для большинства карточек данные стабильны (имя, возможности, endpoints) — берите static: быстрее, кешируется, надёжнее. SSR — только если поле действительно должно меняться динамически (актуальная квота, A/B возможностей). Не усложняйте без необходимости.
Как проверить
Скану всё равно, как сгенерирован файл — он проверяет, что по нужному пути отдаётся валидный JSON с обязательными полями. Static вы получите «бесплатно» и быстро.