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

Краткое руководство: настройка первого ресурса AI Foundry

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

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

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

Ресурс Azure AI Foundry — это следующая версия и переименование бывших служб ИИ Azure. Она предоставляет среду приложения для размещения агентов, развертываний моделей, оценки и т. д.

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

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

Хотите настроить AI Foundry с расширенными параметрами безопасности? См. расширенные варианты создания ИИ Foundry

Хотите использовать навыки поиска Azure AI? См. Использование Azure AI Foundry с навыками поиска Azure AI.

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

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

Предпосылки

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

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

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

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

Снимок экрана: ресурс Azure AI Foundry на портале Azure.

Подсказка

Портал Azure AI Foundry предоставляет способ создания нового ресурса Azure AI Foundry с базовыми, стандартными параметрами.

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

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

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

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

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

Подсказка

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

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

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

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

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

Предпосылки

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

Установите Azure CLI и войдите в систему

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

az login

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

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

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

Это важно

  • Помните ваше местоположение Azure, так как оно потребуется вам при вызове ресурсов Azure AI Foundry.
  • Доступность некоторых служб ИИ Azure может отличаться по регионам. Дополнительные сведения см. в продуктах 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

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

Это важно

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

Вы можете создать ресурс AI 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

Подсказка

Если подписка не позволяет создавать ресурс Ai Foundry, возможно, потребуется включить привилегию этого поставщика ресурсов Azure с помощью портала Azure, команды 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

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

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

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

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

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

Предпосылки

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

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

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

Connect-AzAccount

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

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

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

Это важно

  • Помните ваше местоположение Azure, так как оно потребуется вам при вызове ресурсов Azure AI Foundry.
  • Доступность некоторых служб ИИ Azure может отличаться по регионам. Дополнительные сведения см. в продуктах 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

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

Это важно

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

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

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

Подсказка

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

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

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

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

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

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

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

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

Доступ к ресурсу

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

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

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

# 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.
Пользователь Azure AI Предоставляет разрешения на разработку.

Только уполномоченные пользователи, обычно это владелец подписки Azure или группы ресурсов, могут назначать роль через [портал Azure] или [портал AI Foundry через центр управления]. Дополнительные сведения об управлении доступом на основе ролей.

Это важно

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

Начинайте работу над вашим первым проектом

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

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

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

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