Настройка среды (классическая модель)

В настоящее время просмотр:Классическая версия портала Foundry - Переключиться на версию нового портала Foundry

Замечание

Некоторые ссылки в этой статье могут открывать содержимое в документации нового Microsoft Foundry вместо документации Foundry (классической версии), которую вы просматриваете сейчас.

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

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

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

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

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

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

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

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

Предпосылки

• Подписка Azure — Создайте её бесплатно.
• Убедитесь, что пользователь, создающий учетную запись и проект, имеет роль владельца учетной записи Azure AI в этой области подписки.
• При настройке стандартной установки то же лицо также должно иметь разрешения на назначение ролей необходимым ресурсам (Cosmos DB, Azure AI Search, Azure Blob Storage). Дополнительные сведения о ролях RBAC, относящихся к службе агента, см. Роли RBAC службы агента.
  • Необходима встроенная роль — администратор доступа на основе ролей.
  • Кроме того, роль владельца на уровне подписки также удовлетворяет этому требованию.
  • Требуется ключевое разрешение: Microsoft.Authorization/roleAssignments/write

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

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

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

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

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

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

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

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

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

Замечание

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

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

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

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

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

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

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

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

Это важно

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

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

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

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

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

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

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

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

Подсказка

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

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

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

Что дальше?

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

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

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