ag-ui-protocol/ag-ui
ПРОТОКОЛ ВЗАИМОДЕЙСТВИЯ АГЕНТА И ПОЛЬЗОВАТЕЛЯ AG-UI
Открытый событийный протокол для подключения AI-агентов к фронтенд-приложениям. Стандартизирует двунаправленный поток типизированных событий между агентом и любым клиентом.
// КЛЮЧЕВЫЕ ОСОБЕННОСТИ
- Двунаправленный поток типизированных событий между агентом и клиентом
- SDK для TypeScript, Python и .NET, генерируемые из JSON Schema
- Один агент работает с вебом, мобильными приложениями, терминалом и Slack
- CLI create-ag-ui-app создаёт проект на Next.js или терминальный клиент
// РАЗБОР: КАК ЭТО РАБОТАЕТ
AG-UI определяет единый протокол взаимодействия: агент принимает RunAgentInput и возвращает поток событий (RunStarted, TextMessageContent, ToolCall, RunFinished и др.). Транспорт — HTTP с Server-Sent Events или WebSocket; кодировка событий описана в JSON Schema, из которой генерируются SDK для TypeScript, Python и .NET. Это устраняет необходимость писать адаптеры под каждый фреймворк агента.
В отличие от MCP (инструменты и контекст) и A2A (агент-агент), AG-UI фокусируется исключительно на границе агент–пользователь. Протокол версии 1.0 заморожен, обратно совместим с 0.x и покрыт миграционным руководством. Экосистема включает готовые интеграции с CopilotKit, LangGraph, CrewAI, Mastra, PydanticAI и другими.
Для запуска нужен Node.js 20+ или Python 3.9+. CLI `create-ag-ui-app` скаффолдит Next.js-приложение с CopilotKit или терминальный клиент, сразу подключённый к выбранному фреймворку. Ключи API (например, OpenAI) задаются через переменные окружения. Никаких специфических требований к железу или ОС в README не указано.
// СЦЕНАРИИ ИСПОЛЬЗОВАНИЯ
Кому пригодится: Разработчикам фронтенда и бэкенда, интегрирующим AI-агентов в приложения
- Подключить одного агента к веб-интерфейсу, мобильному приложению и терминалу одновременно
- Заменить кастомные WebSocket-адаптеры на стандартный событийный протокол
- Быстро прототипировать чат-интерфейс через CLI и сменить фреймворк агента без правок фронтенда
// БЫСТРЫЙ СТАРТ
npx create-ag-ui-app@latest
export OPENAI_API_KEY="sk-..."
npm run dev
pip install ag-ui-protocol fastapi uvicorn
uvicorn server:app --port 8000Команды взяты из README репозитория — перед запуском сверьтесь с актуальной версией на GitHub.
Новые репозитории каждые 30 минут
REDDYX AI сканирует GitHub 24/7 и присылает лучшие AI/ML/Web3 проекты в Telegram.
Подписаться в Telegram