AG2

AG2 — open-source фреймворк для разработки AI-агентов и организации их взаимодействия: разные LLM, инструменты, автономные и human-in-the-loop workflow.

AGag2ai Фреймворк агентов ★ 5.1k

Что это

AG2 — open-source фреймворк для разработки AI-агентов и организации их взаимодействия: разные LLM, инструменты, автономные и human-in-the-loop workflow.

Установка

1Установить пакет
pip install ag2
2Быстрый старт
import asyncio from ag2 import Agent from ag2.config import OpenAIConfig agent = Agent( "assistant", prompt="You are a helpful assistant.", config=OpenAIConfig(model="gpt-4o-mini"), ) async def main() -> None: reply = await agent.ask("Summarize the main differences between Python lists and tuples.") print(reply.body) asyncio.run(main())

Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.

Что нового в версиях

v1.3.215 ноября 2026 г.Ломает совместимость

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-валидация для предотвращения потери медиаданных.
v.1.3.110 ноября 2026 г.Ломает совместимость

Добавлены песочницы 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 и рекурсивном поиске файлов.
v1.3.04 ноября 2026 г.Ломает совместимость

AG2 1.3: наблюдение за деревом делегирования, явные области видимости переменных, динамический контекст моделей и общий жизненный цикл задач.

  • НовоеРодительские агенты теперь получают события от всех потомков, включая потоковые чанки, через ChildEvent.
  • НовоеВведены явные области видимости переменных (ScopedValue): COPIED, LOCAL и SHARED для управления состоянием при делегировании.
  • УстарелоУстарели TaskConfig, Agent(tasks=...), Agent(assembly=...) и Agent(knowledge=...); требуется миграция на новые API.
  • Ломает совместимостьТребование Python 3.11 или новее; поддержка Python 3.10 прекращена.
  • НовоеOpenAIConfig становится алиасом для OpenAIResponsesConfig; рекомендуется использовать явные конфигурации моделей.
v1.2.227 октября 2026 г.

Поддержка 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 и других багов.
v1.2.121 октября 2026 г.Ломает совместимость

Добавлена голосовая поддержка Mistral, новые инструменты поиска и улучшена работа с мультимодальными данными.

  • НовоеДобавлены офлайн- и realtime-транскрибаторы и синтез речи Mistral для ag2.live.
  • НовоеПоявились инструменты поиска FirecrawlToolkit и KeenableSearchToolkit.
  • НовоеTypeSafe теперь поддерживает поиск объектов на изображениях через BoundingBox.
  • НовоеOpenAIResponsesConfig получил опцию reasoning для управления усилиями модели.
  • Ломает совместимостьВ ACP и сетевом слое мультимодальные части больше не объединяются в строку.
  • Ломает совместимостьMistral теперь использует httpx2, что требует обновления зависимостей.
v1.2.011 октября 2026 г.Ломает совместимость

Релиз 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.23 октября 2026 г.Ломает совместимость

Релиз v1.1.2: исправление уязвимости в SandboxShellTool, запуск AG-UI 1.0 и поддержка плагинов на уровне вызова.

  • Ломает совместимостьЗапуск AG-UI 1.0 с потенциально ломающими изменениями в интерфейсе.
  • ИсправленоУстранена критическая уязвимость обхода фильтра команд в SandboxShellTool / ShellAdapter.
  • НовоеДобавлена поддержка плагинов, привязанных к конкретному вызову агента.
  • ИсправленоИсправлены ошибки в провайдерах, режиме live и MCP, а также улучшена валидация локальных навыков.
v1.1.129 сентября 2026 г.Ломает совместимость

Переход Bedrock на aiobotocore, изоляция shell-команд без оболочки и устранение коллизий инструментов.

  • Ломает совместимостьBedrockConfig теперь требует aiobotocore вместо boto3; синхронные сессии больше не поддерживаются.
  • Ломает совместимостьRestricted shell mode выполняет команды напрямую через argv, исключая использование shell-синтаксиса.
  • Ломает совместимостьИнструменты с одинаковыми именами теперь разрешаются в единственном экземпляре.
  • НовоеДобавлена поддержка запроса человеческого ввода через AG-UI во время выполнения агента.
  • ИсправленоИсправлено сохранение сессий MCP во время длительных ходов и унифицирован заголовок Authorization.

Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.