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

Быстрый старт: Настройка первого ресурса Foundry

В этом кратком руководстве вы создадите ресурс Microsoft Foundry и проверите доступ.

Узнайте, как создать ресурс Foundry и управлять ими. Это основной тип ресурса Azure для создания, развертывания и управления генеративными моделями ИИ и приложениями, включая агентами в Azure.

Ресурс Azure требуется для использования служб и управления ими в Azure. Она определяет сферу настройки доступа, безопасности, например, сети, выставления счетов и мониторинга.

Ресурс Foundry является следующей версией с новым названием бывшего "Foundry Tools". Она предоставляет среду приложения для размещения агентов, развертываний моделей, оценки и т. д.

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

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

Хотите настроить Foundry с расширенными параметрами безопасности? Просмотреть расширенные параметры создания Foundry

Создание первого ресурса

Чтобы создать первый ресурс с базовыми параметрами Azure, выполните следующие действия, используя Azure portal, Azure CLI или PowerShell.

Предпосылки

  • Действующая подписка Azure — Создать одну бесплатно.
  • В Azure роль RBAC для создания ресурсов. Вам потребуется одна из следующих ролей, назначенных в подписке или группе ресурсов Azure:
    • Contributor
    • Владелец
    • Настраиваемая роль с разрешением Microsoft.CognitiveServices/accounts/write

Создание нового ресурса Microsoft Foundry

Если для организации требуются настраиваемые конфигурации Azure, такие как альтернативные имена, элементы управления безопасностью или теги затрат, может потребоваться использовать параметры Azure portal или template для соответствия требованиям Azure Policy вашей организации.

Ресурс Foundry указан в разделе Foundry>Foundry в Azure portal. Тип API — AIServices. Найдите логотип, как показано здесь:

Скриншот ресурса Foundry в портале Azure.

Подсказка

портал Foundry предоставляет способ создать новый ресурс Foundry с базовыми, стандартными параметрами.

Чтобы создать ресурс Foundry в Azure portal выполните следующие инструкции:

  1. Выберите эту ссылку ресурса Foundry: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. На странице "Создание" укажите следующие сведения:

    Детали проекта Описание
    Подписка Выберите одну из доступных Azure подписок.
    Группа ресурсов Группа ресурсов Azure, которая будет содержать ресурс Foundry. Вы можете создать новую группу или добавить ее в предустановленную группу.
    Регион Расположение экземпляра инструмента Foundry. Различные расположения могут привести к задержке, но не влияют на доступность ресурса во время выполнения.
    Имя Описательное имя для ресурса Foundry. Например, MyAIServicesResource.

  3. Настройте другие параметры для ресурса по мере необходимости, прочитайте и примите условия (как применимо), а затем нажмите кнопку "Проверить и создать".

Подсказка

Если подписка не позволяет создать ресурс Foundry, Может потребоваться включить привилегии этого поставщика ресурсов Azure с помощью команды Azure portal PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите кого-то с ролью владельца или администратора завершить регистрацию для вас или запросить права /register/action , которые будут предоставлены вашей учетной записи.

Очистите ресурсы

Если вы хотите очистить и удалить ресурс Foundry, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все другие ресурсы, содержащиеся в группе.

  1. В Azure portal разверните меню слева, чтобы открыть меню служб и выбрать Resource Groups, чтобы отобразить список групп ресурсов.
  2. Найдите группу ресурсов, содержащую ресурс для удаления.
  3. Если вы хотите удалить всю группу ресурсов, выберите имя группы ресурсов. На следующей странице выберите "Удалить группу ресурсов" и подтвердите ее.
  4. Если вы хотите удалить только ресурс Foundry, выберите группу ресурсов, чтобы просмотреть все ресурсы в ней. На следующей странице выберите ресурс, который требуется удалить, выберите меню с многоточием для этой строки и нажмите кнопку "Удалить".

Используйте это краткое руководство по созданию ресурса Foundry с помощью команд Azure Command-Line Interface (CLI).

Предпосылки

  • Действующая подписка Azure — Создайте её бесплатно.
  • Azure CLI версии 2.0 или более поздней.
  • В Azure роль RBAC для создания ресурсов. Вам потребуется одна из следующих ролей, назначенных в подписке или группе ресурсов Azure:
    • Contributor
    • Владелец
    • Настраиваемая роль с разрешением Microsoft.CognitiveServices/accounts/write

