Настройка среды

В этой статье вы развертываете инфраструктуру, необходимую для создания агентов с использованием службы Foundry Agent Service. После завершения этой настройки можно создать и настроить агенты с помощью выбранного пакета SDK или портала Foundry.

Создание первого агента — это двухэтапный процесс:

1. Настройте среду агента (в этой статье).
2. Создайте и настройте агент.

Необходимые разрешения

Действие	Требуемая роль
Создание учетной записи и проекта	Владелец учетной записи Foundry
стандартная настройка Только: назначение RBAC для необходимых ресурсов (Cosmos DB, поиск, хранилище и т. д.)	Администратор управления доступом на основе ролей
Создание и изменение агентов	Пользователь Foundry
Взаимодействуйте с эндпоинтами агента (без создания или редактирования агентов)	Клиент агента Foundry

Важно

Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.

Примечание

Для размещаемых агентов требуются дополнительные разрешения и настройки RBAC. См. справочник по разрешениям для размещенного агента для получения подробной информации.

Настройка среды агента

Чтобы приступить к работе, вам потребуется Microsoft ресурс Foundry и проект Foundry.
Агенты создаются в определенном проекте, и каждый проект выступает в качестве изолированной рабочей области. Это означает:

• Все агенты в одном проекте совместно используют доступ к одному хранилищу файлов, хранилищу потоков (журналу бесед) и индексам поиска.
• Данные изолированы между проектами. Агенты в одном проекте не могут получить доступ к ресурсам из другого. Проекты в настоящее время являются единицей общего доступа и изоляции на платформе Foundry. Дополнительные сведения о проектах Foundry см. в статье Microsoft Foundry.

Необходимые условия

• Подписка Azure: Создайте бесплатно.
• Убедитесь, что пользователь, создающий учетную запись и проект, имеет роль владельца учетной записи Foundry в области подписки.
• При настройке стандартной установки то же лицо также должно иметь разрешения на назначение ролей необходимым ресурсам (Cosmos DB, Поиск с использованием ИИ Azure, Хранилище BLOB-объектов Azure). Дополнительные сведения о ролях RBAC, относящихся к службе агента, см. ролях RBAC службы агента.
  • Необходима встроенная роль — администратор доступа на основе ролей.
  • Кроме того, роль владельца на уровне подписки также удовлетворяет этому требованию.
  • Основное разрешение, которое требуется: Microsoft.Authorization/roleAssignments/write

Выбор настройки

Служба агента предлагает три режима конфигурации среды в соответствии с различными потребностями:

• Базовая настройка:

  Эта настройка совместима с Помощниками OpenAI и управляет состояниями агента с помощью встроенного хранилища платформы. Она включает те же средства и возможности, что и API Помощников, а также добавлена поддержка моделей и инструментов, отличных от OpenAI, таких как Поиск с использованием ИИ Azure и Bing.

• Стандартная настройка:

  Включает все в рамках базовой настройки, а также предоставляет точный контроль над данными, позволяя использовать собственные ресурсы Azure. Все данные клиента, включая файлы, потоки и векторные хранилища, хранятся в собственных Azure ресурсах, обеспечивая полное владение и контроль.

• Стандартная настройка с собственной виртуальной сетью (BYO):

  Включает все в стандартную настройку, а также добавленную возможность полностью работать в собственной виртуальной сети. Эта настройка поддерживает концепцию "Принеси свою собственную виртуальную сеть" (BYO virtual network), что позволяет строго контролировать перемещение данных и предотвращать утечку данных, сохраняя трафик в сетевой среде.

Важно

Стандартные настройки требуют использования собственных ресурсов (BYO), чтобы все данные агента оставались у арендатора Azure.

Ресурсы BYO включают: служба хранилища Azure, Поиск с использованием ИИ Azure и Azure Cosmos DB.

Все данные, обработанные службой агента Foundry, автоматически хранятся в состоянии покоя в этих ресурсах, что помогает соответствовать требованиям по соблюдению корпоративных стандартов безопасности.

Сравнение параметров установки

Примечание

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

