Технические модули

AG-UI: единый событийный контракт между агентом и интерфейсом

AG-UI — открытый событийный протокол соединения AI-агентов с пользовательскими приложениями, со SDK и адаптерами фреймворков.

15.10.2026·26 источников·По описаниям проекта ↗

Концептуальная иллюстрация к обзору: AG-UI: единый событийный контракт между агентом и интерфейсом — Концептуальная иллюстрация · создана с помощью ИИ

КЛЮЧЕВЫЕ СВЕДЕНИЯ

Паспорт проекта

По первоисточникам

Тип: Технические модули
Задача: Дать общий интерфейс взаимодействия агентного backend и пользовательского приложения вместо отдельных несовместимых контрактов.
Для кого: Разработчики пользовательских приложений, агентных серверов и фреймворк-интеграций; Python SDK прямо адресован разработчикам совместимых серверов.
Технологии: Python / TypeScript / API / SDK / JSON
Что потребуется: Нужны совместимые сервер/клиент и согласованная версия протокола; требования зависят от SDK/adapter.
Основание: 26 первоисточников

СУТЬ

За 30 секунд

01 / Зачем

Дать общий интерфейс взаимодействия агентного backend и пользовательского приложения вместо отдельных несовместимых контрактов.

02 / Как

Стандартизует streaming chat, обмен состоянием, структурированные сообщения/генеративный UI, контекст, frontend-инструменты и участие человека в исполнении.

03 / Результат

События жизненного цикла, текст/вызовы инструментов и снимки состояния; например ADK-JS выдаёт RUN_STARTED и один RUN_FINISHED либо RUN_ERROR. Результат зависит от выбранной интеграции.

ПОСЛЕДОВАТЕЛЬНОСТЬ

Как это работает

На входе

API

В документированном примере TypeScript ADK HTTP-клиента метод run принимает полный RunAgentInput и возвращает Observable. Альтернативный runAgent управляет threadId/messages/state, принимает runId/tools/context/forwardedProps/resume и возвращает Promise с RunAgentResult. Это API конкретного клиента, не универсальные методы протокола.

Механизм

Результат

ПОДРОБНОСТИ

Что важно понять

Техническое устройство

Контракт описан JSON Schema; SDK генерируются из замороженного 1.0; 1.1 остаётся draft. Строгая same-version схема закрывает объекты, а runtime-граница пропускает неизвестные поля с удалением/предупреждением. Адаптеры переводят события фреймворков в события AG-UI; ADK изменения состояния выдаёт RFC6902 patches.

Для чего создано

Для кого

Разработчики пользовательских приложений, агентных серверов и фреймворк-интеграций; Python SDK прямо адресован разработчикам совместимых серверов.

Сценарии использования

Streaming chat и frontend-tools; пример Langroid включает совместный редактор рецепта с синхронизацией состояния. Это demo, не подтверждённое клиентское внедрение.

Идея решения

Разделить протокол agent→UI и конкретный транспорт/фреймворк; общий контракт и межъязыковые fixtures удерживают одинаковый wire-format у SDK.

Какую задачу описывает источник

Документация фиксирует расхождение сериализации: Python/.NET отдавали null вместо отсутствующего поля, что потребовало трёх tolerant-receiver исправлений. Общие fixtures предотвращают такой дрейф контрактов.

ГОТОВНОСТЬ К ПРОВЕРКЕ

Что известно из описания

Полнота описанияЗапуск не проверялся

МеханизмОписано

ТребованияОписано

ОграниченияОписано

Что потребуется

Нужны совместимые сервер/клиент и согласованная версия протокола; требования зависят от SDK/adapter.
ADK-JS отдельно server-only, Node 20.19+, Google ADK 2.x и AG-UI 1.x; это не универсальные требования AG-UI.

Что учитывать

Схема проверяет структуру одного события, но не порядок/жизненный цикл и применимость patch.
A2A-интеграция experimental; старые клиенты отвергают новые attributed subagent events.
Поддержка frontend/HITL и мультимодальности различается по adapter.

СМОТРИМ ГЛУБЖЕ

Комментарий NeoBridge

Общая справка

SDK и адаптер — SDK — набор средств для разработчика; адаптер переводит контракт одной системы в контракт другой.
Поток событий и снимок состояния — События передают изменения по мере появления; снимок описывает состояние целиком на определённый момент.
JSON Schema и fixture — Схема задаёт форму данных; fixture — закреплённый пример для повторяемой проверки.
Frontend, backend и HITL — Пользовательская часть, серверная часть и участие человека в процессе соответственно.
Patch и SSE — Patch — набор точечных изменений данных; SSE — поток событий от сервера к клиенту.
API — Правила, по которым программы обращаются друг к другу: например, запрашивают данные или передают команду.

Что стоит уточнить

Какие версии клиента и адаптера соединяются: 1.0 или экспериментальный контракт 1.1? Нужно проверить совпадение схем и поддержку событий.
Какие pause/resume и frontend-возможности реально проверены у выбранного адаптера? Общая таблица поддержки не заменяет проверку конкретного маршрута.
Как ограничены host-инструменты, доступ к данным и процессы разных пользователей? Протокол не заменяет изоляцию среды и настройки развёртывания.

Основания и справочные материалы

API ↗

↗

ОСНОВАНИЯ

Из первоисточников

26 ссылок

Редакционный обзор NeoBridge Insight по материалам источников ниже. Права на исходные тексты, код и изображения принадлежат их правообладателям. Условия использования указаны в первоисточниках.

Независимое тестирование проекта не проводилось.

github.com

← Вернуться к проектам Продолжить исследование ↗