Выполнить запрос в GPT

Описание

Блок выполняет текстовый запрос к языковой модели: к чат-боту PuzzleGPT или к внешним моделям (ChatGPT, YandexGPT, DeepSeek, Qwen, Claude, Grok). Состав параметров блока зависит от выбранной модели.

Описание параметров

Блок имеет несколько основных параметров:

1. Выполнить запрос к - тип языковой модели.

   В выпадающем списке можно выбрать один из вариантов:

   
   PuzzleGPT

   2. Сервер PuzzleGPT - адрес сервера PuzzleGPT: только схема и хост, без пути (путь к API блок добавляет сам);

      Тип данных: str (Строка)

      Пример: https://pgpt.example.ru

   3. Сервер Keycloak - адрес сервера авторизации Keycloak: только схема и хост, без пути (путь /auth/realms/<Realm>/… блок добавляет сам);

      Тип данных: str (Строка)

      Пример: https://auth.example.ru

   4. Realm - имя realm в Keycloak;

      Тип данных: str (Строка)

      Пример: puzzle-rpa

   5. Client ID - идентификатор клиента (client_id) в Keycloak;

      Тип данных: str (Строка)

      Пример: AppTechnicalManagerRPA

   6. Логин - имя учетной записи PuzzleGPT;

      Тип данных: str (Строка)

      Пример: user

   7. Пароль - пароль учетной записи PuzzleGPT;

      Тип данных: str (Строка)

      Пример: password

   8. Контекст - история диалога: список словарей с предыдущими запросами и ответами. Если контекст не нужен, в разъём передаётся Ничто;

      Тип данных: list (Список) | null (Ничто)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к PuzzleGPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к PuzzleGPT'},
              {'role': 'assistant', 'content': 'Ответ от PuzzleGPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.);
        • assistant — ответ модели (используется для сохранения истории диалога);
        • system — служебная инструкция.
      • content - текст сообщения.

      История диалога передаётся чат-боту вместе с текущим запросом: модель учитывает факты и договорённости из контекста, не пересказывая его дословно.

   9. Запрос - ваш вопрос к чат-боту PuzzleGPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   10. ID-бота - идентификатор чат-бота PuzzleGPT, к которому выполняется запрос (обязательный параметр). Список доступных ботов и их идентификаторы возвращает блок Получить список чат-ботов PuzzleGPT;

       Тип данных: str (Строка)

       Пример: 69d89f27-acd2-436f-8b2d-b639ee424e4f

       Получить список чат-ботов PuzzleGPT Блок получает с сервера PuzzleGPT список чат-ботов, доступных пользователю, с их идентификаторами. Подробнее...

   11. Таймаут (сек) - максимальное время ожидания ответа чат-бота;

       Тип данных: int (Целое число) | float (Число с плавающей точкой)

       Пример: 300

   12. Проверять SSL-сертификат - выполнять проверку SSL-сертификата серверов PuzzleGPT и Keycloak.

       Тип данных: checkbox (Чекбокс)

       Пример: ✔

   ChatGPT

   2. Ключ API - Ключ API для доступа к модели GPT;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

   3. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   4. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'content': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • content - сообщение полученное от пользователя или модели.

   5. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   6. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: gpt-3.5-turbo

   7. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 4096

   8. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.1

   YandexGPT

   2. OAuth-токен Yandex - OAuth-токен доступа;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

      Подробная инструкция по регистрации в Яндекс: Регистрация Yandex Cloud.

   3. Идентификатор каталога Yandex - идентификатор каталога;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

      Подробная инструкция по регистрации в Яндекс: Регистрация Yandex Cloud.

   4. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   5. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'text': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'text': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'text': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • text - сообщение полученное от пользователя или модели.

   6. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   7. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: yandexgpt-lite

   8. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 4096

   9. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.1

   DeepSeek

   2. Ключ API - Ключ API для доступа к модели GPT;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

   3. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   4. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'content': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • content - сообщение полученное от пользователя или модели.

   5. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   6. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: deepseek-chat

   7. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 4096

   8. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.1

   Qwen

   2. Ключ API - Ключ API для доступа к модели GPT;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

   3. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   4. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'content': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • content - сообщение полученное от пользователя или модели.

   5. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   6. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: qwen-plus

   7. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 4096

   8. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.1

   Claude

   2. Ключ API - Ключ API для доступа к модели GPT;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

   3. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   4. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'content': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • content - сообщение полученное от пользователя или модели.

   5. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   6. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: claude-sonnet-4-5

   7. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 4096

   8. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.1

   Grok

   2. Ключ API - Ключ API для доступа к модели GPT;

      Тип данных: str (Строка)

      Пример: 1fsyhassrhjfdaWE324HFDSZSDR

   3. Ваши инструкции к GPT - инструкции, которые описывают поведение GPT по умолчанию;

      Тип данных: str (Строка)

      Пример: Ты чат-бот помощник по работе PuzzleRPA

   4. Контекст - история запросов и ответов от GPT, который представлет собой список словарей с историей сообщений от GPT;

      Тип данных: list (Список)

      Пример: [{'role': 'user', 'content': 'Ваш запрос к GPT'}]

      Контекст передаётся как список словарей, где каждый словарь представляет одно сообщение в диалоге:

          [
              {'role': 'user', 'content': 'Ваш запрос к GPT'},
              {'role': 'assistant', 'content': 'Ответ от GPT'},
              ...
          ]

      • role - определяет, кто отправил сообщение:
        • user — сообщение от пользователя (вопрос, команда, данные и т.д.).
        • assistant — ответ модели (используется для сохранения истории диалога).
      • content - сообщение полученное от пользователя или модели.

   5. Запрос - ваш вопрос к GPT;

      Тип данных: str (Строка)

      Пример: Что такое Puzzle RPA

   6. Использовать модель - названием модели GPT;

      Тип данных: str (Строка)

      Пример: grok-4

   7. Максимальная длина ответа - определяет максимальное количество токенов, которое будет включено в ответ модели. Токены - это отдельные единицы текста, такие как отдельные символы или слова. Установка более высокого значения позволит модели сгенерировать более длинные ответы, но при этом может быть увеличено время выполнения запроса и учтены дополнительные токены в расчете стоимости;

      Тип данных: int (Целое число)

      Пример: 2000

   8. Уровень случайности - параметр контролирует степень случайности ответов модели. Значение близкое к 0.0 приведет к более жестким и детерминированным ответам, тогда как значение близкое к 1.0 сделает ответы более разнообразными и случайными.

      Тип данных: float (Рациональное число)

      Пример: 0.7

Возвращаемое значение

Формат результата зависит от выбранной модели:

1. PuzzleGPT - словарь с двумя ключами:

   Тип данных: dict (Словарь)

   Пример: {'reasoning': 'Пользователь спрашивает, что такое PuzzleRPA…', 'answer': 'PuzzleRPA - это платформа…'}

   • reasoning - рассуждение чат-бота перед ответом (может быть пустым);
   • answer - текст ответа. Если чат-бот отклонил запрос или на сервере произошла ошибка, её описание также помещается в answer.

2. ChatGPT, DeepSeek, Qwen, Claude, Grok - текст ответа модели.

   Тип данных: str (Строка)

   Пример: PuzzleRPA - это платформа для автоматизации бизнес-процессов…

3. YandexGPT - список из четырёх элементов:

   Тип данных: list (Список)

   Пример: ['Текст ответа', {…полный ответ сервера…}, {…заголовки HTTP…}, 200]

   • текст ответа на запрос;
   • полный ответ от сервера Yandex;
   • заголовки HTTP-ответа сервера Yandex;
   • код HTTP-ответа сервера Yandex.

   В данном примере из результата YandexGPT берётся первый элемент - текст ответа:

   

---

Пример использования

Использование контекста

В приведённом примере к чат-боту PuzzleGPT последовательно отправляются два запроса:

1. Объявляется переменная context, предназначенная для хранения истории диалога;
2. Выполняется цикл из двух запросов:
   • Что такое PuzzleRPA?
   • Какие есть плюсы у платформы?
3. Выполняется запрос к чат-боту PuzzleGPT с указанием ID-бота; результат сохраняется в переменную response;
4. В список context добавляются запрос пользователя и ответ чат-бота - текст ответа берётся из словаря response по ключу answer;
5. Второй запрос выполняется с учётом накопленного контекста.

Заметка

Во втором запросе явно не указано название платформы. Модель PuzzleGPT строит ответ исходя из передаваемого контекста.

---

Результат

Вывод на экран первого ответа нейросети:

Вывод на экран второго ответа нейросети:

Использование ID-бота

В данном примере идентификатор чат-бота берётся из списка ботов, доступных пользователю, после чего выполняется запрос к этому боту:

1. Блоком Получить список чат-ботов PuzzleGPT запрашивается список ботов и сохраняется в переменную chat_bots;
2. Из первого элемента списка берётся значение по ключу chat_bot_id и сохраняется в переменную bot_id;
3. Выполняется запрос Что такое Puzzle RPA? к чат-боту с идентификатором bot_id без контекста (в разъём Контекст передано Ничто);
4. Результат сохраняется в переменную response и показывается пользователю.

---

Результат

Вывод на экран ответа чат-бота:

---