AIKraft/Агенты/Microsoft Agent Framework

Microsoft Agent Framework

Microsoft Agent Framework (MAF) — открытый многоязычный фреймворк для production-агентов и многоагентных workflow на .NET и Python.

MIMicrosoft Мультиагентный Python ★ 14.7k

Что это

Microsoft Agent Framework (MAF) — открытый многоязычный фреймворк для production-агентов и многоагентных workflow на .NET и Python.

Возможности

  • Поддержка Python и C#/.NET с единым API
  • Множество LLM-провайдеров из коробки
  • Гибкая система middleware для запросов/ответов и ошибок

Установка

1Установить пакет
pip install agent-framework
2Быстрый старт

Готовый пример запуска и обязательные переменные окружения смотрите в официальном репозитории.

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

python-1.25.07 ноября 2026 г.

Обновление требует Python 3.11+, вводит лимиты на обнаружение MCP-инструментов, ужесточает политику безопасности для агентов и сессий, а также обновляет Foundry Local SDK.

  • agent-framework-core, agent-framework-foundry-hosting: добавлена поддержка политик одобрения обнаружения MCP, учитывающих метаданные Foundry Toolbox, фильтры по именам инструментов и режиму чтения, а также явные переопределения вызывающей стороны.
  • agent-framework-core, agent-framework-declarative: [BREAKING] введены лимиты на обнаружение MCP (100 страниц и 1000 элементов), установлено время ожидания запросов по умолчанию 30 секунд, сохранен полный снимок каталога при сбое обновления.
  • agent-framework-core: [BREAKING] приведены в соответствие с OpenTelemetry GenAI соглашениями имена и атрибуты спанов для вызовов графовых и функциональных рабочих процессов (gen_ai.operation.name, gen_ai.workflow.name).
  • agent-framework-declarative: [BREAKING] предотвращено совместное использование состояния MCP между рабочими процессами путем создания нового протокольного сеанса для каждого вызова обработчика; параметр cache_max_size устарел и игнорируется.
dotnet-1.28.06 ноября 2026 г.

Релиз 1.28.0: GA-инструмент Computer в Foundry, обновление A2A до preview4 и ряд критических изменений (BREAKING) в хостинге, CodeAct, GitHub Copilot и декларативных рабочих процессах.

  • Foundry: добавлен GA-инструмент Computer через FoundryAITool.CreateComputerTool() и опция TokenScope для аутентификации в Foundry hosting.
  • A2A hosting: сломана обратная совместимость — встроенная регистрация сервера теперь ограничена ответами на основе сообщений (message-based), поддержка возобновления задач отложена.
  • A2A: сломана обратная совместимость — замена индивидуальных параметров идентификатора на опциональный объект A2AAgentOptions при создании агентов.
  • CodeAct: сломана обратная совместимость — по умолчанию скрыты детали исключений хост-инструментов в Hyperlight и LocalCodeAct (требуется явное включение IncludeDetailedErrors).
  • GitHub Copilot: сломана обратная совместимость — хуки файлов (file hooks) отключены по умолчанию для новых и возобновленных сессий.
  • Declarative workflows: сломана обратная совместимость — требуется явный allowlist хостов/портов и фабрика обработчиков HTTP-запросов вместо прямых HttpClient.
python-1.24.030 октября 2026 г.

Обновление базовой версии Python до 3.11+, миграция индексов Redis и новые функции компакции и асинхронности

  • Python 3.11 теперь является поддерживаемой базовой версией; поддержка 3.10 сохранена для установки, но не гарантируется
  • RedisContextProvider теперь сохраняет точную идентичность области видимости и отклоняет устаревшую схему индекса; требуется ручная миграция
  • Добавлены экспериментальные стратегии компакции и выгрузки навыков, запускаемые агентом (AgentTriggeredCompactionStrategy, UnloadSkillsCompactionStrategy)
  • Добавлена поддержка асинхронных условий в группах ребер workflow switch-case
  • Добавлены опциональные асинхронные контексты клиентов чата и очистка соединений с учетом владения ресурсами
  • Добавлен альфа-клиент встраивания NVIDIA NIM и точка расширения для опций запросов встраивания OpenAI
dotnet-1.27.030 октября 2026 г.

