AG2
AG2 — open-source фреймворк для разработки AI-агентов и организации их взаимодействия: разные LLM, инструменты, автономные и human-in-the-loop workflow.
Что это
AG2 — open-source фреймворк для разработки AI-агентов и организации их взаимодействия: разные LLM, инструменты, автономные и human-in-the-loop workflow.
Установка
Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.
Что нового в версиях
AG2 v1.3.2: мультизапросы, унификация токенов, ACP 1.0 и Python 3.15 с ломающими изменениями.
- НовоеОтправка нескольких вопросов в одном запросе через flat-схему (dataclass, TypedDict, Pydantic) для экономии токенов.
- ИсправленоУнифицирована логика подсчета токенов: prompt_tokens теперь включает кэш, а total_tokens строго >= prompt_tokens + completion_tokens.
- Ломает совместимостьACP 1.0: требование agent-client-protocol>=1.0.0, разделение сообщений, исправление закрытия сессий и абсолютные пути.
- НовоеОфициальная поддержка и тестирование Python 3.15 (требует C-компилятор для сборки PyYAML).
- НовоеAG-UI: гайд по assistant-ui и строгая Base64-валидация для предотвращения потери медиаданных.
Добавлены песочницы E2B и boxd, обновлён A2UI до v1.0, улучшена телеметрия кэша и исправлены ошибки Gemini/OpenAI.
- НовоеПоявились новые бэкенды для SandboxShellTool и SandboxCodeTool: E2BEnvironment и boxd Linux microVMs.
- Ломает совместимостьA2UI v1.0 теперь использует стабильный спецификацию: изменён формат версии и добавлены строгие проверки каталогов.
- НовоеУлучшена работа MCP Apps с браузерами: исправлен CORS, добавлена валидация ошибок и поддержка upstream ext-apps SDK.
- НовоеДетализирована телеметрия создания кэша: поле Usage.cache_creation_extended_input_tokens разделяет цены OpenAI и Anthropic.
- ИсправленоИсправлены ошибки в ответе AG-UI, потоковой передаче tool calls в OpenAI, работе Gemini 3 и рекурсивном поиске файлов.
AG2 1.3: наблюдение за деревом делегирования, явные области видимости переменных, динамический контекст моделей и общий жизненный цикл задач.
- НовоеРодительские агенты теперь получают события от всех потомков, включая потоковые чанки, через ChildEvent.
- НовоеВведены явные области видимости переменных (ScopedValue): COPIED, LOCAL и SHARED для управления состоянием при делегировании.
- УстарелоУстарели TaskConfig, Agent(tasks=...), Agent(assembly=...) и Agent(knowledge=...); требуется миграция на новые API.
- Ломает совместимостьТребование Python 3.11 или новее; поддержка Python 3.10 прекращена.
- НовоеOpenAIConfig становится алиасом для OpenAIResponsesConfig; рекомендуется использовать явные конфигурации моделей.
Поддержка Anthropic SDK 2.x, таймауты для инструментов, точный подсчёт токенов и депрекация OpenAIConfig.
- УстарелоOpenAIConfig помечен как устаревший; для Chat Completions используйте OpenAICompletionsConfig, для Responses API — OpenAIResponsesConfig.
- НовоеДобавлена поддержка Anthropic SDK 2.x с новыми опциями speed и open_telemetry.
- НовоеВнедрены таймауты для вызовов инструментов (@tool) и колбэков, возвращающие TimeoutError при превышении времени.
- НовоеУлучшена точность подсчёта токенов: теперь учитываются continuation, thinking, reasoning токены и cache_write_tokens.
- ИсправленоИсправлены ошибки стриминга Mistral, обработки пустых артефактов A2A, файлов SKILL.md с BOM и других багов.
Добавлена голосовая поддержка Mistral, новые инструменты поиска и улучшена работа с мультимодальными данными.
- НовоеДобавлены офлайн- и realtime-транскрибаторы и синтез речи Mistral для ag2.live.
- НовоеПоявились инструменты поиска FirecrawlToolkit и KeenableSearchToolkit.
- НовоеTypeSafe теперь поддерживает поиск объектов на изображениях через BoundingBox.
- НовоеOpenAIResponsesConfig получил опцию reasoning для управления усилиями модели.
- Ломает совместимостьВ ACP и сетевом слое мультимодальные части больше не объединяются в строку.
- Ломает совместимостьMistral теперь использует httpx2, что требует обновления зависимостей.
Релиз v1.2.0: поддержка OpenAI Decisions API, масштабирование A2A-серверов и изменение композиции тулкитов.
- Ломает совместимостьИзменена логика композиции тулкитов: инструменты из правой части больше не наследуют middleware левой, требуется явная настройка.
- НовоеДобавлена поддержка OpenAI Decisions API с конфигурацией OpenAIDecisionsConfig и общей схемой через маркер Question.
- НовоеA2A-серверы теперь могут работать на нескольких репликах, поддерживают кэширование карточек агентов и валидацию URL push-уведомлений.
- НовоеВ Ollama добавлена поддержка API-ключей, пользовательских HTTP-клиентов и имен инструментов; исправлены дубликаты ID потоковых вызовов.
- НовоеAnthropic: добавлена диагностика кэширования; OpenAI Voice: возможность явного указания API-ключей.
- ИсправленоИсправлены ошибки в MCP, хранилищах знаний, загрузке тестовых наборов, навыках, A2UI и графах переходов.
Релиз v1.1.2: исправление уязвимости в SandboxShellTool, запуск AG-UI 1.0 и поддержка плагинов на уровне вызова.
- Ломает совместимостьЗапуск AG-UI 1.0 с потенциально ломающими изменениями в интерфейсе.
- ИсправленоУстранена критическая уязвимость обхода фильтра команд в SandboxShellTool / ShellAdapter.
- НовоеДобавлена поддержка плагинов, привязанных к конкретному вызову агента.
- ИсправленоИсправлены ошибки в провайдерах, режиме live и MCP, а также улучшена валидация локальных навыков.
Переход Bedrock на aiobotocore, изоляция shell-команд без оболочки и устранение коллизий инструментов.
- Ломает совместимостьBedrockConfig теперь требует aiobotocore вместо boto3; синхронные сессии больше не поддерживаются.
- Ломает совместимостьRestricted shell mode выполняет команды напрямую через argv, исключая использование shell-синтаксиса.
- Ломает совместимостьИнструменты с одинаковыми именами теперь разрешаются в единственном экземпляре.
- НовоеДобавлена поддержка запроса человеческого ввода через AG-UI во время выполнения агента.
- ИсправленоИсправлено сохранение сессий MCP во время длительных ходов и унифицирован заголовок Authorization.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.