Microsoft Agent Framework
Microsoft Agent Framework (MAF) — открытый многоязычный фреймворк для production-агентов и многоагентных workflow на .NET и Python.
Что это
Microsoft Agent Framework (MAF) — открытый многоязычный фреймворк для production-агентов и многоагентных workflow на .NET и Python.
Возможности
- Поддержка Python и C#/.NET с единым API
- Множество LLM-провайдеров из коробки
- Гибкая система middleware для запросов/ответов и ошибок
Установка
Готовый пример запуска и обязательные переменные окружения смотрите в официальном репозитории.
Что нового в версиях
Обновление требует 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 устарел и игнорируется.
Релиз 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 до 3.11+, миграция индексов Redis и новые функции компакции и асинхронности
- Python 3.11 теперь является поддерживаемой базовой версией; поддержка 3.10 сохранена для установки, но не гарантируется
- RedisContextProvider теперь сохраняет точную идентичность области видимости и отклоняет устаревшую схему индекса; требуется ручная миграция
- Добавлены экспериментальные стратегии компакции и выгрузки навыков, запускаемые агентом (AgentTriggeredCompactionStrategy, UnloadSkillsCompactionStrategy)
- Добавлена поддержка асинхронных условий в группах ребер workflow switch-case
- Добавлены опциональные асинхронные контексты клиентов чата и очистка соединений с учетом владения ресурсами
- Добавлен альфа-клиент встраивания NVIDIA NIM и точка расширения для опций запросов встраивания OpenAI
Добавлен навык .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
Обновление версий пакетов, исправление ошибок в .NET и Python, улучшение работы с MCP, A2A и DevUI.
- .NET: добавлен метод AgentSessionStore.DeleteSessionAsync в абстракцию
- .NET: добавлена поддержка выбора протокола gRPC в примере A2A
- .NET: исправлено сохранение метаданных результатов выражений в workflow
- .NET: добавлен таймаут для поиска по файлам
- .NET: исправлена валидация заголовков вызова MCP
- Python: исправлена передача tool_choice в AnthropicClient при unset tool_choice
Миграция на 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 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.
Обновление .NET-версии фреймворка Microsoft Agent Framework до 1.25.0 с улучшением обработки утверждений, исправлением ошибок и обновлением зависимостей.
- Добавлены соображения по повторному использованию утверждений (approval reuse) в .NET.
- Завершение SSE-стрима чат-завершений теперь осуществляется через data: [DONE].
- В проверки Purview добавлены цитаты и детали ошибок.
- Исправлены остатки рассуждений и проблема с возвратом (bounce-back) при передаче управления (handoff).
- Запросы на утверждение инструментов, не получившие ответа, автоматически отклоняются.
- Поддержка вопросов с закрытым списком в рабочих процессах (closed-list workflow questions).
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.