Руководство пользователя

Руководство пользователя

Обогащение данных

Компоненты для обогащения ваших данных переменными из других источников данных. Эти компоненты работают для простых объектов и сеток пространственных индексов.

Обогатить сетку Quadbin

Описание

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

  • Цель (которая является верхним входным соединением этого компонента) должна иметь столбец, содержащий индексы Quadbin, которые будут использоваться для соединения с источником.
  • Источником (нижнее входное соединение) может быть либо подписка Epsilon Каталога Данных, либо таблица (или результат другого компонента) со столбцом индекса Quadbin.

Для операции обогащения требуется Epsilon Analytics Toolbox, и будет вызвана одна из следующих процедур:

  • DATAOBS_ENRICH_GRID если источником является подписка Каталога Данных
  • ENRICH_GRID в противном случае

Входы

  • Целевая Quadbin колонка: это целевой столбец, который будет использоваться для соединения с источником и выбора строк, которые будут агрегироваться для каждой целевой строки.
  • Геоколонка источника: (необходим только для источников, отличных от КД) — это столбец источника, который будет соединяться с целевым.
  • Переменные: позволяет выбрать данные из источника, которые будут агрегированы и добавлены в цель. Каждой добавленной переменной должен быть назначен метод агрегирования. Вы можете добавить одну и ту же переменную, используя разные методы агрегирования. На данный момент поддерживаются только числовые переменные.
    • для подписок Каталог Данных переменные можно выбирать из переменных КД подписки, идентифицируемых их переменным slug;
    • для других источников это столбцы исходной таблицы.

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

  • Учет соседних: размер k-кольца, к которому будет применяться функция затухания. Это значение может быть равно 0, и в этом случае k-кольцо вычисляться не будет и функция затухания не будет применяться.
  • Коэфф. затухания: функция распада для агрегирования и сглаживания данных. Поддерживаемые значения uniform: inverse, inverse_squareи exponential.

Выходы

  • Результирующая таблица [Table]

Обогащение многоугольников

Описание

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

  • Цель (которая является верхним входным соединением этого компонента) должна иметь геостолбец, который будет использоваться для пересечения с источником.
  • Источником (нижнее входное соединение) может быть либо подписка Epsilon Каталога Данных, либо таблица (или результат другого компонента) с географическим столбцом.

Для операции обогащения требуется Epsilon Analytics Toolbox, и будет вызвана одна из следующих процедур:

  • DATAOBS_ENRICH_POLYGONS если источником является подписка Data Observatory
  • ENRICH_POLYGONS в противном случае

Входы

  • Геоколонка целевых полигонов: это целевой столбец, который будет использоваться для пересечения с исходным и выбора строк, которые будут агрегироваться для каждой целевой строки.
  • Геоколонка источника: (необходим только для источников, отличных от КД) — это столбец источника, который будет пересекаться с целевым.
  • Переменные: позволяет выбрать данные из источника, которые будут агрегированы и добавлены в цель. Каждой добавленной переменной должен быть назначен метод агрегирования. Вы можете добавить одну и ту же переменную, используя разные методы агрегирования. На данный момент поддерживаются только числовые переменные.
    • для подписок Каталог Данных переменные можно выбирать из переменных КД подписки, идентифицируемых их переменным slug;
    • для других источников это столбцы исходной таблицы.

Выходы

  • Результирующая таблица [Table]

Обогащение точек

Описание

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

  • Цель (которая является верхним входным соединением этого компонента) должна иметь геостолбец, который будет использоваться для пересечения с источником.
  • Источником (нижнее входное соединение) может быть либо подписка Epsilon Каталога Данных, либо таблица (или результат другого компонента) с географическим столбцом.

Для операции обогащения требуется Epsilon Analytics Toolbox, и будет вызвана одна из следующих процедур:

  • DATAOBS_ENRICH_POINTS, если источником является подписка Каталога Данных.
  • ENRICH_POINTS иначе

Входы

  • Географический столбец целевой точки: это целевой столбец, который будет использоваться для пересечения с исходным и выбора строк, которые будут агрегироваться для каждой целевой строки.
  • Геоколонка источника: (необходим только для источников, отличных от КД) — это столбец источника, который будет пересекаться с целевым.
  • Переменные: позволяет выбрать данные из источника, которые будут агрегированы и добавлены в цель. Каждой добавленной переменной должен быть назначен метод агрегирования. Вы можете добавить одну и ту же переменную, используя разные методы агрегирования. На данный момент поддерживаются только числовые переменные.
    • для подписок Каталог Данных переменные можно выбирать из переменных КД подписки, идентифицируемых их переменным slug;
    • для других источников это столбцы исходной таблицы.

Выходы

  • Результирующая таблица [Table]

Обогащение H3 сетки

Описание

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

  • Цель (которая является верхним входным соединением этого компонента) должна иметь столбец, содержащий индексы H3, которые будут использоваться для соединения с источником.
  • Источником (нижнее входное соединение) может быть либо подписка Epsilon Каталога Данных, либо таблица (или результат другого компонента) со столбцом индекса H3.

Для операции обогащения требуется Epsilon Analytics Toolbox, и будет вызвана одна из следующих процедур:

  • DATAOBS_ENRICH_GRID если источником является подписка Каталога Данных
  • ENRICH_GRID в противном случае

Входы

  • Целевой географический столбец: это целевой столбец, который будет использоваться для соединения с источником и выбора строк, которые будут агрегироваться для каждой целевой строки.
  • Исходный географический столбец: (необходим только для источников, отличных от КД) — это столбец источника, который будет соединяться с целевым.
  • Переменные: позволяет выбрать данные из источника, которые будут агрегированы и добавлены в цель. Каждой добавленной переменной должен быть назначен метод агрегирования. Вы можете добавить одну и ту же переменную, используя разные методы агрегирования. На данный момент поддерживаются только числовые переменные.
    • для подписок Каталог Данных переменные можно выбирать из переменных КД подписки, идентифицируемых их переменным slug;
    • для других источников это столбцы исходной таблицы.

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

  • Учет соседних: размер k-кольца, к которому будет применяться функция затухания. Это значение может быть равно 0, и в этом случае k-кольцо вычисляться не будет и функция затухания не будет применяться.
  • Коэфф. затухания: функция распада для агрегирования и сглаживания данных. Поддерживаемые значения uniform: inverse, inverse_squareи exponential.

Выходы

  • Результирующая таблица [Table]

Обучение модели

Описание

Этот компонент обучает модель на исходных данных.

Входы

  • Исходная таблица
  • Переменные: Столбцы, содержащие переменные, которые необходимо учитывать при обучении модели
  • Целевая переменная: Столбeц, содержащий целевое значение

Выходы

