Создание подключения Azure OpenAI

Чтобы обеспечить обмен данными с Azure OpenAI, создайте подключение к источнику аналитики Azure OpenAI.

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

Перед началом работы

В учетной записи Microsoft Azure служба Azure OpenAI находится в разделе Azure Cognitive Services, по умолчанию она выключена. Обратитесь в службу поддержки корпорации «Майкрософт», если требуется включить службу Azure OpenAI.

Доступные конфигурации коннекторов

Настройте подключение к аналитике Azure OpenAI с использованием одной из следующих конфигураций.

OpenAI Completions API — Rows (API Завершения OpenAI — строки)

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

Эту конфигурацию можно использовать как в скрипте загрузки данных, так и в выражениях диаграмм.

OpenAI Chat Completions API — Rows (API Завершения чата OpenAI — строки)

Эта конфигурация отправляет каждую строку данных как запрос в API-интерфейс OpenAI Chat Completions. В этом случае запросы от имени роли сообщения «пользователь», и каждая строка данных из Qlik отправляется как отдельный запрос.

Отправка нескольких строк в качестве контекста чата не поддерживается. Необходимо включить все вопросы в одну строку запроса.

Эту конфигурацию можно использовать как в скрипте загрузки данных, так и в выражениях диаграмм.

Создание подключения

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

Для получения информации о настройке значений параметров см. Справочник по API-интерфейсу REST для служб Azure OpenAI.

Выполните следующие действия.

Создайте новое приложение или скрипт Qlik Sense и откройте Редактор загрузки данных или Редактор скриптов.
Щелкните команду Создать новое подключение.
В разделе Источники аналитики щелкните Azure OpenAI.
Выберите нужный вариант в списке Configuration (Конфигурация). Для получения дополнительной информации о каждом доступном варианте см. Доступные конфигурации коннекторов.
Введите ключ API Azure OpenAI.
Введите версию API Azure OpenAI. Это поле уже заполнено текущим значением по умолчанию.
Настройте другие необходимые параметры, при необходимости изменяя значения по умолчанию.

Дополнительные описания параметров см. в разделе Настраиваемые параметры.

Примечание к информацииПрактически всегда необходимо изменять значение параметра Max Tokens (Макс. кол-во токенов) по умолчанию, чтобы подключение выполнялось надлежащим образом в соответствии с потребностями. Этот параметр контролирует размер ответа, который будет сгенерирован по запросу.
Нажмите кнопку Создать.

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

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

Настраиваемые параметры

Параметры в следующей таблице можно настроить в диалоговом окне подключения.

Настраиваемые параметры в диалоговом окне подключения
Поле	Описание
Выбрать конфигурацию	В разделе Configuration (Конфигурация) выберите конфигурацию для коннектора. Для получения дополнительной информации см. раздел Доступные конфигурации коннекторов.
Авторизация	Введите ключ API Azure OpenAI. Для получения дополнительной информации см. Справочник по API-интерфейсу REST для служб Azure OpenAI.
Запрос Azure OpenAI	Имя ресурса Azure: проект ресурса, настроенный в Microsoft Azure. Имя развертывания Azure: конкретное развертывание, настроенное для выбранной модели OpenAI. Версия API Azure: версия API-интерфейса в Azure. Это поле предварительно заполнено текущим значением по умолчанию.
Запрос OpenAI	Temperature (Температура): используемая температура выборки. Max Tokens (Макс. кол-во токенов): этот параметр регулирует максимальное количество создаваемых токенов. Другими словами, этот параметр контролирует размер ответа, который будет сгенерирован по запросу. Практически всегда необходимо изменять значение параметра по умолчанию, чтобы подключение правильно работало в соответствии с потребностями. Top P (Верхний P): корректирует выборку ядра. Этот параметр можно изменять как альтернативу выборке Temperature (Температура). Frequency Penalty (Штраф за частоту): степень штрафа, накладываемого моделью на новые токены, которые точно повторяют существующие токены. Presence Penalty (Штраф за присутствие): степень штрафа, накладываемого моделью на новые токены, которые уже присутствуют в тексте до момента их введения. User (Пользователь): идентификатор конечного пользователя, который упрощает мониторинг нарушений политик.
Association (Ассоциация)	задайте значение параметра Association Field (Поле связи), это поле из таблицы входных данных, содержащее уникальный идентификатор. Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным ИД, из исходных данных или из процесса загрузки таблицы.
Name (Имя)	Имя подключения. Если поле оставлено пустым, используется имя по умолчанию.

Подробнее

Справочник по API-интерфейсу REST для служб Azure OpenAI

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь