Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

Файлы

File — небольшое значение-ссылка на файл: id, name, size, mime и необязательный publicUrl. Сами байты хранятся в хранилище Шагомата, а сценарий передаёт между шагами только ссылку, как число или строку. Поэтому даже большой файл не раздувает состояние сценария.

  • Медиа из мессенджеров. Фото, документ, голосовое, аудио или видео во входящем сообщении становятся File ещё до старта сценария: message.photo, message.document, message.voice, message.audio, message.video (или их нет, если в сообщении нет такого вложения).
  • «Скачать файл» — загружает содержимое по ссылке и сохраняет как File.
  • «Создать файл из текста» — превращает строку, собранную сценарием (CSV, JSON, HTML), в файл.
  • «Вызвать AI (изображение)» — генерирует картинку и возвращает её как File.
  • HTTP-запрос с форматом ответа «файл» — сохраняет тело ответа как File вместо разбора в текст.
  • Ручная загрузка на вкладке Файлы — удобно, чтобы дать сценарию что-то на обработку при тестировании.
  • Прочитать как текст — содержимое файла в строковую переменную (для файлов до определённого размера).
  • Отправить в мессенджер — «Отправить файл» доставляет его как фото, документ, видео, аудио или голосовое (тип определяется по формату или выбирается явно).
  • Приложить к запросу ИИ — «Вызвать AI» и «AI Choice» принимают список файлов, чтобы модель «видела» их вместе с промптом.
  • Распознать речь — «Вызвать AI (распознавание)» превращает аудио, например голосовое сообщение, в текст.
  • Обработать — изменить размер, конвертировать, обрезать видео: см. Медиа.
  • Удалить или получить по id («Информация о файле»), если где-то сохранён только id файла (например, в базе данных).

По умолчанию файл доступен только изнутри проекта: из его сценариев и на вкладке «Файлы». «Опубликовать файл» включает публичную ссылку без авторизации (длинный неугадываемый адрес) — по ней файл может открыть кто угодно; «Снять с публикации» выключает ссылку, не удаляя файл. Удаление файла сразу отключает ссылку. Для отправки в мессенджер или ИИ публиковать файл не нужно.

  • Файл, созданный на тестовом стенде, по умолчанию удаляется через сутки.
  • Файл, пришедший из мессенджера, — через неделю.
  • Файл, созданный в проде, сам не удаляется.

Ограничены размер одного файла и общий объём файлов; загрузка сверх лимита отклоняется. Если нужно больше, напишите в поддержку.

Проект → Файлы открывает вкладку рядом с документами: все файлы проекта с именем, размером, типом, источником, сроком хранения и признаком публикации. Здесь можно скачать, удалить, загрузить файл, включить или выключить публичную ссылку и посмотреть, сколько места занято.