Процедура выведет следующее:

  • Модель: содержит обученную модель, которая будет использоваться для прогнозирования дохода. Название модели включает _revenue_model.

  • Сформированная таблица: содержит список функций и их соответствие модели. Имя таблицы включает _revenue_model_shap.

  • Таблица статистики: содержит статистику модели (средняя_ошибка, дисперсия и т. д.). Имя таблицы включает _revenue_model_stats.

Прогноз значения

Описание

Этот компонент предсказывает значение на основе обученной модели.

Входы

  • Таблица с моделью
  • Таблица с данными для предсказания

Выходы

  • Результирующая таблица [Table]

ML генерация текста

Описание

Этот компонент строит текстовое описание данных с учетом заданного вопроса.

Входы

  • Таблица с исходными данными
  • Модель: идентификатор модели, которая будет использоваться для генерации ответа. Параметр содержит идентификатор каталога Yandex
  • Столбец с данными
  • Температура: чем выше значение этого параметра, тем более креативными и случайными будут ответы модели. Принимает значения от 0 (включительно) до 1 (включительно). Значение по умолчанию: 0.3.

Выходы

  • Результирующая таблица [Table]

Векторная БД PostgreSQL

Описание

Этот компонент позволяет преобразовать текстовые данные, хранящиеся в вашей таблице, во встраивания (embeddings), а затем сохранить эти встраивания в виде векторов в вашей векторной базе данных PostgreSQL.

Входы

  • Таблица с исходными данными
  • Имя вектора
  • Размер вектора
  • Поле контента
  • Дополнительные поля
  • Ключ доступа
  • ID облака

Выходы

  • Результирующая таблица [Table]

Агент AI

Описание

Это автономная система, которая получает данные, принимает рациональные решения и действует в своей среде для достижения определенных целей. Среда агента ИИ — это все, к чему агент может получить доступ, кроме самого агента, что может включать запросы клиентов, инструменты или другой контекст.

Входы

  • Доступные агенты
    • Инструментальный агент: этот агент использует внешние инструменты и API для выполнения действий и извлечения информации. Он может понимать возможности различных инструментов и определять, какой инструмент использовать в зависимости от задачи. Этот агент помогает интегрировать LLM с различными внешними службами и базами данных.
    • Разговорный агент: Этот агент ведет разговоры, похожие на человеческие. Он может поддерживать контекст, понимать намерения пользователя и давать соответствующие ответы. Этот агент обычно используется для создания чат-ботов, виртуальных помощников и систем поддержки клиентов. Если предпочитаемая вами модель ИИ не поддерживает вызов инструментов или вы обрабатываете более простые взаимодействия, этот агент — хороший вариант.
    • Голосовой AI агент
    • Агент функций OpenAi: используйте этот агент с моделью функций OpenAI . С этим агентом необходимо использовать модель чата OpenAI .
    • Агент по планированию и исполнению: этот агент создает высокоуровневый план для решения поставленной задачи, а затем выполняет его шаг за шагом. Он наиболее полезен для задач, требующих структурированного подхода и тщательного планирования.
    • ReAct агент: этот агент рассуждает о заданной задаче, определяет необходимые действия, а затем выполняет их. Он следует циклу рассуждений и действий, пока не завершит задачу. Агент ReAct может разбивать сложные задачи на более мелкие подзадачи, расставлять их по приоритетам и выполнять их одну за другой.
    • Агент SQL : Этот агент использует базу данных SQL в качестве источника данных. Он может понимать вопросы на естественном языке, преобразовывать их в запросы SQL, выполнять запросы и представлять результаты в удобном для пользователя формате. Этот агент ценен для создания интерфейсов на естественном языке для баз данных.

Open AI

Описание

Используйте узел OpenAI для автоматизации работы в OpenAI и интеграции OpenAI с другими приложениями. Epsilon имеет встроенную поддержку широкого спектра функций OpenAI, включая создание изображений и помощников, а также общение с моделями.

Входы

  • Ресурсы:
    • Помощник
    • Текст
    • Картинка
    • Аудио
    • Файл

Помощник

Используйте эту операцию для создания, удаления, перечисления, сообщения или обновления помощника в OpenAI. Обратитесь к OpenAI для получения дополнительной информации о самом узле OpenAI.

Создать помощника
Используйте эту операцию для создания нового помощника.

Введите следующие параметры:

  • Учетные данные для подключени: создайте или выберите существующие учетные данные OpenAI .
  • Ресурс: Выберите помощника.
  • Операция: Выберите «Создать помощника».
  • Модель: выберите модель, которую будет использовать помощник. Если вы не уверены, какую модель использовать, попробуйте gpt-4o, нужен ли вам высокий интеллект или gpt-4o-mini вам нужна самая высокая скорость и самая низкая стоимость.
  • Имя: Введите имя помощника. Максимальная длина — 256 символов.
  • Описание: Введите описание помощника. Максимальная длина — 512 символов.
Виртуальный ассистент, который помогает пользователям выполнять ежедневные задачи, включая установку напоминаний, ответы на общие вопросы и быстрое предоставление информации.
  • Инструкции: введите системные инструкции, которые использует помощник. Максимальная длина — 32 768 символов. Используйте это, чтобы указать персону, используемую моделью в своих ответах.
Всегда отвечайте дружелюбно и привлекательно. Когда пользователь задает вопрос, сначала дайте краткий ответ, а затем, при необходимости, краткое объяснение или дополнительный контекст. Если вопрос носит открытый характер, внесите предложение или задайте уточняющий вопрос, чтобы направить беседу в нужное русло. Поддерживайте позитивный и поддерживающий тон и избегайте технического жаргона, если только пользователь специально не попросит вас об этом.
  • Интерпретатор кода: Включите, чтобы включить интерпретатор кода для помощника, где он может писать и выполнять код в среде sandbox. Включите этот инструмент для задач, требующих вычислений, анализа данных или любой обработки на основе логики.
  • Извлечение знаний: включите, чтобы включить извлечение знаний для помощника, что позволит ему получить доступ к внешним источникам или подключенной базе знаний. Для получения дополнительной информации обратитесь к разделу Поиск файлов | Платформа OpenAI .
  • Файлы: Выберите файл для загрузки для вашего внешнего источника знаний. Используйте операцию «Загрузить файл» , чтобы добавить больше файлов.