Установка Azure CLI и вход

Установите Azure CLI. Чтобы войти в локальную установку интерфейса командной строки, выполните команду az login:

az login

Создание новой группы ресурсов

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

Чтобы создать ресурс, вам потребуется одно из расположений Azure, доступных в вашей подписке. Список доступных расположений можно получить с помощью команды az account list-locations. Доступ к большинству средств Foundry можно получить из нескольких местоположений. Выберите ближайшее к вам расположение или посмотрите, какие расположения доступны для службы.

Это важно

  • Помните свое расположение Azure, поскольку оно вам потребуется при вызове ресурсов Microsoft Foundry.
  • Доступность некоторых средств Foundry может отличаться по регионам. Дополнительные сведения см. в разделе Azure продукты по регионам.
az account list-locations --query "[].{Region:name}" --out table

После того как вы выбрали местоположение в Azure, создайте новую группу ресурсов в Azure CLI с помощью команды az group create. В приведенном ниже примере замените расположение Azure westus2 одним из расположений Azure, доступных для подписки.

az group create --name ai-services-resource-group --location westus2

Создание ресурса Foundry

Чтобы создать и подписаться на новый ресурс Foundry, используйте команду create az cognitiveservices account create. Эта команда добавляет новый оплачиваемый ресурс в созданную ранее группу ресурсов. При создании нового ресурса необходимо знать тип службы, которую вы хотите использовать, а также ценовую категорию (или номер SKU) и расположение Azure.

Это важно

Azure предоставляет несколько типов ресурсов для средств Foundry. Обязательно создайте один с kindAIServices.

Вы можете создать ресурс Foundry с именем foundry-multi-service-resource с помощью следующей команды.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Подсказка

Если подписка не позволяет создать ресурс Foundry, Может потребоваться включить привилегии этого поставщика ресурсов Azure с помощью команды Azure portal PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите кого-то с ролью владельца или администратора завершить регистрацию для вас или запросить права /register/action , которые будут предоставлены вашей учетной записи.

Узнайте текущее использование квоты вашего ресурса

Чтобы узнать использование вашего ресурса, используйте команду az cognitiveservices account list-usage.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Очистите ресурсы

Если вы хотите очистить и удалить ресурс Foundry, его можно удалить или группу ресурсов. При удалении группы ресурсов также удаляются все другие ресурсы, содержащиеся в группе.

Чтобы удалить группу ресурсов и связанные с ней ресурсы, используйте этот параметр az group delete command.

az group delete --name ai-services-resource-group

Используйте это краткое руководство по созданию ресурса Foundry с помощью команд Azure PowerShell.

Предпосылки

  • Действующая подписка Azure — Создайте её бесплатно.
  • Azure PowerShell версии 5.0 или более поздней.
  • В Azure роль RBAC для создания ресурсов. Вам потребуется одна из следующих ролей, назначенных в подписке или группе ресурсов Azure:
    • Contributor
    • Владелец
    • Настраиваемая роль с разрешением Microsoft.CognitiveServices/accounts/write

Установка Azure PowerShell и вход

Установите Azure PowerShell. Чтобы войти, выполните команду Connect-AzAccount :

Connect-AzAccount

Создание новой группы ресурсов Microsoft Foundry

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

Чтобы создать ресурс, вам потребуется одно из расположений Azure, доступных в вашей подписке. Список доступных расположений можно получить с помощью команды Get-AzLocation . Доступ к большинству средств Foundry можно получить из нескольких местоположений. Выберите ближайшее к вам расположение или посмотрите, какие расположения доступны для службы.

Это важно

  • Помните свой Azure регион, так как он вам потребуется при вызове ресурсов Foundry.
  • Доступность некоторых средств Foundry может отличаться по регионам. Дополнительные сведения см. в разделе Azure продукты по регионам.
Get-AzLocation | Select-Object -Property Location, DisplayName

После размещения Azure создайте новую группу ресурсов в Azure PowerShell с помощью команды New-AzResourceGroup. В приведенном ниже примере замените расположение Azure westus2 одним из расположений Azure, доступных для подписки.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Создание ресурса Foundry

