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

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

Чтобы обеспечить обмен данными с OpenAI, создайте подключение к источнику аналитики OpenAI. Создайте подключение в хабе, Редактор загрузки данных или Редактор скриптов.

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

Конфигурации и настраиваемые параметры

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

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

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

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

Документацию OpenAI об API-интерфейсе, используемом в этой конфигурации, см. в разделе Завершения.

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

OpenAI Completions API (GPT-3) — JSON Tables (API Завершения OpenAI (GPT-3) — таблицы JSON)

Эта конфигурация отправляет запрос в каждой строке, где в качестве ответа ожидается список данных JSON. Коннектор преобразует таблицу JSON в таблицу данных в модели данных Qlik. Эту конфигурацию следует рассматривать как экспериментальную по причине природы ответов OpenAI.

Ее можно создать в скрипте загрузки для синтеза данных. Она не предназначена для использования в выражениях диаграммы. В зависимости от того, как задан вопрос, не всегда возвращается допустимая таблица JSON.

Модели GPT не всегда точно предсказывают, как будет выглядеть JSON, например числа, содержащие текст без кавычек. В определенных случаях вопрос может задаваться с добавлением строки «как список JSON» в запрос в скрипте загрузки. В других сценариях запрос должен быть намного более конкретным для получения желаемого результата.

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

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

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

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

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

Документацию OpenAI об API-интерфейсе, используемом в этой конфигурации, см. в разделе Чат.

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

OpenAI Embeddings (Встраивания OpenAI)

Эта конфигурация отправляет строки входного текста в OpenAI Embeddings API (API Встраивания OpenAI). OpenAI возвращает отдельное векторное представление для каждого входного элемента. Это векторное представление имеет форму, пригодную для использования в моделях машинного обучения.

Документацию OpenAI об API-интерфейсе, используемом в этой конфигурации, см. в разделе Встраивания.

Настраиваемые параметры для конфигурации OpenAI Embeddings API (API Встраивания OpenAI)
Поле	Описание
Выбрать конфигурацию	В области Конфигурация выберите OpenAI Embeddings (Встраивания OpenAI).
Авторизация	Введите ключ API OpenAI API. Для получения дополнительной информации см. раздел Создание ключа OpenAI API.
Запрос OpenAI	OpenAI Model (Модель OpenAI): используемая модель. User (Пользователь): идентификатор конечного пользователя, который упрощает мониторинг нарушений политик.
Association (Ассоциация)	задайте значение параметра Association Field (Поле связи), это поле из таблицы входных данных, содержащее уникальный идентификатор. Оно требуется для включения поля в исходные данные, когда отправляется запрос конечной точки для связывания возвращенной таблицы результатов с исходной таблицей поля с помощью ключа. Назначенное поле будет возвращено как поле в ответе и обеспечит возможность связывания с исходными данными в модели данных. Это может быть любое поле с уникальным ИД, из исходных данных или из процесса загрузки таблицы.
Name (Имя)	Имя подключения. Если поле оставлено пустым, используется имя по умолчанию.

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

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

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

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

Дополнительные описания параметров см. в разделе Конфигурации и настраиваемые параметры.

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

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

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

Подробные примеры

Полные примеры работы с коннектором OpenAI Аnalytics см. в разделе Учебное пособие — использование коннектора аналитики OpenAI в Qlik Cloud.

Подробнее

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

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

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