Дополнительные параметры

  • Выходная случайность (температура): отрегулируйте случайность ответа. Диапазон находится между 0.0(детерминированным) и 1.0(максимальной случайностью). Мы рекомендуем изменить это или Выходную случайность (верхний P), но не оба. Начните со средней температуры (около 0,7) и отрегулируйте на основе наблюдаемых выходных данных. Если ответы слишком повторяющиеся или жесткие, увеличьте температуру. Если они слишком хаотичные или не в порядке, уменьшите ее. По умолчанию 1.0.
  • Выходная случайность (Top P): отрегулируйте настройку Top P, чтобы контролировать разнообразие ответов помощника. Например, 0.5означает, что рассматривается половина всех вариантов с весовыми коэффициентами вероятности. Мы рекомендуем изменить это или выходную случайность (температура), но не оба. По умолчанию 1.0.
  • Ошибка, если помощник уже существует: если этот параметр включен, операция завершится ошибкой, если помощник с таким именем уже существует.

Удалить помощника
Используйте эту операцию для удаления существующего помощника из вашей учетной записи.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI .
  • Ресурс: Выберите помощника.
  • Операция: Выберите Удалить помощника.
  • Помощник: выберите помощника из списка, которого хотите удалить.

Список помощников
Используйте эту операцию для получения списка помощников в вашей организации.

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI .
  • Ресурс: Выберите помощника.
  • Операция: Выберите Список помощников.

Дополнительные параметры

  • Упростить вывод: включите, чтобы вернуть упрощенную версию ответа вместо необработанных данных. Эта опция включена по умолчанию.

Написать помощнику
Используйте эту операцию, чтобы отправить сообщение помощнику и получить ответ.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите помощника.
  • Операция: Выберите «Отправить сообщение помощнику».
  • Помощник: выберите помощника, которому вы хотите отправить сообщение.
  • Подсказка: введите текстовую подсказку или сообщение, которое вы хотите отправить помощнику.
    • Узел триггера подключенного чата: автоматически использует входные данные из поля предыдущего узла chatInput.
    • Определить ниже: вручную определите подсказку, введя статический текст или используя выражение для ссылки на данные из предыдущих узлов.

Дополнительные параметры

  • Базовый URL: введите базовый URL, который помощник должен использовать для выполнения запросов API. Эта опция полезна для указания помощнику использовать конечные точки, предоставляемые другими поставщиками LLM, которые предлагают совместимый с OpenAI API.
  • Максимальное количество повторов: укажите, сколько раз помощник должен повторить операцию в случае сбоя.
  • Тайм-аут: Установите максимальное время в миллисекундах, в течение которого помощник должен ждать ответа до тайм-аута. Используйте эту опцию, чтобы предотвратить долгое ожидание во время операций.
  • Сохранить оригинальные инструменты: отключите, чтобы удалить оригинальные инструменты, связанные с помощником. Используйте это, если вы хотите временно удалить инструменты для этой конкретной операции.

Обновить помощника
Используйте эту операцию для обновления данных существующего помощника.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите помощника.
  • Операция: Выберите Обновить помощника .
  • Помощник: выберите помощника, которому вы хотите отправить сообщение.

Дополнительные параметры

  • Интерпретатор кода: Включите, чтобы включить интерпретатор кода для помощника, где он может писать и выполнять код в среде sandbox. Включите этот инструмент для задач, требующих вычислений, анализа данных или любой обработки на основе логики.
  • Описание: Введите описание помощника. Максимальная длина — 512 символов.
Виртуальный ассистент, который помогает пользователям выполнять ежедневные задачи, включая установку напоминаний, ответы на общие вопросы и быстрое предоставление информации.
  • Инструкции: введите системные инструкции, которые использует помощник. Максимальная длина — 32 768 символов. Используйте это, чтобы указать персону, используемую моделью в своих ответах.
Всегда отвечайте дружелюбно и привлекательно. Когда пользователь задает вопрос, сначала дайте краткий ответ, а затем, при необходимости, краткое объяснение или дополнительный контекст. Если вопрос носит открытый характер, внесите предложение или задайте уточняющий вопрос, чтобы направить беседу в нужное русло. Поддерживайте позитивный и поддерживающий тон и избегайте технического жаргона, если только пользователь специально не попросит вас об этом.
  • Извлечение знаний: включите, чтобы включить извлечение знаний для помощника, что позволит ему получить доступ к внешним источникам или подключенной базе знаний. Для получения дополнительной информации обратитесь к разделу Поиск файлов | Платформа OpenAI.
  • Файлы: Выберите файл для загрузки для вашего внешнего источника знаний. Используйте операцию «Загрузить файл» , чтобы добавить больше файлов.
  • Модель: выберите модель, которую будет использовать помощник. Если вы не уверены, какую модель использовать, попробуйте gpt-4o, нужен ли вам высокий интеллект или gpt-4o-mini вам нужна самая высокая скорость и самая низкая стоимость.
  • Имя: Введите имя помощника. Максимальная длина — 256 символов.
  • Удалить все пользовательские инструменты (функции): включите, чтобы удалить все пользовательские инструменты (функции) из помощника.
  • Выходная случайность (температура): отрегулируйте случайность ответа. Диапазон находится между 0.0(детерминированным) и 1.0(максимальной случайностью). Мы рекомендуем изменить это или Выходную случайность (верхний P), но не оба. Начните со средней температуры (около 0,7) и отрегулируйте на основе наблюдаемых выходных данных. Если ответы слишком повторяющиеся или жесткие, увеличьте температуру. Если они слишком хаотичные или не в порядке, уменьшите ее. По умолчанию 1.0.
  • Выходная случайность (Top P): отрегулируйте настройку Top P, чтобы контролировать разнообразие ответов помощника. Например, 0.5означает, что рассматривается половина всех вариантов с весовыми коэффициентами вероятности. Мы рекомендуем изменить это или выходную случайность (температура), но не оба. По умолчанию 1.0.

Текст

Используйте эту операцию для сообщения модели или классификации текста для нарушений в OpenAI. Обратитесь к OpenAI для получения дополнительной информации о самом узле OpenAI.

Написать сообщение модели
Используйте эту операцию для отправки сообщения или запроса модели OpenAI и получения ответа.

Введите следующие параметры:

  • Учетные данные для подключени: создайте или выберите существующие учетные данные OpenAI .

  • Ресурс: Выберите текст .

  • Операция: Выберите «Отправить сообщение модели».

  • Модель: выберите модель, которую хотите использовать. Если вы не уверены, какую модель использовать, попробуйте gpt-4o, нужен ли вам высокий интеллект или gpt-4o-mini вам нужна самая высокая скорость и самая низкая стоимость.

  • Сообщения: введите текстовое приглашение и назначьте роль , которую модель будет использовать для генерации ответов. Обратитесь к разделу Разработка приглашений | OpenAI для получения дополнительной информации о том, как написать лучшее приглашение с помощью этих ролей. Выберите одну из этих ролей:

    • Пользователь : отправляет сообщение как пользователь и получает ответ от модели.
    • Помощник : говорит модели, как принять определенный тон или личность.
    • Система : По умолчанию системное сообщение — “Вы очень полезный помощник”. Вы можете определить инструкции в пользовательском сообщении, но инструкции, заданные в системном сообщении, более эффективны. Вы можете задать только одно системное сообщение на разговор. Используйте это, чтобы задать поведение модели или контекст для следующего пользовательского сообщения.

  • Упростить вывод : включите, чтобы вернуть упрощенную версию ответа вместо необработанных данных.

  • Выводить содержимое как JSON : Включите, чтобы попытаться вернуть ответ в формате JSON. Совместимо с GPT-4 Turbo и всеми GPT-3.5 Turbo моделями новее gpt-3.5-turbo-1106.

