chatme.ai
Search…
Создание Агента на платформе
Создание Сценария Агента
ДЛЯ РАЗРАБОТЧИКОВ
Отправка файлов Собеседнику | Слот Attachment

Назначение и общая информация

Слот Attachment – слот, предназначенный для отправки файлов-вложений указанного типа от Агента Собеседнику. Например, с помощью этого слота можно отправить Собеседнику аудио, видео или изображение, которое отобразится корректно в мессенджере с предпросмотром. Один слот Attachment отправляет один файл.

Создание и настройки слота Attachment

Атрибуты слота

  1. 1.
    Name — название слота, которое будет отображено в Дереве сценария. Максимальная длина значения поля — 40 символов.
  2. 2.
    Source — ссылка на файл или переменная, содержащая ссылку на файл, который должен быть отправлен.
  3. 3.
    Caption — сопутствующее текстовое сообщение к файлу или переменная, с текстом, который должен быть приложен файлу. Длинные сообщения будут обрезаны до 1024 символов (такая длина сообщения удовлетворяет требованиям всех поддерживаемых мессенджеров и омниканальных платформ).
  4. 4.
    Primary type — тип отправляемого файла, для корректного отображения и предпросмотра в конечном Канале. Допустимые варианты: Image, Audio, Video, File.
Вы самостоятельно выбираете желаемый тип файла.
Например, в Telegram изображение может быть отправлено типом Image – тогда оно будет отображаться прямо в мессенджере, или типом File – будет отражено файлом, доступным для скачивания.

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

В Слоте Attachment допустимо использование Выражениq и Управляющb[ конструкциq в полях Source и Caption. Подробнее: Переход на новый синтаксис
Пример:
Значения контекстных переменных url и caption будут взяты из контекста чата. Фильтр |upper приведёт значение переменной caption к верхнему регистру.

Работа слота Attachment

При выполнении слота Attachment:
  1. 1.
    Агент получает значения в полях Source и Caption, выполняет конкатенацию в этих полях, если она присутствует, обрезает значение Caption до 1024 символов.
  2. 2.
    Агент выполняет отправку файла, доступного по ссылке в поле Source, и сопутствующего сообщения из поля Caption в конечный Канал с указанием Primary type – тип файла, который должен быть отправлен Собеседнику.
  3. 3.
    Конечный Канал валидирует ссылку из поля Source на предмет:
    • это прямая ссылка на файл (файл скачивается по этой ссылке);
    • файл по ссылке соответствует Primary type;
    • файл по ссылке удовлетворяет критериям для Primary type в этом конечном Канале по размеру и контенту. Важно: Для определения требований к файлам каждого типа необходимо ознакомиться с официальной документацией тех каналов, в которых размещается Агент. В каждом мессенджере и соцсети свои требования, которые могут быть меняться им в одностороннем порядке.
  4. 4.
    В случае успешной валидации файла по полю Source, файл доставляется Собеседнику в указанном Primary type, к файлу прикрепляется сопутствующее сообщение (не более 1024 символа из поля Caption). Важно: Доставка файлов большого размера может занять продолжительное время. Это следует учитывать при построении Сценария: Собеседник может успеть написать Агенту до того, как ему будет доставлен большой файл.
  5. 5.
    В случае неуспешной валидации файла по полю Source или ошибки отправки из конечного Канала, Агент повторяет отправку данных из слота Attachment, но уже в виде двух текстовых сообщений: первое – значение из поля Source, второе – значение из поля Caption. Перед такой отправкой также происходит конкатенация и получение значений переменных, если они используются в этих полях.
  6. 6.
    Если конечный Канал не поддерживает отправку файлов, значения полей Source и Caption отправляются двумя текстовыми сообщениями. Перед такой отправкой также происходит конкатенация и получение значений переменных, если они используются в этих полях.
Не все конечные Каналы поддерживают передачу файлов Собеседнику «в виде файлов», некоторые Каналы передают только ссылку на скачивание файла. Актуальная информация по каждому Каналу размещена в соответствующих статьях в разделе Размещение агента в каналах.
Copy link
On this page
Назначение и общая информация
Создание и настройки слота Attachment
Атрибуты слота
Использование синтаксиса в Слоте
Работа слота Attachment