Чтобы создать и подписаться на новый ресурс Foundry, используйте команду New-AzCognitiveServicesAccount . Эта команда добавляет новый оплачиваемый ресурс в созданную ранее группу ресурсов. При создании нового ресурса необходимо знать тип службы, которую вы хотите использовать, а также ценовую категорию (или номер SKU) и расположение Azure:

Это важно

Azure предоставляет несколько типов ресурсов для средств Foundry. Обязательно создайте один объект с типом TypeAIServices.

Вы можете создать ресурс Foundry с именем foundry-multi-service-resource с помощью следующей команды.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Подсказка

Если подписка не позволяет создать ресурс Foundry, Может потребоваться включить привилегии этого поставщика ресурсов Azure с помощью команды Azure portal PowerShell или команды Azure CLI. Если вы не являетесь владельцем подписки, попросите кого-то с ролью владельца или администратора завершить регистрацию для вас или запросить права /register/action , которые будут предоставлены вашей учетной записи.

Узнайте текущее использование квоты вашего ресурса

Используйте команду Get-AzCognitiveServicesAccountUsage , чтобы получить использование ресурса.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Очистите ресурсы

Если вы хотите очистить и удалить ресурс Foundry, его можно удалить или группу ресурсов. При удалении группы ресурсов также удаляются все другие ресурсы, содержащиеся в группе.

Чтобы удалить группу ресурсов и связанные с ней ресурсы, используйте команду Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Получите доступ к ресурсу

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

Проверка настройки

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

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Ожидаемые выходные данные: Successfully connected. Found X projects. где X — это количество проектов в ресурсе.

Ссылки:

Предоставление или получение разрешений разработчика

Управление доступом на основе ролей Azure (RBAC) различает разрешения между действиями управления и разработки. Чтобы разрабатывать с помощью Foundry, учетной записи пользователя должны быть предоставлены разрешения разработчика ("действия с данными"). Можно использовать одну из встроенных ролей RBAC или использовать пользовательскую роль RBAC.

Встроенные Azure роли разработчика RBAC для Foundry включают:

Role Описание
Менеджер проекта Azure AI Предоставляет разрешения на разработку и разрешения на управление проектами. Можно пригласить других пользователей для совместной работы над проектом в роли "пользователя Azure AI".
пользователь ИИ Azure Предоставляет разрешения на разработку.
Владелец учетной записи Azure AI Предоставляет полный доступ для управления проектами ИИ и учетными записями. Можно пригласить других пользователей для совместной работы над проектом в роли "пользователя Azure AI".
Владелец Azure ИИ Предоставляет полный доступ к управляемым проектам и учетным записям ИИ, а также строить и развивать проекты.

Замечание

Роль владельца AI в Azure вскоре станет доступна для назначения на портале Azure и Foundry.

Схема встроенных ролей в Foundry.

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

Только авторизованные пользователи, как правило, владелец подписки Azure или группы ресурсов, могут назначать роль через [портал Azure](ссылка на Azure portal) или [портал Foundry через раздел администрирования](Ссылка на портал Foundry). Узнайте больше о ролевом управлении доступом.

Это важно

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

Начните создание в своем первом проекте

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

Изучите некоторые службы, которые входят в состав ресурса:

Услуга Описание
значок FoundryСлужба агента Foundry Объедините мощь генеративных моделей искусственного интеллекта с инструментами, предоставляющими агентам возможность доступа и взаимодействия с реальными источниками данных.
значок FoundryAzure Инференция модели Выполняет вывод модели для флагманской модели в каталоге моделей Foundry.
Иконка Azure OpenAI в моделях Foundry Azure OpenAI Выполнение различных задач естественного языка.
значок Безопасность контентаБезопасность контента Средство Foundry, которое обнаруживает нежелательное содержимое.
значок Document IntelligenceDocument Intelligence Преобразуйте документы в интеллектуальные решения на основе данных.
значок ЯзыкЯзык Создавайте приложения с передовыми возможностями обработки естественного языка в отрасли.
значок РечьРечь Перевод речи в текст, текст в речь, перевод и распознавание говорящего.
значок TranslatorTranslator Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.

Дальнейшие шаги

  • Last updated on