Дополнительные параметры

  • Штраф за частоту: применить штраф, чтобы уменьшить тенденцию модели повторять похожие строки. Диапазон составляет от 0.0до 2.0.
  • Максимальное количество токенов: установите максимальное количество токенов для ответа. Один токен примерно равен четырем символам для стандартного английского текста. Используйте это, чтобы ограничить длину вывода.
  • Количество завершений: по умолчанию 1. Установите количество завершений, которые вы хотите сгенерировать для каждого запроса. Используйте осторожно, так как установка большого числа быстро израсходует ваши токены.
  • Штраф за присутствие: Применить штраф, чтобы повлиять на модель для обсуждения новых тем. Диапазон составляет от 0.0до 2.0.
  • Случайность выходных данных (температура): отрегулируйте случайность ответа. Диапазон находится между 0.0(детерминированным) и 1.0(максимальной случайностью). Мы рекомендуем изменить это или Случайность выходных данных (верхняя точка P) , но не оба. Начните со средней температуры (около 0.7) и отрегулируйте на основе наблюдаемых выходных данных. Если ответы слишком повторяющиеся или жесткие, увеличьте температуру. Если они слишком хаотичные или не соответствуют траектории, уменьшите ее. По умолчанию 1.0.
  • Выходная случайность (Top P): отрегулируйте настройку Top P, чтобы контролировать разнообразие ответов помощника. Например, 0.5означает, что рассматривается половина всех вариантов с весовыми коэффициентами вероятности. Мы рекомендуем изменить это или выходную случайность (температура) , но не оба. По умолчанию 1.0.

Классифицировать текст на предмет нарушений
Используйте эту операцию для идентификации и пометки контента, который может быть вредоносным. Модель OpenAI проанализирует текст и вернет ответ, содержащий:

  • flagged: Логическое поле, указывающее, является ли содержимое потенциально опасным.
  • categories: Список флагов нарушений, специфичных для категорий.
  • category_scores: Баллы по каждой категории.

Введите следующие параметры:

  • Учетные данные для подключени: создайте или выберите существующие учетные данные OpenAI .
  • Ресурс: Выберите текст .
  • Операция: Выберите «Классифицировать текст на предмет нарушений».
  • Ввод текста: введите текст, который необходимо классифицировать, если он нарушает политику модерации.
  • Упростить вывод: включите, чтобы вернуть упрощенную версию ответа вместо необработанных данных.

Дополнительные параметры

  • Использовать стабильную модель: включите, чтобы использовать стабильную версию модели вместо последней версии, точность может быть немного ниже.

Картинка

Используйте эту операцию для анализа или генерации изображения в OpenAI. Обратитесь к OpenAI для получения дополнительной информации о самом узле OpenAI.

Анализ изображения
Используйте эту операцию, чтобы делать снимки и отвечать на вопросы по ним.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI .
  • Ресурс: Выберите изображение.
  • Операция: Выберите Анализ изображения.
  • Модель: выберите модель, которую вы хотите использовать для создания изображения.
  • Ввод текста: задайте вопрос по изображению.
  • Тип ввода: выберите, как вы хотите ввести изображение. Возможные варианты:
    • URL-адрес(ы) изображения: введите URL-адрес(а) изображения(й) для анализа. Добавьте несколько URL-адресов в список, разделенный запятыми.
    • Двоичные файлы: введите имя двоичного свойства, содержащего изображение(я), в поле «Имя поля входных данных» .

Дополнительные параметры

  • Подробно: укажите баланс между временем отклика и использованием токена.
  • Длина описания (макс. количество токенов): по умолчанию 300. Меньшее количество токенов приведет к более короткому и менее подробному описанию изображения.

Создать изображение
Используйте эту операцию для создания изображения из текстовой подсказки.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите изображение.
  • Операция: Выберите «Создать изображение».
  • Модель : выберите модель, которую вы хотите использовать для создания изображения.
  • Запрос : Введите текстовое описание желаемого изображения(ий). Максимальная длина составляет 1000 символов для dall-e-2 и 4000 символов для dall-e-3.

Дополнительные параметры

  • Качество : качество создаваемого вами изображения. HD создает изображения с более мелкими деталями и большей согласованностью по всему изображению. Этот параметр поддерживается только для dall-e-3. В противном случае выберите Standard .
  • Разрешение : Выберите разрешение сгенерированных изображений. Выберите 1024x1024 для dall-e-2. Выберите одно из 1024x1024, 1792x1024 или 1024x1792 для dall-e-3 моделей.
  • Стиль : Выберите стиль сгенерированных изображений. Эта опция поддерживается только для dall-e-3.
    • Естественный : используйте этот параметр для создания более естественных изображений.
    • Яркий : используйте этот режим для создания гиперреалистичных и драматичных изображений.
  • Ответить URL-адресами изображений : следует ли возвращать URL-адреса изображений вместо двоичных файлов.
  • Поместить вывод в поле : по умолчанию data. Введите имя поля вывода, в которое нужно поместить двоичные данные файла. Доступно только в том случае, если отключен параметр «Ответить с URL-адресами изображений» .

Аудио

Используйте эту операцию для генерации аудио или транскрибирования или перевода записи в OpenAI. Обратитесь к OpenAI для получения дополнительной информации о самом узле OpenAI.

Генерировать аудио
Используйте эту операцию для создания звука из текстовой подсказки.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Аудио .
  • Операция: Выберите «Создать аудио» .
  • Модель: Выберите модель, которую вы хотите использовать для генерации звука. Для получения дополнительной информации обратитесь к TTS | OpenAI .
    • TTS-1: используйте этот параметр для оптимизации скорости.
    • TTS-1-HD: используйте этот параметр для оптимизации качества.
  • Ввод текста: введите текст для создания аудио. Максимальная длина — 4096 символов.
  • Голос: выберите голос для использования при генерации звука.

Дополнительные параметры

  • Формат ответа: выберите формат для аудиоответа. Выберите из MP3 (по умолчанию), OPUS , AAC , FLAC , WAV и PCM.
  • Скорость звука: введите скорость для сгенерированного звука в диапазоне от 0.25 до 4.0. По умолчанию 1.
  • Поместить вывод в поле: по умолчанию data. Введите имя поля вывода, в которое нужно поместить двоичные данные файла.

