Поделиться через

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

Создание первого агента с помощью службы агента Foundry — это двухэтапный процесс:

  1. Настройте среду агента.
  2. Создайте и настройте агент с помощью выбранного пакета SDK или портала Azure Foundry.

Используйте эту статью, чтобы узнать больше о настройке среды агента.

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

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

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

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

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

Предпосылки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Это важно

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

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

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

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

Параметр модели Значение по умолчанию
название модели gpt-4o
формат модели OpenAI (для Azure OpenAI)
версия модели 20.11.2024
modelSkuName GlobalStandard
Расположение модели Истус

Что дальше?

  • Last updated on