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


Использование Azure OpenAI с Copilot в SSMS

Copilot в SQL Server Management Studio (SSMS) использует точку доступа и инфраструктуру развертывания в Azure OpenAI. В этой статье приведены действия по созданию необходимых ресурсов Azure OpenAI. Дополнительные сведения см. в статье "Создание и развертывание Azure OpenAI" в ресурсе Azure AI Foundry Models.

Доступ к развертываниям можно предоставить с помощью проверки подлинности Microsoft Entra или ключей API. Аутентификация Microsoft Entra рекомендуется как более безопасный вариант.

Стоимость Copilot в SSMS зависит от того, как вы используете выделенные ресурсы Azure OpenAI, а также от выбранной вами модели. Плата будет списываться с подписки Azure, где размещены ресурсы. Дополнительные сведения см. в разделе о ценах на Azure OpenAI Service.

Создайте конечную точку.

Создание конечной точки выполняется на портале Azure.

  1. Войдите на портал Azure.

  2. Перейдите к службам.

  3. Выберите службы ИИ Azure, которые перечислены в разделе "ИИ + машинное обучение".

  4. В службах ИИ Azure*выберите учетную запись Azure OpenAI.

  5. Нажмите кнопку +Создать , чтобы создать новую службу Azure OpenAI.

  6. На странице "Основы" заполните все необходимые сведения.

    1. Имя используется в URL-адресе конечной точки.
    2. Единственный вариант, доступный в настоящее время для ценового уровняStandard S0.
  7. Нажмите кнопку Далее.

  8. На странице "Сеть" выберите "Все сети ", если вы не используете виртуальную частную сеть (VPN). SQL Server Management Studio (SSMS) должен иметь возможность подключиться к конечной точке, чтобы Copilot работал в SSMS.

    1. Если вы используете VPN в разделе "Тип" , проверьте выбранные сети, настройте сетевую безопасность для ресурса служб искусственного интеллекта Azure , а затем выберите соответствующую виртуальную сеть и подсети.

    2. Добавьте соответствующие диапазоны IP-адресов для правила брандмауэра.

  9. Нажмите кнопку Далее.

  10. На странице "Теги" задайте все теги, которые использует ваша организация. Теги не требуются для Copilot в SSMS, но должны быть заданы в соответствии с политикой вашей компании. Например, вашей компании может потребоваться, чтобы все ресурсы использовали тег владельца.

  11. Нажмите кнопку Далее.

  12. На странице "Рецензирование и отправка " просмотрите сведения и нажмите кнопку "Создать".

  13. Появляется сообщение "Выполняется развертывание", а затем сообщение "Развертывание завершено" по его завершении.

  14. Выберите Перейти к ресурсу.

  15. В ресурсе разверните узел "Управление ресурсами", а затем выберите "Ключи" и "Конечная точка".

  16. Запишите значение конечной точки на странице "Ключи" и "Конечная точка" , так как оно будет использоваться при настройке Copilot в SSMS.

    Note

    Во время начальной настройки Copilot в SSMS введите Endpoint в диалоговом окне «Azure OpenAI Endpoint».

  17. Если вы используете доступ к ключу API, при настройке Copilot в SSMS можно использовать ключ 1 или key 2. Доступ к ключу API необязателен; Проверка подлинности Microsoft Entra рекомендуется использовать в качестве более безопасного варианта.

    Note

    Во время начальной настройки Copilot в SSMS введите ключ 1 или ключ 2 в диалоговом окне "Ключ API Azure OpenAI " при использовании доступа к ключу API.

Использование идентификатора Microsoft Entra для доступа

Если вы хотите использовать Microsoft Entra для аутентификации с Azure OpenAI для Copilot в SSMS, необходимо выполнить следующие действия.

  1. В ресурсе конечной точки выберите элемент Управления доступом (IAM).

  2. На странице управления доступом нажмите кнопку +Добавить , чтобы добавить назначение роли.

  3. На странице "Роль " в списке ролей функции задания найдите пользователя OpenAI Cognitive Services и выберите его, а затем нажмите кнопку "Далее".

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

  5. Используйте +Select members, чтобы открыть панель "Выбор элементов".

  6. Выберите соответствующий идентификатор из списка, а затем выберите.

  7. Выберите «Рецензирование и назначение», затем на странице «Рецензирование и назначение» просмотрите участников и снова выберите «Рецензирование и назначение», чтобы назначить участников на развертывание.

  8. Появится уведомление о добавлении роли.

  9. Повторите шаги 2–8 для участника OpenAI Cognitive Services. Все члены, будь то пользователь, группа, основной объект службы или управляемое удостоверение, должны быть добавлены в обе эти роли.