Транскрибировать запись
Используйте эту операцию для транскрибирования аудио в текст. API OpenAI ограничивает размер аудиофайла 25 МБ. OpenAI будет использовать whisper-1модель по умолчанию.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Аудио .
  • Операция:Выберите «Транскрибировать запись» .
  • Имя поля входных данных : по умолчанию data. Введите имя двоичного свойства, содержащего аудиофайл, в одном из следующих форматов: .flac, .mp3, .mp4, .mpeg, .mpga, .m4a, .ogg, .wav, или .webm.

Дополнительные параметры

  • Язык аудиофайла: введите язык входного аудио в формате ISO-639-1 . Используйте эту опцию для повышения точности и уменьшения задержки.
  • Случайность выходных данных (температура): по умолчанию 1.0. Отрегулируйте случайность ответа. Диапазон находится между 0.0(детерминированным) и 1.0(максимальной случайностью). Мы рекомендуем изменить это или Случайность выходных данных (верхний P) , но не оба. Начните со средней температуры (около 0,7) и отрегулируйте на основе наблюдаемых выходных данных. Если ответы слишком повторяющиеся или жесткие, увеличьте температуру. Если они слишком хаотичны или не соответствуют траектории, уменьшите ее.

Перевести запись
Используйте эту операцию для перевода аудио на английский язык. API OpenAI ограничивает размер аудиофайла 25 МБ. OpenAI будет использовать whisper-1модель по умолчанию.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Аудио .
  • Операция: Выберите «Перевести запись» .
  • Имя поля входных данных: по умолчанию data. Введите имя двоичного свойства, содержащего аудиофайл, в одном из следующих форматов: .flac, .mp3, .mp4, .mpeg, .mpga, .m4a, .ogg, .wav, или .webm.

Дополнительные параметры

  • Случайность выходных данных (температура): по умолчанию 1.0. Отрегулируйте случайность ответа. Диапазон находится между 0.0(детерминированным) и 1.0(максимальной случайностью). Мы рекомендуем изменить это или Случайность выходных данных (верхний P) , но не оба. Начните со средней температуры (около 0,7) и отрегулируйте на основе наблюдаемых выходных данных. Если ответы слишком повторяющиеся или жесткие, увеличьте температуру. Если они слишком хаотичны или не соответствуют траектории, уменьшите ее.

Файл

Используйте эту операцию для создания, удаления, перечисления, сообщения или обновления файла в OpenAI. Обратитесь к OpenAI для получения дополнительной информации о самом узле OpenAI.

Удалить файл
Используйте эту операцию для удаления файла с сервера.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Файл .
  • Операция: Выберите Удалить файл .
  • Файл: введите идентификатор файла, который будет использоваться для этой операции, или выберите имя файла из раскрывающегося списка.

Список файлов
Используйте эту операцию для вывода списка файлов, принадлежащих организации пользователя.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Файл .
  • Операция: Выберите «Список файлов» .

Дополнительные параметры

  • Цель: Используйте это, чтобы вернуть только файлы с заданной целью. Используйте Assistants , чтобы вернуть только файлы, связанные с Assistants и операциями Message. Используйте Fine-Tune для файлов, связанных с Fine-tuning .

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

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные OpenAI.
  • Ресурс: Выберите Файл .
  • Операция: Выберите «Загрузить файл» .
  • Имя поля входных данных: по умолчанию data. Введите имя двоичного свойства, содержащего файл. Размер отдельных файлов может быть максимум 512 МБ или 2 миллиона токенов для помощников.

Дополнительные параметры

  • Цель: введите предполагаемую цель загружаемого файла. Используйте Ассистенты для файлов, связанных с Ассистенты и операциями с сообщениями. Используйте Fine-Tune для тонкой настройки .

GigaChat

Описание

Используйте узел GigaChat для автоматизации работы в GigaChat и интеграции GigaChat с другими приложениями.

Хранилище векторов квадранта

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

На этой странице вы найдете параметры узла Qdrant и ссылки на дополнительные ресурсы.

Модели использования узлов
Узел хранилища векторов Qdrant можно использовать в следующих шаблонах.

Использовать как обычный узел для вставки и извлечения документов.#
Вы можете использовать Qdrant Vector Store как обычный узел для вставки или получения документов. Этот шаблон помещает Qdrant Vector Store в обычный поток соединений без использования агента.

Пример этого вы можете увидеть в первой части этого шаблона .

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

Здесь соединение будет следующим: агент ИИ (коннектор инструментов) -> узел хранилища векторов Qdrant.

Параметры узла

Режим работы

Этот узел векторного хранилища имеет четыре режима: Получение множества, Вставить документы, Извлекать документы (как векторное хранилище для цепочки/инструмента) и Извлекать документы (как инструмент для агента искусственного интеллекта). Выбранный вами режим определяет операции, которые вы можете выполнять с узлом, а также доступные входы и выходы.

Получение множества

В этом режиме вы можете извлечь несколько документов из вашей векторной базы данных, указав подсказку. Подсказка будет встроена и использована для поиска по схожести. Узел вернет документы, которые наиболее похожи на подсказку, с их оценкой схожести. Это полезно, если вы хотите извлечь список похожих документов и передать их агенту в качестве дополнительного контекста.

Вставить документы
Используйте режим «Вставка документов» для вставки новых документов в вашу векторную базу данных.

Извлечение документов (как векторное хранилище для цепи/инструмента)
Используйте режим Извлекать документы (как векторное хранилище для цепочки/инструмента) с извлекателем векторного хранилища для извлечения документов из векторной базы данных и предоставления их извлекателю, подключенному к цепочке. В этом режиме необходимо подключить узел к узлу извлекателя или корневому узлу.

Извлечение документов (как инструмент для агента ИИ)
Используйте режим Извлекать документы (как инструмент для агента искусственного интеллекта) для использования векторного хранилища в качестве ресурса инструмента при ответе на запросы. При формулировании ответов агент использует векторное хранилище, когда имя и описание векторного хранилища соответствуют деталям вопроса.

Получить множество, параметры

  • Название коллекции Qdrant: введите название коллекции Qdrant, которую вы хотите использовать.
  • Подсказка: введите поисковый запрос.
  • Лимит: Введите количество результатов, которые нужно получить из хранилища векторов. Например, установите это значение, 10 чтобы получить десять лучших результатов.

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

Вставить документы, параметры

  • Название коллекции Qdrant : введите название коллекции Qdrant, которую вы хотите использовать.
    Этот режим работы включает в себя одну опцию узла :

  • Конфигурация коллекции : введите параметры JSON для создания конфигурации создания коллекции Qdrant. Для получения дополнительной информации обратитесь к документации по коллекциям Qdrant.

