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

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

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

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

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

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

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

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

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

Предпосылки

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

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

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

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

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

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

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

• Standard Setup with Bring Your Own (BYO) виртуальная сеть:

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

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

Замечание

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

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

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

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

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

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

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

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

Это важно

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

Шаблоны поддерживают только развертывание моделей OpenAI #REF!. Узнайте, какие модели #REF! OpenAI поддерживаются в статье Model Support.

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

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

Параметр модели	Значение по умолчанию
modelName	gpt-4.1
формат модели	OpenAI (для #REF! OpenAI)
modelVersion	2025-04-14
modelSkuName	GlobalStandard
Расположение модели	Истус

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

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

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

Подсказка

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

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

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

Что дальше?

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

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

  • Использование существующих ресурсов
  • Настройка защищенного сетевого агента