Добавлен навык .NET, обновлены зависимости и нарушена обратная совместимость в AgentServer и обработке редиректов

  • Добавлен .NET consumer skill для создания агентов с использованием Agent Framework
  • Нарушена обратная совместимость: обновлены зависимости AgentServer, требуется замена builder.Services.AddFoundryResponses на builder.AddFoundryResponses и синхронизация версий пакетов Azure.AI.Projects, Azure.AI.Extensions.OpenAI и других
  • Нарушена обратная совместимость: изменено поведение редиректов в DefaultHttpRequestHandler, теперь возврат клиента для редиректа вызывает HttpRequestException
  • Исправлены ошибки в workflow: обработка сбоев конвертации значений, сохранение алиасов и корректное завершение работы при ошибках инициализации
  • Исправлены смещения текста цитирования в Foundry, валидация scopes в Mem0 и применение политики одобрения инструментов в Toolbox
dotnet-1.26.023 октября 2026 г.

Обновление версий пакетов, исправление ошибок в .NET и Python, улучшение работы с MCP, A2A и DevUI.

  • .NET: добавлен метод AgentSessionStore.DeleteSessionAsync в абстракцию
  • .NET: добавлена поддержка выбора протокола gRPC в примере A2A
  • .NET: исправлено сохранение метаданных результатов выражений в workflow
  • .NET: добавлен таймаут для поиска по файлам
  • .NET: исправлена валидация заголовков вызова MCP
  • Python: исправлена передача tool_choice в AnthropicClient при unset tool_choice
python-1.23.022 октября 2026 г.

Миграция на MCP 2.x, поддержка Python 3.15 и новые возможности A2A и AG-UI

  • Добавлена поддержка разрешенного перенаправления аргументов функций и клиента из метаданных запросов A2A в agent-framework-a2a
  • Добавлена опциональная синтетическая реплика пользователя для провайдеров, возвращающих пустой текст после промптов, завершающих ответ ассистента
  • [BREAKING] Добавлена основа совместимости с MCP 2.x и выполнена миграция транспортов, ошибок, схем и обработки жизненного цикла MCP
  • [BREAKING] Для регистрации эндпоинтов теперь требуется явное указание области авторизации AG-UI или декларации single-user
  • [BREAKING] В agent-framework-tools параметр extra_run_args переименован в unsafe_extra_run_args с явными требованиями доверия
  • Добавлена поддержка Python 3.15 для DuckDB, Hyperlight и AG-UI A2UI extra
python-1.22.015 октября 2026 г.

Добавлена поддержка Python 3.15, обновлена совместимость persisted-state и внесены критические изменения в безопасность и семантику протоколов.

  • Добавлена поддержка Python 3.15 для core-пакета и agent-framework (с учетом ограничений зависимостей).
  • [BREAKING] Консолидирована семантика идентичности контента, хостинга, метаданных протокола, воспроизведения и слияния потоков.
  • [BREAKING] В agent-framework-ag-ui enforced fail-closed границы доверия запросов и привязка продолжений к thread ID.
  • [BREAKING] В agent-framework-ag-ui предотвращено перезапись состояния одобрения инструментов через Shared State и Thread Snapshots.
  • [BREAKING] В agent-framework-declarative добавлены лимиты на тела HTTP-ответов и стадии сжатого декодирования.
  • Добавлена конфигурация URL-адресов сервисов для клиентов чата Ollama и OpenAI, а также поддержка пула соединений Oracle.
dotnet-1.25.014 октября 2026 г.

Обновление .NET-версии фреймворка Microsoft Agent Framework до 1.25.0 с улучшением обработки утверждений, исправлением ошибок и обновлением зависимостей.

  • Добавлены соображения по повторному использованию утверждений (approval reuse) в .NET.
  • Завершение SSE-стрима чат-завершений теперь осуществляется через data: [DONE].
  • В проверки Purview добавлены цитаты и детали ошибок.
  • Исправлены остатки рассуждений и проблема с возвратом (bounce-back) при передаче управления (handoff).
  • Запросы на утверждение инструментов, не получившие ответа, автоматически отклоняются.
  • Поддержка вопросов с закрытым списком в рабочих процессах (closed-list workflow questions).

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