Извлекать документы (как векторное хранилище для цепочки/инструмента), параметры

  • Коллекция Qdrant: введите название коллекции Qdrant, которую вы хотите использовать.
    Этот режим работы включает в себя одну опцию узла — фильтр метаданных .

Извлекать документы (как инструмент для агента искусственного интеллекта), параметры

  • Имя: Имя векторного хранилища.
  • Описание: Объясните LLM, что делает этот инструмент. Хорошее, конкретное описание позволяет LLM чаще получать ожидаемые результаты.
  • Коллекция Qdrant: введите название коллекции Qdrant, которую вы хотите использовать.
  • Лимит: Введите количество результатов, которые нужно получить из хранилища векторов. Например, установите это значение, 10 чтобы получить десять лучших результатов.

S3 хранилище

Описание

Используйте этот компонент для автоматизации работы в S3 и интеграции S3 с другими компонентами.

Операции

  • Хранилище

    • Создать хранилище
    • Удалить хранилище
    • Получить все ведра
    • Поиск в корзине

  • Файл

    • Скопировать файл
    • Удалить файл
    • Загрузить файл
    • Получить все файлы
    • Загрузить файл

  • Папка

    • Создать папку
    • Удалить папку
    • Получить все папки

Телеграм

Описание

Используйте узел Телеграм для автоматизации работы в Телеграм и интеграции Telegram с другими приложениями.

  • Ресурсы:
    • Чат
    • Обратный вызов
    • Файл
    • Сообщение

Чат

Используйте эти операции, чтобы получить информацию о чатах, участниках, администраторах, покинуть чат и задать заголовки и описания чатов. Обратитесь к Telegram для получения дополнительной информации о самом узле Telegram.

Получить чат
Используйте эту операцию для получения актуальной информации о чате с помощью метода Bot API getChat .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите Получить.
  • Идентификатор чата: введите идентификатор чата или имя пользователя целевого канала в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.

Получить администраторов
Используйте эту операцию для получения списка всех администраторов в чате с помощью метода API бота getChatAdministrators .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите Получить администраторов .
  • Идентификатор чата: введите идентификатор чата или имя пользователя целевого канала в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
      Более подробную информацию можно найти в документации API Telegram Bot getChatAdministrators .

Получить чат-участника
Используйте эту операцию для получения данных об участнике чата с помощью метода API бота getChatMember.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите Получить участника .
  • Идентификатор чата: введите идентификатор чата или имя пользователя целевого канала в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Идентификатор пользователя: введите уникальный идентификатор пользователя, информацию о котором вы хотите получить.

Покинуть
Используйте эту операцию, чтобы покинуть чат с помощью метода API бота leaveChat.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите «Покинуть» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.

Добавить описание
Используйте эту операцию для установки описания чата с помощью метода Bot API setChatDescription.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите Установить описание .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Описание: введите новое описание, которое вы хотите использовать в чате, максимум 255 символов.

Добавить заголовок
Используйте эту операцию для установки заголовка чата с помощью метода Bot API setChatTitle .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram .
  • Ресурс: Выберите Чат.
  • Операция: Выберите Установить заголовок .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Заголовок: введите новый заголовок, который вы хотите использовать в чате, максимум 255 символов.

Обратный вызов

Используйте эти операции для ответа на запросы обратного вызова, отправленные с клавиатуры или запросов в строке. Обратитесь к Telegram для получения дополнительной информации о самом узле Telegram.

Ответ на запрос
Используйте эту операцию для отправки ответов на запросы обратного вызова, отправленные со встроенных клавиатур, с помощью метода API бота answerCallbackQuery.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: выберите Обратный вызов.
  • Операция: Выберите Ответить на запрос .
  • Идентификатор запроса: введите уникальный идентификатор запроса, на который вы хотите ответить.
    • Чтобы передать идентификатор запроса непосредственно в этот узел, используйте узел триггера Telegram, запущенный по запросу обратного вызова.
  • Результаты: введите JSON-сериализованный массив результатов, которые вы хотите использовать в качестве ответов на запрос. Обратитесь к документации Telegram InlineQueryResults для получения дополнительной информации о форматировании вашего массива.

Ответ на встроенный запрос
Используйте эту операцию для отправки ответов на запросы обратного вызова, отправленные из встроенных запросов с использованием метода API бота answerInlineQuery .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: выберите Обратный вызов.
  • Операция: Выберите «Ответить на встроенный запрос» .
  • Идентификатор запроса: введите уникальный идентификатор запроса, на который вы хотите ответить.
    • Чтобы передать идентификатор запроса непосредственно в этот узел, используйте узел триггера Telegram, запущенный на встроенном запросе .
  • Результаты: введите JSON-сериализованный массив результатов, которые вы хотите использовать в качестве ответов на запрос. Обратитесь к документации Telegram InlineQueryResults для получения дополнительной информации о форматировании вашего массива.

Telegram допускает максимум 50 результатов на один запрос.

Дополнительные параметры

  • Время кэширования: Введите максимальное время в секундах, в течение которого клиент может кэшировать результат запроса обратного вызова. Telegram по умолчанию использует 0 секунды для этого метода.
  • Показать оповещение: Telegram может отображать ответ как уведомление в верхней части экрана чата или как оповещение. Выберите, хотите ли вы сохранить отображение уведомления по умолчанию (отключено) или отображать ответ как оповещение (включено).
  • Текст: Если вы хотите, чтобы ответ отображал текст, введите здесь до 200 символов текста.
  • URL: Введите URL, который будет открыт клиентом пользователя. Обратитесь к инструкциям по параметру url в документации Telegram Bot API answerCallbackQuery для получения дополнительной информации.

Файл

Используйте эту операцию для получения файла из Telegram. Обратитесь к Telegram для получения дополнительной информации о самом узле Telegram.

Получить файл
Используйте эту операцию для получения файла из Telegram с помощью метода Bot API getFile.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите Файл.
  • Операция: Выберите Получить.
  • Идентификатор файла: введите идентификатор файла, который вы хотите получить.
  • Загрузка: выберите, хотите ли вы, чтобы узел загружал файл (включено) или нет (выключено).

Сообщение

Используйте эти операции для отправки, редактирования и удаления сообщений в чате; отправки файлов в чат; и закрепления/открепления сообщения в чате. Обратитесь к Telegram для получения дополнительной информации о самом узле Telegram.

Удалить сообщение
Используйте эту операцию для удаления сообщения из чата с помощью метода API бота deleteMessage.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите Удалить сообщение чата.
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Идентификатор сообщения: введите уникальный идентификатор сообщения, которое вы хотите удалить.

