Создание подключения 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 |
|
Запрос OpenAI |
|
Association (Связь) |
задайте значение параметра Association Field (Поле связи), это поле из таблицы входных данных, содержащее уникальный идентификатор. Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным ИД, из исходных данных или из процесса загрузки таблицы. |
Name (Имя) | Имя подключения. Если поле оставлено пустым, используется имя по умолчанию. |