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