Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
РелизКод / SDK · В работуGitHub Trending AI→ оригинал

AG-UI 1.0 даёт ИИ-агентам единый язык для связи с приложением: 31 тип событий

Каждый агентский фреймворк по-своему сообщает приложению, что агент печатает, вызвал инструмент или ждёт подтверждения человека. Протокол AG-UI 1.0 заменяет эту самописную обвязку общим потоком событий вроде «начал печатать» или «вызвал инструмент». Всего таких типов 31, они сгруппированы в восемь семейств. Поэтому один агент работает в вебе, мобильном приложении или Slack без переписывания интерфейса.

AI-обработка оригинала GitHub Trending AI; редакция Hamidun News
AG-UI 1.0 даёт ИИ-агентам единый язык для связи с приложением: 31 тип событий
Источник: GitHub Trending AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникGitHub Trending AI ↗
Главный редактор
Версия 1.0 замороженаагенты 0.x работают с клиентами 1.0 и наоборот
Ключевой факт #2SDK для TypeScript, Python и .NET генерируются из JSON Schema
Ключевой факт #3Среди сторонников заявлены Google, Microsoft, Amazon и Oracle

Представьте, что вы встраиваете ИИ-агента в чат внутри своего продукта. Агент печатает ответ по словам, посреди ответа вызывает инструмент, например поиск по базе, а потом ждёт, пока пользователь нажмёт «Подтвердить». Каждый агентский фреймворк сообщает обо всём этом приложению в своём формате, и фронтендеру приходится писать отдельную обвязку под каждый бэкенд. Протокол AG-UI (Agent-User Interaction Protocol, «протокол взаимодействия агента и пользователя») убирает эту обвязку. В версии 1.0 он описывает 31 тип событий: «агент начал печатать», «вызвал инструмент», «обновил состояние» и так далее. Любой интерфейс (UI) умеет такие события показывать.

Как это устроено

Между агентом и приложением идёт один двунаправленный поток событий. Приложение запускает «прогон» (run) и отправляет агенту одно сообщение: историю диалога, список инструментов, которые умеет выполнять фронтенд, общее состояние и контекст. В ответ агент присылает стрим типизированных событий. Клиенту не важно, на чём написан агент, ему достаточно понимать события.

Бытовая аналогия — субтитры к фильму. Фильм могли снять на любой камеру, но если формат субтитров единый, любой плеер их покажет. Здесь роль плеера играют веб-приложение, мобильный клиент, терминал или Slack.

Те самые 31 тип событий разложены на восемь семейств: жизненный цикл запуска, текстовые сообщения, вызовы инструментов, состояние, рассуждения, активность, субагенты и произвольные события. Обязательно только первое семейство. Минимальный агент отправляет пару событий, остальное добавляется по мере роста продукта.

Через эти события проходят вещи, которые обычно приходится делать вручную:

  • потоковые сообщения с отменой и возобновлением;
  • общее хранилище состояния, которое читают и пишут и агент, и приложение, с синхронизацией через снимки и дельты JSON Patch;
  • инструменты, которые агент вызывает, а выполняются они в приложении, после чего результат возвращается агенту;
  • подтверждение человеком: пользователь одобряет, правит или отклоняет действие, и следующий запуск продолжается с этого места;
  • показ хода рассуждений, включая зашифрованные рассуждения;
  • вложенное делегирование, где каждое событие помечено запуском субагента, который его породил;
  • изображения, аудио, видео и документы во вводе пользователя и в результатах инструментов.

Что значит «1.0» для разработчика

Номер 1.0 означает стабильность. Спецификация заморожена и описана через JSON Schema, а SDK для TypeScript, Python и .NET генерируются прямо из неё. Это снижает риск, что клиент и сервер разойдутся в деталях. Заявлена и обратная совместимость в обе стороны: агенты версии 0.x работают с клиентами 1.0, и наоборот. Тем, кто уже начал интеграцию, переписывать ничего не придётся.

