Руководство. Часть 1. Создание ресурсов для создания пользовательского приложения чата с помощью пакета SDK для потока запросов
В этом руководстве вы используете пакет SDK потока запросов (и другие библиотеки) для создания, настройки, оценки и развертывания приложения чата для вашей розничной компании с именем Contoso Trek. Ваша розничная компания специализируется на открытом кемпинге шестеренки и одежды. Приложение чата должно отвечать на вопросы о продуктах и службах. Например, приложение чата может ответить на такие вопросы, как "какая палатка является самой водонепроницаемой?" или "что является лучшим спящим мешком для холодной погоды?".
Это руководство является частью одного из трех частей учебника. В этой части показано, как администратор подписки Azure создает и настраивает ресурсы, необходимые для частей двух и трех из серии учебников. В двух и трех частях показано, как разработчик использует ресурсы. Во многих организациях один и тот же человек может взять на себя обе эти роли. В этой части 1 вы узнаете, как:
- Создание центра Azure AI Studio
- Создание проекта
- Создание индекса поиска ИИ Azure
- Настройка доступа к ресурсам Azure AI Studio и службы "Поиск ИИ Azure"
Если вы выполнили другие учебники или краткие руководства, возможно, вы уже создали некоторые ресурсы, необходимые для этого руководства. Если у вас есть, вы можете пропустить эти шаги здесь.
Это руководство является частью одного из трех частей учебника.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Если у вас нет учетной записи, создайте бесплатную учетную запись.
Внимание
Необходимо иметь необходимые разрешения для добавления назначений ролей в подписку Azure. Предоставление разрешений по назначению ролей разрешено только владельцем определенных ресурсов Azure. Возможно, вам потребуется попросить владельца подписки Azure (кто может быть ИТ-администратором), чтобы завершить работу с этим руководством.
Azure AI Studio и портал Azure
В этом руководстве вы используете ресурсы Azure для создания приложения чата. Вы будете использовать Azure AI Studio и портал Azure для создания и настройки этих ресурсов.
- Администратор использует портал Azure для настройки доступа к ресурсам.
- Разработчик использует Azure AI Studio для объединения этих ресурсов, необходимых для создания, оценки и развертывания приложения чата. Вы также можете взаимодействовать с моделями и развертываниями в AI Studio.
Создание центра Azure AI Studio
Чтобы создать центр в Azure AI Studio, выполните следующие действия.
Перейдите на домашнюю страницу в Azure AI Studio и войдите с помощью учетной записи Azure.
Выберите все концентраторы в левой области и нажмите кнопку +Создать концентратор.
В диалоговом окне "Создание концентратора" введите имя концентратора (например, contoso-hub) и нажмите кнопку "Далее". Оставьте параметр connect Azure AI Services по умолчанию. Для концентратора создается новое подключение служб ИИ.
Просмотрите сведения и щелкните Создать.
Ход создания концентратора можно просмотреть в мастере.
Создание проекта
Чтобы создать проект в Azure AI Studio, выполните следующие действия.
- Перейдите на домашнюю страницу Azure AI Studio.
- Выберите +Создать проект.
- Введите имя проекта.
- Выберите центр, созданный на предыдущем шаге.
После создания проекта вы можете получить доступ к игровой площадке, средствам и другим ресурсам на панели навигации слева.
Создание индекса поиска ИИ Azure
Цель этого приложения — заставить ответы модели в пользовательских данных. Индекс поиска используется для получения соответствующих документов на основе вопроса пользователя.
Для создания индекса поиска требуется служба ИИ Azure и подключение.
Примечание.
Создание служба ИИ Azure и последующих индексов поиска связано с затратами. Сведения о ценах и ценовых категориях для azure AI служба на странице создания можно просмотреть, чтобы подтвердить затраты перед созданием ресурса.
Создание служба искусственного интеллекта Azure
Если у вас уже есть служба ИИ Azure, перейдите к следующему разделу.
В противном случае можно создать служба ИИ Azure с помощью портал Azure.
- Создайте служба Azure AI в портал Azure.
- Выберите группу ресурсов и сведения о экземпляре. На этой странице можно просмотреть сведения о ценах и ценовых категориях.
- Перейдите к мастеру и выберите "Проверить и назначить" , чтобы создать ресурс.
- Проверьте сведения о служба azure AI, включая предполагаемые затраты.
- Выберите "Создать", чтобы создать служба ИИ Azure.
Подключение поиска ИИ Azure к проекту
Если у вас уже есть подключение к поиску ИИ Azure в проекте, можно перейти к настройке доступа к служба Azure AI.
В Azure AI Studio проверьте подключенный ресурс поиска ИИ Azure.
- В AI Studio перейдите в проект и выберите "Параметры " в левой области.
- В разделе "Подключенные ресурсы" просмотрите, есть ли у вас подключение к типу службы "Поиск ИИ Azure".
- Если у вас есть подключение к поиску ИИ Azure, вы можете перейти к настройке доступа к ресурсам.
- В противном случае выберите "Создать подключение" и " Поиск по искусственному интеллекту Azure".
- Найдите служба Azure AI в параметрах и выберите "Добавить подключение".
- Перейдите к мастеру, чтобы создать подключение. Дополнительные сведения о добавлении подключений см . в этом руководстве.
Настройка доступа для ресурсов
В этом разделе показано, как настроить различные элементы управления доступом, необходимые для ресурсов, созданных в предыдущих разделах.
Мы рекомендуем использовать идентификатор Microsoft Entra вместо использования ключей API. Чтобы использовать эту проверку подлинности, необходимо задать правильные элементы управления доступом и назначить правильные роли для служб.
Настройка доступа для служб ИИ Azure
Начните с проекта, чтобы найти ресурс служб ИИ:
- В AI Studio перейдите в проект и выберите "Параметры " в левой области.
- Выберите подключенные ресурсы.
- Выберите имя служб ИИ или Azure OpenAI в списке подключенных ресурсов, чтобы открыть страницу сведений о ресурсе. Затем снова выберите имя ресурса на странице сведений о подключении, которая открывает ресурс в портал Azure.
Укажите управление доступом в портал Azure:
- На левой странице в портал Azure выберите элемент управления доступом (IAM)>+ Добавить>назначение роли.
- Найдите роль Пользователя OpenAI Cognitive Services и выберите ее. Затем выберите Далее.
- Выберите "Пользователь", "Группа" или "Субъект-служба". Затем выберите " Выбрать участников".
- В открывающейся области "Выбор членов" найдите имя пользователя, для которого нужно добавить назначение роли. Выберите пользователя и нажмите кнопку "Выбрать".
- Перейдите к мастеру и выберите "Проверить и назначить" , чтобы добавить назначение роли.
Настройка доступа для поиска ИИ Azure
Теперь вернитесь к подключенным ресурсам ai Studio Settings>. На этот раз выберите имя поиска ИИ Azure в списке подключенных ресурсов, чтобы открыть страницу сведений о ресурсе. Затем снова выберите имя ресурса на странице сведений о подключении, которая открывает ресурс в портал Azure.
Чтобы включить управление доступом на основе ролей для служба Azure AI, выполните следующие действия.
В служба Azure AI в портал Azure выберите "Ключи > параметров" в левой области.
Выберите "Оба", чтобы убедиться, что ключи API и управление доступом на основе ролей включены для служба Azure AI.
Предупреждение
Вы можете локально использовать управление доступом на основе ролей, так как вы запускаете az login позже в этом руководстве. Но при развертывании приложения в части 3 руководства развертывание проходит проверку подлинности с помощью ключей API из служба Azure AI. Поддержка проверки подлинности идентификатора Microsoft Entra для развертывания скоро. Теперь необходимо включить ключи и конечные точки.
Затем предоставьте удостоверение пользователя (или удостоверение разработчика, который завершит две и три части) роли участника индекса поиска и участника службы поиска в служба ИИ Azure. Эти роли позволяют вызывать azure AI служба связанное удостоверение пользователя.
По-прежнему в портал Azure для служба Azure AI назначьте роль участника данных индекса поиска служба Azure AI. (Это те же действия, которые вы сделали ранее для службы Azure OpenAI.)
- На левой странице в портал Azure выберите элемент управления доступом (IAM)>+ Добавить>назначение роли.
- Найдите роль участника индекса поиска и выберите ее. Затем выберите Далее.
- Выберите "Пользователь", "Группа" или "Субъект-служба". Затем выберите " Выбрать участников".
- В открывающейся области "Выбор членов" найдите имя пользователя, для которого нужно добавить назначение роли. Выберите пользователя и нажмите кнопку "Выбрать".
- Перейдите к мастеру и выберите "Проверить и назначить" , чтобы добавить назначение роли.
Повторите эти действия, чтобы добавить роль участника службы поиска в служба Azure AI.
Теперь вы готовы передать проект разработчику для создания приложения чата. Разработчик будет использовать пакет SDK потока запросов для создания, настройки, оценки и развертывания приложения чата для вашей розничной компании с именем Contoso Trek.
Очистка ресурсов
Чтобы избежать ненужных затрат Azure, следует удалить ресурсы, созданные в этом руководстве, если они больше не нужны. Для управления ресурсами можно использовать портал Azure.
Но не удаляйте их еще, если вы хотите создать приложение чата в следующей части этой серии учебников.