Входящий защищенный обмен данными можно применить ко всем настройкам ниже, добавив частную конечную точку и отключив входящий общедоступный доступ для учетной записи Foundry.

Варианты использования	Базовая настройка	Стандартная настройка с общедоступными сетями	Стандартная настройка с частной сетью
Быстрое начало работы без управления ресурсами	✅
Все журналы бесед, файлы и векторные хранилища хранятся в собственных ресурсах		✅	✅
Поддержка управляемых клиентом ключей (CMK)		✅	✅
Частная сетевая изоляция (перенос собственной виртуальной сети)			✅

Варианты развертывания

Чтобы настроить эти шаблоны, используйте собственные средства.

Если требуется поддержка для изоляции частной сети, см. настройку сети с защитой для получения дополнительных сведений о том, как использовать собственную виртуальную сеть.

Описание и автоматический деплой	Схема (щелкните, чтобы увеличить масштаб)
Разверните базовую настройку агента, которая использует управляемое удостоверение для проверки подлинности. Создается учетная запись и проект. Развернута модель GPT-4.1. По умолчанию используется управляемый Microsoft Key Vault.
Разверните стандартную настройку агента, которая использует управляемое удостоверение для проверки подлинности. Создается учетная запись и проект. Развернута модель GPT-4.1. ресурсы Azure для хранения данных клиента —служба хранилища Azure, Azure Cosmos DB и Поиск с использованием ИИ Azure создаются автоматически, если существующие ресурсы не предоставляются. Эти ресурсы подключены к проекту для хранения файлов, потоков и векторных данных. По умолчанию используется управляемый Microsoft Key Vault.

[Необязательно] Выбор модели в шаблоне autodeploy

Важно

Не изменяйте параметр modelFormat.

Шаблоны поддерживают только развертывание моделей OpenAI Azure. Смотрите, какие модели Azure OpenAI поддерживаются в статье model support.

Модель, используемую агентом, можно настроить, изменив параметры модели в шаблоне autodeploy. Чтобы развернуть иную модель, необходимо обновить параметры modelName и modelVersion.

По умолчанию шаблон развертывания настраивается со следующими значениями:

Параметр модели	Значение по умолчанию
ИмяМодели	gpt-4.1
формат модели	OpenAI (для Azure OpenAI)
версия модели	2025-04-14
Имя модели SKU	GlobalStandard
МестоположениеМодели	eastus

Проверьте ваше развертывание

После завершения развертывания (обычно 5–10 минут) убедитесь, что ресурсы были созданы успешно:

1. Перейдите на портал Azure.
2. Найдите имя группы ресурсов.
3. Убедитесь, что существуют следующие ресурсы:
   • Базовая настройка: учетная запись Foundry, проект и развертывание модели.
   • Standard setup: все основные ресурсы, а также учетная запись служба хранилища Azure, учетная запись Azure Cosmos DB и служба Поиск с использованием ИИ Azure.

Совет

Если развертывание завершается ошибкой, проверьте раздел "Развертывания" в вашей группе ресурсов, чтобы получить подробности об ошибке. Распространенные проблемы включают недостаточную квоту для модели или отсутствующие разрешения.

Устранение неполадок

Проблема	Причина	Решение
Сбой развертывания с ошибкой квоты	Недостаточно квоты для GPT-4.1 в выбранном регионе	Запрос увеличения квоты или выбора другого региона
Отказано в разрешении при развертывании	Отсутствует роль администратора доступа на основе ролей	Попросите владельца подписки предоставить вам необходимую роль
Ресурсы созданы, но создание агента завершается сбоем	Проект неправильно подключен к ресурсам	Проверьте подключение на портале Foundry в разделе Управление>Сведения о проекте>Подключенные ресурсы
Модель недоступна	Модель не развернута в вашем регионе	Проверьте поддержку региона модели и выберите доступный регион

Что дальше?

• Создание первого агента

• Дополнительные сведения:

  • Задачи с повышенными привилегиями в Microsoft Foundry — требования к роли для настройки агента.
  • Использование существующих ресурсов
  • Настройка защищенного сетевого агента