Протокол не привязан к транспорту: спецификация описывает HTTP-привязку, а промежуточный слой (middleware) может подмешивать события из любого другого источника. Любой AG-UI-агент — это HTTP-эндпоинт, который принимает запрос и стримит события обратно. В репозитории есть пример сервера и клиента примерно на 30 строк. Ключи API для него не нужны: сервер ставится через pip install ag-ui-protocol fastapi uvicorn, клиент — через npm install @ag-ui/client tsx (нужен Node.js 20+). Если заменить сервер на другой, клиент менять не нужно.

Для быстрого старта есть CLI: npx create-ag-ui-app@latest генерирует фронтенд на Next.js или терминальный клиент под выбранный агентский фреймворк. Шаблоны обращаются к OpenAI, поэтому перед запуском нужен ключ.

Место среди других протоколов и оговорки

AG-UI позиционируется как третий элемент в наборе открытых агентских протоколов. MCP даёт агенту инструменты и контекст, A2A позволяет агентам общаться между собой, а AG-UI связывает агента с пользователем. Один агент может использовать все три сразу, и AG-UI способен стоять перед агентами, которые говорят на MCP или A2A. Отдельно стоят форматы вроде MCP Apps и Open-JSON-UI: они описывают, какой интерфейс агент хочет показать. AG-UI в этой схеме — канал, по которому эти описания и всё остальное доезжают до приложения.

Авторы заявляют, что протокол приняли Google, Microsoft, Amazon и Oracle и что он встроен в большинство агентских фреймворков. Среди упомянутых интеграций — OpenAI Agents, watsonx, Spring AI и клиенты для React, Angular, Vue и React Native. Эти данные взяты из описания самого проекта, независимой проверки масштаба внедрения в материале нет. Стоит смотреть на конкретные демо в Dojo и проверять, насколько нужный вам фреймворк поддержан без самодельных костылей.

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

Сюжет

Вопросы и ответы по материалу

Что известно по теме: как это устроено?

Между агентом и приложением идёт один двунаправленный поток событий. Приложение запускает «прогон» (run) и отправляет агенту одно сообщение: историю диалога, список инструментов, которые умеет выполнять фронтенд, общее состояние и контекст. В ответ агент присылает стрим типизированных событий. Клиенту не важно, на чём написан агент, ему достаточно понимать события. Бытовая аналогия — субтитры к фильму. Фильм могли снять на любой камеру, но если формат субтитров единый, любой плеер их покажет.

Что известно по теме: что значит «1.0» для разработчика?

Номер 1.0 означает стабильность. Спецификация заморожена и описана через JSON Schema, а SDK для TypeScript, Python и .NET генерируются прямо из неё. Это снижает риск, что клиент и сервер разойдутся в деталях. Заявлена и обратная совместимость в обе стороны: агенты версии 0.x работают с клиентами 1.0, и наоборот. Тем, кто уже начал интеграцию, переписывать ничего не придётся.

Что известно по теме: место среди других протоколов и оговорки?

AG-UI позиционируется как третий элемент в наборе открытых агентских протоколов. MCP даёт агенту инструменты и контекст, A2A позволяет агентам общаться между собой, а AG-UI связывает агента с пользователем. Один агент может использовать все три сразу, и AG-UI способен стоять перед агентами, которые говорят на MCP или A2A. Отдельно стоят форматы вроде MCP Apps и Open-JSON-UI: они описывают, какой интерфейс агент хочет показать.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ ИИ-агенты на практике · Академия & Nomad

От чтения про ИИ-агентов — к запуску своего агента за вечер

Пошаговая сборка автономных агентов и MCP-связок в Hamidun Academy (academy.hamidun.com) (72 часа бесплатно) или мгновенный запуск готовых мультишаговых агентов в облаке Nomad.

Попробовать Академию (72ч бесплатно) →Запустить Nomad Agent
Что вы думаете?
Загружаем комментарии…