AG-UI 1.0 даёт ИИ-агентам единый язык для связи с приложением: 31 тип событий
Каждый агентский фреймворк по-своему сообщает приложению, что агент печатает, вызвал инструмент или ждёт подтверждения человека. Протокол AG-UI 1.0 заменяет эту самописную обвязку общим потоком событий вроде «начал печатать» или «вызвал инструмент». Всего таких типов 31, они сгруппированы в восемь семейств. Поэтому один агент работает в вебе, мобильном приложении или Slack без переписывания интерфейса.
AI-обработка оригинала GitHub Trending AI; редакция Hamidun News
Представьте, что вы встраиваете ИИ-агента в чат внутри своего продукта. Агент печатает ответ по словам, посреди ответа вызывает инструмент, например поиск по базе, а потом ждёт, пока пользователь нажмёт «Подтвердить». Каждый агентский фреймворк сообщает обо всём этом приложению в своём формате, и фронтендеру приходится писать отдельную обвязку под каждый бэкенд. Протокол 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, который обычно приходится поддерживать самим.
- 21 нояб. 2026 г.Вакансий FDE за год стало в 4,6 раза больше: что делает инженер у заказчика
- 21 нояб. 2026 г.Капитан пловцов отдала ChatGPT три задачи по расписанию и сократила рутину в разы
- 21 нояб. 2026 г.OpenAI GPT-6 Cyber нашла около 35 дыр в iPhone, Mac и другой технике Apple
- 21 нояб. 2026 г.22 агента Claude шесть недель искали ответы по чёрным дырам — и решили две задачи
Вопросы и ответы по материалу
Что известно по теме: как это устроено?
Между агентом и приложением идёт один двунаправленный поток событий. Приложение запускает «прогон» (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: они описывают, какой интерфейс агент хочет показать.
От чтения про ИИ-агентов — к запуску своего агента за вечер
Пошаговая сборка автономных агентов и MCP-связок в Hamidun Academy (academy.hamidun.com) (72 часа бесплатно) или мгновенный запуск готовых мультишаговых агентов в облаке Nomad.
Главное из мира ИИ — раз в неделю
7 ключевых событий недели, отобранных вручную. Без шума, репостов и пресс-релизов.
Готово! Проверьте почту — мы отправили подтверждение.