Редактировать текст сообщения
Используйте эту операцию для редактирования текста существующего сообщения с помощью метода editMessageText API бота .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Редактировать текст сообщения» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Идентификатор сообщения: введите уникальный идентификатор сообщения, которое вы хотите отредактировать.
  • Разметка ответа: выберите, использовать ли Inline Keyboard для отображения InlineKeyboardMarkup None не использовать. Это устанавливает reply_markupпараметр.
  • Текст: введите текст, который вы хотите изменить в сообщении.

Дополнительные параметры

  • Отключить предварительный просмотр веб-страницы: выберите, хотите ли вы включить предварительный просмотр ссылок в этом сообщении (выключено) или отключить предварительный просмотр ссылок в этом сообщении (включено). Это устанавливает link_preview_options параметр для is_disabled.
  • Режим синтаксического анализа: Выберите, будет ли сообщение анализироваться с использованием HTML (по умолчанию), Markdown (Legacy) или MarkdownV2 . Это устанавливает parse_mode параметр.

Прикрепить сообщение в чате

Используйте эту операцию для закрепления сообщения в чате с помощью метода API бота pinChatMessage.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите Закрепить сообщение чата .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Идентификатор сообщения: введите уникальный идентификатор сообщения, которое вы хотите отредактировать.

Дополнительные параметры

  • Отключить уведомления: по умолчанию Telegram уведомит всех участников чата о том, что сообщение закреплено. Если вы не хотите, чтобы эти уведомления выходили, включите этот элемент управления. Устанавливает disable_notification параметр на true.

Отправить анимацию
Используйте эту операцию для отправки GIF-файлов или видео H.264/MPEG-4 AVC без звука размером до 50 МБ в чат с помощью метода sendAnimation API бота .

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить анимацию» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Анимация: Если вы не используете двоичный файл , введите анимацию для отправки здесь. Передайте file_id, чтобы отправить файл, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса. Подробнее об этих параметрах и их использовании см. в разделе Параметры разметки ответа.

Дополнительные параметры

  • Подпись: введите текст подписи для анимации, не более 1024 символов.
  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Длительность: введите длительность анимации в секундах.
  • Высота: введите высоту анимации.
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения : если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения : введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.
  • Эскиз: Добавить миниатюру отправленного файла. Игнорируйте это поле, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна соответствовать следующим спецификациям:
    • Формат JPEG
    • Размер менее 200 КБ
    • Ширина и высота менее 320 пикселей.
  • Ширина: введите ширину видеоклипа.

Отправить аудио
Используйте эту операцию для отправки аудиофайла в чат и отображения его в музыкальном проигрывателе с помощью метода API бота sendAudio.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить аудио» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Аудио: Если вы не используете двоичный файл , введите аудио для отправки здесь. Передайте a file_idдля отправки файла, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса. Подробнее об этих параметрах и их использовании см. в разделе Параметры разметки ответа.

Дополнительные параметры

  • Подпись: введите текст подписи для анимации, не более 1024 символов.
  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Длительность: введите длительность анимации в секундах.
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Исполнитель : Введите имя исполнителя.
  • Идентификатор темы сообщения : введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.
  • Название: введите название звуковой дорожки.
  • Эскиз: Добавить миниатюру отправленного файла. Игнорируйте это поле, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна соответствовать следующим спецификациям:
    • Формат JPEG
    • Размер менее 200 КБ
    • Ширина и высота менее 320 пикселей.
  • Ширина: введите ширину видеоклипа.

Отправить действие
Используйте эту операцию, когда вам нужно сообщить пользователю, что что-то происходит на стороне бота. Статус устанавливается на 5 секунд или меньше с помощью метода API бота sendChatAction.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите действие «Отправить чат» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Действие: Выберите действие, которое вы хотите транслировать боту. Здесь доступны следующие параметры: Найти местоположение, Ввод текста, Запись аудио или видео и Загрузка типов файлов.

Отправить документ
Используйте эту операцию для отправки документа в чат с помощью метода API бота sendDocument.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить документ» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Документ: Если вы не используете двоичный файл , введите документ для отправки здесь. Передайте a file_idдля отправки файла, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса. Подробнее об этих параметрах и их использовании см. в разделе Параметры разметки ответа.

Дополнительные параметры

  • Подпись: введите текст подписи для анимации, не более 1024 символов.
  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.
  • Эскиз: Добавить миниатюру отправленного файла. Игнорируйте это поле, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна соответствовать следующим спецификациям:
    • Формат JPEG
    • Размер менее 200 КБ
    • Ширина и высота менее 320 пикселей.
  • Ширина: введите ширину видеоклипа.

Отправить местоположение
Используйте эту операцию для отправки геолокации в чат с помощью метода API бота sendLocation.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите место отправки .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Широта: введите широту местоположения.
  • Долгота: введите долготу местоположения.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса.

Дополнительные параметры

  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.

Отправить медиа-группу
Используйте эту операцию для отправки группы фотографий и/или видео с помощью метода API бота sendMediaGroup.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить медиагруппу» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Media: Используйте Add Media для добавления различных типов медиа в вашу медиа-группу. Для каждого медиа выберите:
  • Тип: Тип носителя. Выберите из Фото и Видео .
  • Файл мультимедиа: введите файл мультимедиа для отправки. Передайте a file_idдля отправки файла, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Дополнительные поля : для каждого медиафайла вы можете добавить следующие поля:
    • Подпись: введите текст подписи к файлу (максимум 1024 символа).
    • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .

Дополнительные параметры

  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.

Отправить сообщение
Используйте эту операцию для отправки сообщения в чат с помощью метода API бота sendMessage.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить сообщение» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Текст : введите текст для отправки, максимум 4096 символов после анализа сущностей.

Дополнительные параметры

  • Добавить указание авторства: выберите, следует ли добавлять фразу Это сообщение было отправлено автоматически с помощью epsilon в конец сообщения (включено, по умолчанию) или нет (выключено).
  • Отключить уведомление : выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Отключить предварительный просмотр веб-страницы : выберите, хотите ли вы включить предварительный просмотр ссылок в этом сообщении (выключено) или отключить предварительный просмотр ссылок в этом сообщении (включено). Это устанавливает link_preview_optionsпараметр для is_disabled. Более подробную информацию см. в документации LinkPreviewOptions .
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.

Отправить фото
Используйте эту операцию для отправки фотографии в чат с помощью метода API бота sendPhoto.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить фото» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Фото Если вы не используете двоичный файл , введите здесь фотографию для отправки. Передайте a file_idдля отправки файла, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса.

Дополнительные параметры

  • Подпись: введите текст подписи к файлу (максимум 1024 символа).
  • Отключить уведомление : выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.

