Проект AG-UI (Agent-User Interaction Protocol) представляет собой открытый, легковесный, событийно-ориентированный протокол, разработанный для стандартизации подключения агентов искусственного интеллекта (ИИ) к пользовательским приложениям. Его основная цель — обеспечить бесшовную интеграцию между ИИ-агентами, контекстом пользователя в реальном времени и пользовательскими интерфейсами, делая агентов доступными во фронтенд-приложениях. Этот протокол родился из практического опыта и реальных требований при создании взаимодействий агентов внутри приложений, особенно благодаря первоначальному партнерству CopilotKit с LangGraph и CrewAI.
Что такое AG-UI и как он работает?
AG-UI разработан для простоты и гибкости. Во время выполнения агентов, бэкэнды агентов генерируют события, совместимые с одним из примерно 16 стандартных типов событий AG-UI. В свою очередь, бэкэнды агентов могут принимать в качестве аргументов несколько простых совместимых с AG-UI входных данных.
Одной из ключевых особенностей AG-UI является его гибкий слой промежуточного ПО (middleware), который обеспечивает совместимость в различных средах:
- Он работает с любым транспортным механизмом событий, таким как Server-Sent Events (SSE), WebSockets или вебхуки.
- Он допускает свободное сопоставление форматов событий, что обеспечивает широкую совместимость между агентами и приложениями.
- AG-UI также поставляется с эталонной HTTP-реализацией и коннектором по умолчанию, чтобы помочь командам быстро начать работу.
Место AG-UI в стеке агентных протоколов
AG-UI дополняет два других ведущих агентных протокола, занимая свою уникальную нишу:
- MCP предоставляет агентам инструменты.
- A2A позволяет агентам общаться друг с другом.
- AG-UI же привносит агентов в пользовательские приложения.
Таким образом, он фокусируется на взаимодействии между агентом и человеком, обеспечивая связь ИИ-агентов с внешним миром пользовательского интерфейса.
Ключевые особенности и возможности
AG-UI предлагает ряд мощных функций, направленных на улучшение взаимодействия между пользователем и агентом:
- Агентный чат в реальном времени со стримингом.
- Двунаправленная синхронизация состояния.
- Генеративный пользовательский интерфейс (Generative UI) и структурированные сообщения.
- Обогащение контекста в реальном времени.
- Интеграция фронтенд-инструментов.
- Сотрудничество человека в процессе (Human-in-the-loop collaboration).
Поддерживаемые фреймворки и языки
AG-UI активно расширяет свою поддержку для различных фреймворков и SDK на разных языках:
Поддерживаемые фреймворки (Status Supported):
- No-framework
- LangGraph (партнерство)
- CrewAI (партнерство)
- Mastra (собственная поддержка)
- AG2 (собственная поддержка)
- Agno (собственная поддержка)
- LlamaIndex (собственная поддержка)
- Pydantic AI (собственная поддержка)
Фреймворки в процессе разработки (In Progress):
- Vercel AI SDK (сообщество)
- Google ADK (сообщество)
- OpenAI Agent SDK (сообщество)
- AWS Bedrock Agents (собственная поддержка)
Фреймворки, открытые для вклада (Open to Contributions):
- Cloudflare Agents (сообщество)
- Strands Agents SDK (сообщество)
SDK на языках программирования:
- Поддерживаемые (
Supported): Kotlin, Java. - В процессе разработки (
In Progress): .NET, Nim, Golang, Rust.
Начало работы и ресурсы
Для быстрого старта с AG-UI можно создать новое приложение всего за несколько секунд с помощью команды npx create-ag-ui-app my-agent-app. Проект предлагает множество ресурсов для обучения и развития:
- Документация: доступна для углубленного изучения.
- Сообщество Discord: для обсуждений и поддержки.
- AG-UI Dojo: витрина, демонстрирующая множество строительных блоков, поддерживаемых AG-UI. Эти блоки просты и сфокусированы, часто состоят из 50-200 строк кода.
- Видео-демонстрации: например, "Hello World App".
AG-UI — это проект с открытым исходным кодом, лицензированный по лицензии MIT. Сообщество активно участвует в его развитии, о чем свидетельствуют 6,3 тыс. звезд и 565 форков на GitHub, а также 26+12 контрибьюторов. Проект активно развивается, и можно ознакомиться с дорожной картой (Roadmap) или принять участие в еженедельной рабочей группе AG-UI. Основными языками разработки являются TypeScript (75.7%) и Python (19.5%).