Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Служба агента Foundry — это управляемая платформа для создания, развертывания и масштабирования агентов ИИ. Используйте любую платформу, любую поддерживаемую модель из каталога моделей Foundry и API ответов в качестве одной точки входа.
Вы сами выбираете, какая часть платформы вам нужна:
- Агенты запроса — создайте агент запроса на портале Foundry или определите его с помощью пакетов SDK и REST, а Foundry запускает его для вас. Не нужно поддерживать код приложения, не нужно платить за вычислительные ресурсы, а также не нужно оптимизировать, масштабировать или исправлять контейнеры и пакеты.
- Размещённые агенты — пишите код агента с помощью Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK или собственного кода, упакуйте его в контейнер и позвольте Foundry запускать его с управляемой конечной точкой, масштабированием, удостоверениями и наблюдаемостью.
Уже есть код агента, запущенный за пределами Foundry? Вызывайте Responses API из существующего процесса, чтобы использовать модели Foundry и инструменты платформы без переноса кода.
Что такое агент?
Агент — это приложение ИИ, использующее модель из каталога моделей Foundry, чтобы подумать о запросах пользователей и выполнить автономные действия для их выполнения. В отличие от простого чат-бота, который создает текст, агент может вызывать средства, получать доступ к внешним данным и принимать решения на нескольких шагах для выполнения задачи. В некоторых случаях агенты работают без интерфейса чата вообще — работают автономно в фоновом режиме, активируются системными событиями для выполнения задач от имени пользователя или организации.
Каждый агент объединяет три основных компонента:
- Модель: модель из каталога моделей Foundry, которая предоставляет возможности по соображениям и языку.
- Инструкции. Определение целей, ограничений и поведения. В Foundry инструкции могут быть основаны на промптах или представлять собой код в агенте Hosted.
- Средства. Предоставление доступа к данным или действиям, таким как поиск, операции с файлами или вызовы API.
Служба агента на первый взгляд
| Компонент | Что это делает |
|---|---|
| API ответов | Одна точка входа для каждого типа агента. Предоставляет любой платформе, процессу или среде выполнения доступ к моделям Foundry и средствам платформы (поиск файлов, интерпретатор кода, память, веб-поиск, серверы MCP). |
| Среда выполнения агента | Размещает и масштабирует prompt-агенты и размещаемые агенты. Управляет беседами, вызовами инструментов и жизненным циклом агента. |
| Инструменты | Встроенные средства, включая веб-поиск, поиск файлов, память, интерпретатор кода, серверы MCP и пользовательские функции. Управляемая аутентификация включает учетные данные, управляемые службой, и On-Behalf-Of (OBO). |
| Модели | Работает с множеством моделей из каталога моделей Foundry, таких как GPT-4o, Llama и DeepSeek. Переключение моделей без изменения кода агента. |
| Наблюдаемость | Сквозная трассировка, метрики и интеграция с Application Insights. Просмотрите каждое решение, принятое агентом. |
| Идентификация и безопасность | Microsoft Entra идентификация, RBAC, фильтры содержимого и изоляция виртуальной сети. Доверие корпоративного уровня, встроенное в систему. |
| Публикации | Агенты версий, создавайте стабильные конечные точки и осуществляйте совместное использование через Microsoft Teams, Microsoft 365 Copilot и реестр агентов Entra. |
Начало работы с агентами
Выберите путь на основе того, что вы пытаетесь сделать:
- Новые агенты?Начните с агента запроса — создайте агент на портале Foundry, выберите модель, вложите средства, а затем вызовите его из кода. Код среды выполнения не нужно писать или поддерживать — Foundry запускает агента за вас.
- Хотите создать агент на основе кода в Foundry?Разверните размещенный агент — напишите свой агент с помощью Agent Framework, LangGraph, пакета SDK openAI Agent или собственного кода, упаковайте его в виде контейнера и позвольте Foundry запустить его с управляемой конечной точкой, масштабированием и удостоверением.
- Хотите использовать модели и инструменты Foundry из кода агента, который уже запущен в другом месте?ВызовИТЕ API ответов из существующего процесса, чтобы получить модели и средства платформы Foundry без перемещения кода.
Типы агентов
В службе агента есть два основных типа агента:
- Агенты запроса — автор на портале или коде, полностью управляемая среда выполнения.
- Размещаемые агенты (предварительная версия) — код вашего агента, выполняемый Foundry.
Побудительные агенты
Агенты запросов полностью определяются с помощью конфигурации — инструкций, выбора модели и инструментов. Вы создаете их на портале Foundry для быстрого запуска или программно определяете их с помощью пакетов SDK или REST API для интеграции с рабочими процессами CI/CD. В любом случае Foundry запускает агент за вас — вам не нужно поддерживать код приложения, платить за вычислительные ресурсы, а также оптимизировать, масштабировать контейнеры или пакеты и контролировать их с точки зрения безопасности.
Два пути для начала работы:
- Сначала через портал — интерактивно создайте агент в портале Foundry, протестируйте его в песочнице, а затем вызывайте его из кода приложения.
- Сначала код — опишите агента с помощью SDK или REST API в рамках конвейера развертывания, что обеспечивает контроль версий, проверку кода и автоматическое развертывание.
Лучше всего подходит: для быстрого старта, внутренних инструментов, продакшен-агентов, которым не нужна пользовательская логика оркестрации, и команд, которым нужна управляемая среда выполнения без лишних затрат на инфраструктуру.
Размещенные агенты (предварительная версия)
Размещенные агенты — это агенты на основе кода, которые вы создаете с помощью Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK или собственного кода. Разверните агент либо как образ контейнера, либо как ZIP-архив с исходным кодом — если вы предоставляете ZIP-архив, Foundry создаст образ за вас — и Foundry запустит его с управляемым конечным узлом, автоматическим масштабированием, выделенной идентичностью Microsoft Entra, сохранением состояния на уровне сеанса и сквозной наблюдаемостью.
Код агента вызывает api Responses API в конечной точке проекта Foundry для вывода модели и оркестрации инструментов, которая предоставляет доступ к моделям Foundry из каталога и единому набору средств платформы — стандартным инструментам OpenAI, таким как поиск файлов, интерпретатор кода и веб-поиск, а также эксклюзивные инструменты Foundry, такие как SharePoint, WorkIQ и Fabric IQ.
Примечание
Размещенные агенты в настоящее время находятся в общедоступной предварительной версии.
Лучше всего подходит для: агентов, которые обращаются к вашему собственному коду; а также для собственной логики оркестрации, многоагентных систем и пользовательских протоколов (вебхуков, голосовых интерфейсов, AG-UI), в случаях, когда вам нужен полный контроль над логикой агента, а Foundry при этом берёт на себя хостинг, масштабирование и идентификацию.
Если вы предпочитаете запускать код агента за пределами Foundry , например, внедренного в существующее приложение, вы по-прежнему можете получить модели и средства платформы Foundry, вызвав API ответов непосредственно из процесса. См. Использование Responses API в собственном коде.
Сравнение типов агентов
| Побудительные агенты | Размещенные агенты (предварительная версия) | |
|---|---|---|
| Область редактирования | Портал, пакет SDK или REST | агентный фреймворк, LangGraph, SDK OpenAI Agents, SDK Anthropic Agent, SDK GitHub Copilot, собственный код |
| Модели Foundry + средства платформы | Да | Да (через API ответов в конечной точке проекта Foundry) |
| Поддержка навыков | Да | Да |
| Код среды выполнения для поддержки | Нет | Да — логика агента |
| Вычисление для управления | Нет — полностью управляется | Контейнерные вычислительные ресурсы под управлением Foundry |
| Управляемая конечная точка | Да | Да |
| Autoscale | Автоматически, под управлением Foundry; масштабируется в зависимости от объёма запросов | Автоматическое, под управлением Foundry; масштабирует экземпляры контейнеров в зависимости от числа сеансов и объема запросов |
| Удостоверение агента (Entra) | Да | Автоматический, отдельный для каждого агента |
| Модель затрат | Вывод по каждому вызову + использование инструмента | Инференс на каждый вызов + использование инструментов + контейнерные вычисления |
| Оптимально для | Быстрый старт, агенты промышленного уровня без специальной оркестрации | Агенты, вызывающие пользовательский код; во вторую очередь — настраиваемая логика оркестрации |
Используйте API Responses в собственном коде
API ответов — это отдельная модель и конечная точка инструментов для каждого типа агента. Его можно вызвать непосредственно из собственного кода, чтобы получить модели и инструменты платформы Foundry, не создавая ресурс агента в Foundry. Этот шаблон дополняет размещаемых агентов, а не заменяет их: один и тот же код Agent Framework уже сегодня может вызывать Responses API из вашего собственного процесса, а позже, когда вам потребуется эндпоинт под управлением Foundry, быть упакован в контейнер и развернут как размещаемый агент.
См. Краткое руководство: использование API Responses с описанием параметров конечной точки и сквозными примерами.
Поддержка модели
Служба агента работает с множеством моделей, доступных в каталоге моделей Foundry. Полный список см. в разделе "Квоты", "Ограничения" и "Региональная поддержка".
Инструменты
Служба агента предоставляет встроенные средства и поддерживает пользовательские средства, чтобы агенты могли выполнять действия и получать доступ к данным. Полный список см. в каталоге инструментов Foundry. Дополнительные шаблоны выбора инструментов см. в рекомендациях по инструменту.
Foundry поддерживает удаленные серверы MCP, которые можно добавить из каталога "Добавить инструменты " на портале Foundry. Например, Azure DevOps MCP Server (общедоступная предварительная версия) можно добавить непосредственно из каталога. Подключите организацию Azure DevOps для предоставления доступа агентам и настройте подмножество доступных инструментов для управления тем, какие действия могут выполнять агенты. Вы также можете подключить пользовательские серверы MCP, размещенные на Функции Azure, через конечную точку вебхука функций MCP (/runtime/webhooks/mcp) для предоставления пользовательских инструментов вашим агентам.
Поддерживаемые параметры проверки подлинности для серверов MCP и других подключений к инструментам включают:
- Доступ на основе ключей
- Microsoft Entra (используя управляемое удостоверение агента или управляемое удостоверение проекта)
- Сквозная аутентификация OAuth (от имени)
- Доступ без проверки подлинности, если это необходимо
Панель элементов (предварительная версия)
Панель элементов позволяет определить управляемый набор инструментов один раз, централизованно управлять ими в Foundry и предоставлять их через одну конечную точку, совместимую с MCP. Любая среда выполнения агента, совместимая с MCP или клиентом, может использовать панель элементов независимо от используемой платформы. Управление версиями панели инструментов дает вам явный контроль над тем, когда изменения вступят в силу: создайте новую версию, протестируйте её и установите по умолчанию, когда будете готовы.
Примечание
Некоторые средства, включая память и веб-поиск, находятся в предварительной версии. Сведения о доступности по регионам и состоянию предварительной версии см. в разделе поддержки инструментов по регионам и моделям.
Жизненный цикл разработки
Агентская служба поддерживает полный рабочий процесс «сборка-тестирование-развертывание-мониторинг»:
- Создайте — определите промпт-агент в портале или с помощью SDK либо напишите Hosted-агент, который вызывает Responses API.
- Тест — пообщайтесь с агентом на платформе для агентов или запустите локально. Интеграции серверов MCP, включая пользовательские серверы MCP, размещённые в Функции Azure, можно тестировать непосредственно в песочнице, чтобы проверять подключение инструментов, разрешения и поведение перед публикацией.
- Трассировка — проверка каждого вызова модели, вызова инструмента и принятия решений с помощью трассировки агентов.
- Оценка — выполнение вычислений для измерения качества и перехвата регрессий.
- Оптимизация — автоматическое улучшение инструкций размещенного агента с помощью оптимизатора агента.
- Публикация — повышение уровня агента к управляемому ресурсу с стабильной конечной точкой.
- Мониторинг — отслеживание производительности и надежности с помощью метрик служб и панелей мониторинга.
Подробное пошаговое руководство см. в разделе "Жизненный цикл разработки агента".
Корпоративные возможности
Служба агента предоставляет инфраструктуру корпоративного уровня для каждого развернутого агента:
- Идентификация агента— каждый агент может иметь выделенную идентификацию Microsoft Entra, обеспечивая безопасный, ограниченный доступ к ресурсам и API без передачи учетных данных. Удостоверения агентов могут проверяться на подлинность на внешних серверах MCP, включая размещенные на Функции Azure, и сквозное прохождение OAuth On-Behalf-Of (OBO) поддерживается при соответствующей настройке.
- Private network — запуск агентов в виртуальной сети Azure для полной сетевой изоляции и соответствия требованиям к месту расположения данных. Для агентов промптов доступна частная сеть. Размещённые агенты поддерживают использование ваших собственных виртуальных сетей Azure (BYO VNet), где каждый сеанс работает в изолированной песочнице ВМ, подключенной к вашей виртуальной сети.
- Ролевое управление доступом — точные разрешения с помощью Microsoft Entra и Azure RBAC. Контролируйте, кто может создавать, вызывать и управлять агентами.
- Безопасность содержимого — интегрированные фильтры содержимого помогают снизить риски внедрения запросов (включая внедрение перекрестных запросов) и предотвращать небезопасные выходные данные.
Инструкции по настройке среды см. в разделе "Настройка среды".
Публикация и совместное использование
Служба агента обеспечивает встроенное управление версиями и публикацию, чтобы агенты могли переходить от разработки в эксплуатацию с уверенностью.
- Управление версиями — при итерации в агенте версии автоматически создаются моментальные снимки. Откат до любой предыдущей версии или сравнение изменений между версиями.
- Публикация — перевод агента на управляемый ресурс со стабильной конечной точкой. Опубликованные агенты наследуют корпоративные удостоверения и элементы управления доступом , настроенные для проекта, и могут вызываться программным способом.
- Distribution — распространение опубликованных агентов через Microsoft 365 Copilot и Teams и реестр агентов Entra, помещая агентов туда, где пользователи уже работают. Служба агента Foundry поддерживает протоколы OpenResponses и Activity Protocols для публикации Microsoft 365, протокол вызовов для интеграции гибких конечных точек с пользовательскими приложениями и службами, а также протокол A2A (предварительная версия) для обмена данными между агентами.
Безопасность, конфиденциальность и соответствие требованиям
Служба агента предназначена для корпоративных рабочих нагрузок, где требуются надежные средства управления удостоверениями, сетями, обработкой данных и безопасностью.
- Средства управления безопасностью: используйте интегрированные средства защиты, чтобы снизить небезопасные выходные данные и снизить риски внедрения запросов, включая атаки на внедрение кросс-запроса (XPIA).
- Управление изоляцией сети и размещением данных: используйте виртуальные сети и собственные ресурсы для удовлетворения ваших требований.
- Используйте свои ресурсы: Применяйте свои собственные ресурсы Azure (например, хранилище, Поиск с использованием ИИ Azure и Azure Cosmos DB для состояния беседы), чтобы соответствовать требованиям к соблюдению и эксплуатационным нуждам. См. раздел "Использование собственных ресурсов".
- Руководство по использованию ИИ. Более широкий набор рекомендаций и ресурсов управления см. в статье Ответственное ИИ для Microsoft Foundry.
Связанное содержимое
- Настройка среды
- Жизненный цикл разработки агента
- Разверните своего первого размещенного агента
- Каталог инструментов
- Квоты, ограничения и региональная поддержка
- Чтобы помочь или подключиться к сообществу, присоединитесь к Microsoft AI Discord.