Отправить стикер
Используйте этот метод для отправки статических .WEBP, анимированных .TGS или видеостикеров .WEBM с помощью метода API бота sendSticker.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить стикер» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Наклейка: Если вы не используете двоичный файл , введите здесь фотографию для отправки. Передайте a file_id для отправки файла, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса.

Дополнительные параметры

  • Отключить уведомление : выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Ответить на идентификатор сообщения: если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения: введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.

Отправить видео
Используйте эту операцию для отправки видео в чат с помощью метода API бота sendVideo.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция: Выберите «Отправить видео» .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Двоичный файл: Чтобы отправить двоичный файл с самого узла, включите эту опцию. Если вы включите этот параметр, вы должны ввести Входное двоичное поле, содержащее файл, который вы хотите отправить.
  • Видео: Если вы не используете двоичный файл , введите видео для отправки здесь. Передайте file_id, чтобы отправить файл, который существует на серверах Telegram (рекомендуется) или HTTP URL для Telegram, чтобы получить файл из интернета.
  • Разметка ответа: используйте этот параметр для установки дополнительных параметров интерфейса.

Дополнительные параметры

  • Подпись: введите текст подписи для анимации, не более 1024 символов.
  • Отключить уведомление: выберите, следует ли отправлять уведомление без звука (включено) или со стандартным уведомлением (выключено).
  • Длительность: введите длительность анимации в секундах.
  • Высота: введите высоту анимации.
  • Режим синтаксического анализа: введите парсер, который будет использоваться для любого связанного текста. Параметры включают HTML (по умолчанию), Markdown (Legacy) , MarkdownV2 . Более подробную информацию об этих параметрах см. в разделе «Параметры форматирования» Telegram .
  • Ответить на идентификатор сообщения : если сообщение является ответом, введите идентификатор сообщения, на которое оно отвечает.
  • Идентификатор темы сообщения : введите уникальный идентификатор целевой темы сообщения на форуме; только для супергрупп форума.
  • Эскиз: Добавить миниатюру отправленного файла. Игнорируйте это поле, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна соответствовать следующим спецификациям:
    • Формат JPEG
    • Размер менее 200 КБ
    • Ширина и высота менее 320 пикселей.
  • Ширина: введите ширину видеоклипа.

Открепить сообщение в чате
Используйте эту операцию для открепления сообщения от чата с помощью метода Bot API unpinChatMessage.

Введите следующие параметры:

  • Учетные данные для подключения: создайте или выберите существующие учетные данные Telegram.
  • Ресурс: Выберите сообщение .
  • Операция:Выберите Закрепить сообщение чата .
  • Идентификатор чата: введите идентификатор чата или имя пользователя канала, который вы хотите покинуть, в формате @channelusername.
    • Чтобы напрямую передать Chat ID в этот узел, используйте узел Telegram Trigger.
  • Идентификатор сообщения: введите уникальный идентификатор сообщения, которое вы хотите открепить.

Телеграм Триггер

Telegram — это облачный сервис обмена мгновенными сообщениями и голосовой связи по IP. Пользователи могут отправлять сообщения и обмениваться фотографиями, видео, стикерами, аудио и файлами любого типа. На этой странице вы найдете список событий, на которые может реагировать узел Telegram Trigger, а также ссылки на дополнительные ресурсы.

События

  • *: Все обновления, за исключением «Участник чата», «Реакция на сообщение» и «Количество реакций на сообщение» (поведение API Telegram по умолчанию, поскольку они производят много вызовов обновлений).
  • Бизнес подключение : срабатывает, когда бот подключается или отключается от бизнес-аккаунта или когда пользователь редактирует существующее подключение к боту.
  • Деловое сообщение : активируется при получении нового сообщения от подключенного бизнес-аккаунта.
  • Запрос обратного вызова : срабатывает при поступлении нового запроса обратного вызова.
  • Публикация на канале : активируется при появлении новой публикации на канале любого типа, включая текст, фотографию, наклейку и т. д.
  • Поддержка чата : Срабатывает при добавлении или изменении чат-буста. Бот должен быть администратором в чате, чтобы получать эти обновления.
  • Запрос на присоединение к чату : срабатывает при отправке запроса на присоединение к чату. Бот должен иметь can_invite_users права администратора в чате, чтобы получать эти обновления.
  • Участник чата : Срабатывает при обновлении статуса участника чата. Бот должен быть администратором в чате.
  • Выбранный встроенный результат : срабатывает, когда отправляется результат встроенного запроса, выбранного пользователем. Подробности о том, как включить эти обновления для вашего бота, см. в документации API Telegram по сбору отзывов.
  • Удаленные бизнес-сообщения : срабатывает при удалении сообщений из подключенного бизнес-аккаунта.
  • Отредактированное бизнес-сообщение : активируется при появлении новой версии сообщения из подключенного бизнес-аккаунта.
  • Отредактированная запись канала : срабатывает при появлении новой версии записи канала, которая, как известно боту, отредактирована.
  • Отредактированное сообщение : срабатывает при появлении новой версии сообщения на канале, о редактировании которой известно боту.
  • Встроенный запрос : срабатывает при поступлении нового встроенного запроса.
  • Сообщение : активируется при появлении нового входящего сообщения любого типа — текста, фотографии, наклейки и т. д.
  • Реакция на сообщение : срабатывает, когда реакция на сообщение изменяется пользователем. Бот должен быть администратором в чате. Обновление не приходит для реакций, установленных ботами.
  • Количество реакций на сообщения : срабатывает при изменении реакций на сообщение с анонимными реакциями. Бот должен быть администратором в чате. Обновления группируются и могут отправляться с задержкой до нескольких минут.
  • Мой участник чата : срабатывает, когда статус участника чата бота обновляется в чате. Для приватных чатов это обновление происходит только тогда, когда бот заблокирован или разблокирован пользователем.
  • Опрос : Срабатывает при новом состоянии опроса. Боты получают только обновления об остановленных опросах и опросах, отправленных ботом.
  • Ответ на опрос : срабатывает, когда пользователь меняет свой ответ в неанонимном опросе. Боты получают только новые голоса в опросах, которые были отправлены самим ботом.
  • Запрос перед оформлением заказа : активируется при получении нового запроса перед оформлением заказа. Содержит полную информацию о оформлении заказа.
    Приобретенные платные медиа : срабатывает, когда пользователь покупает платные медиа с непустой полезной нагрузкой, отправленной ботом в чате вне канала.
  • Удален чат Boost : срабатывает, когда из чата удаляется boost. Бот должен быть администратором в чате, чтобы получать эти обновления.
  • Запрос на доставку : активируется при новом входящем запросе на доставку. Только для счетов с гибкой ценой.
    Для некоторых событий могут потребоваться дополнительные разрешения . Более подробную информацию см. в документации API Telegram .