Роль вкладчика OpenAI в Cognitive Services имеет права на чтение и запись, а также возможность изменять конечную точку. Кроме того, вы можете назначить роль участника Cognitive Services OpenAI пользователю, который управляет конечной точкой (этот пользователь должен быть назначен как минимум один), и только другим членам назначить роль пользователя Cognitive Services OpenAI. Роль пользователя в OpenAI Cognitive Services является ролью с низкими привилегиями и предоставляет доступ только для чтения к конечной точке доступа.

Создайте развертывание

Последним шагом является создание развертывания.

  1. В ресурсе конечной точки перейдите на страницу Обзора.

  2. Выберите портал Azure AI Foundry, который запускает отдельный портал.

  3. Появится предупреждение о том, что вы покидаете портал Azure. Нажмите Продолжить.

  4. На портале Azure AI Foundry выберите "Развертывания" в разделе "Общие ресурсы".

  5. Выберите + Развернуть модель, затем выберите Развернуть базовую модель.

  6. В области "Выбор модели " выберите модель gpt-4o (завершение чата) и нажмите кнопку "Подтвердить".

    Note

    gpt-4o — единственная модель, поддерживаемая для предварительной версии.

  7. На странице "Развертывание модели " выберите "Настроить".

  8. В диалоговом окне настройки введите значение для имя развертывания.

  9. Запишите значение имени развертывания, поскольку оно будет использоваться в SSMS при настройке Copilot.

    Note

    Во время начальной настройки Copilot в SSMS введите Имя развертывания в диалоговое окно Azure OpenAI Deployment.

  10. Задайте тип развертывания. Каждый тип развертывания содержит описание производительности и расположения данных. Для предварительной версии рекомендуется развертывание с "стандартным" в имени. Если размещение данных не является проблемой, Global Standard предлагает лучшую производительность. Data Zone Standard предоставляет сбалансированный компромисс, а стандарт оптимизирует обслуживание для определенного региона за счет потенциального увеличения задержки.

  11. Версия модели должна быть2024-11-20, а расположение ресурса должно быть задано по умолчанию (наследуется от уже созданной конечной точки).

  12. Установите ограничение скорости токенов в минуту на максимальное доступное значение. Его можно изменить на портале Azure AI Foundry в любое время, если вы решите снизить квоту. Чем ниже значение, тем меньше вопросов в минуту, на которые Copilot может ответить. Дополнительные сведения см. в разделе "Квоты и ограничения моделей Azure OpenAI в Azure AI Foundry".

  13. Оставьте фильтр контента по умолчанию defaultV2, если ваша компания не имеет собственных политик по фильтрам содержимого ИИ.

  14. Выберите «Создать ресурс» и «Развернуть».

  15. По завершении развертывания появится страница сведений. В разделе "Начало работы " можно найти конечную точку и развертывание в коде для запуска базового примера кода:

    Снимок экрана: пример кода, включающий конечную точку и развертывание.

  16. Используйте следующие значения и конечную точку при настройке Copilot в SSMS:

    Снимок экрана: начальное диалоговое окно для Copilot в конфигурации SSMS.

  17. Если вам нужно изменить любые параметры развертывания, например ограничение скорости (маркеры в минуту), перейдите на страницу сведений для развертывания.

Мониторинг затрат

Стоимость Copilot в SSMS зависит от использования и соответствует модели выставления счетов по мере использования. Поскольку стоимость не является фиксированной, повторяющейся стоимостью, рекомендуется регулярно отслеживать расходы на ресурсы, чтобы снизить сюрпризы в выставлении счетов. Дополнительные сведения см. в статье "Планирование управления затратами на Azure OpenAI" в моделях Azure AI Foundry.