Операционный агент: хранилище (S3)

Два шага хранилища работают из потока с вашим собственным объектным хранилищем:

• AWS S3: Amazon S3, с ключами доступа вашей учётной записи, временными учётными данными или принимаемой ролью.
• S3: любой S3-совместимый сервис, например MinIO, Ceph, Wasabi, DigitalOcean Spaces, Backblaze B2 или Cloudflare R2.

Оба предлагают одни и те же действия, которые выбираются в настройке шага Действие.

• Бакет: создать, удалить, получить несколько, найти
• Файл: загрузить, скачать, скопировать, удалить, получить несколько
• Папка: создать, удалить, получить несколько

Подключение хранилища#

AWS S3: выберите Регион, вставьте Идентификатор ключа доступа и Секретный ключ доступа. Для временных учётных данных вставьте также Токен сессии. Чтобы использовать роль, установите Учётные данные в значение Принять роль и укажите ARN роли (и Внешний идентификатор, если ваша роль его требует); шаг сначала использует ключи, чтобы принять роль. Собственную конечную точку можно задать в разделе Дополнительные параметры.

S3: укажите Конечную точку S3 сервиса, Регион и ключи. Включите Принудительный стиль пути, если ваш сервис ожидает бакет в пути (обычно это так для MinIO). Игнорировать ошибки SSL существует для тестовых серверов с самоподписанными сертификатами; не используйте это в рабочей среде.

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

Загрузка записи или расшифровки#

1. Поставьте Скачать запись (или Расшифровать) перед шагом хранилища.
2. В шаге хранилища выберите Файл: загрузить, Бакет и Ключ файла (путь в бакете), например calls/{{trigger.call_id}}.wav.
3. Загрузить: файл, произведённый предыдущим шагом ({{download.file}}), или текст, который вы пишете здесь, например {{transcribe.text}}. При необходимости задайте Имя файла и Тип содержимого.

Шаг производит bucket, key, etag и url на файл со сроком действия url_expires_at. С ключами доступа ссылка действует до недели; с временными учётными данными или принимаемой ролью она перестаёт действовать вместе с этими учётными данными. Отправьте ссылку в письме или сохраните key в своей CRM.

Папки и списки#

Папка это префикс ключа: папка invoices содержит всё, что находится под invoices/, но никогда invoices-old/. Папка: получить несколько перечисляет файлы и вложенные папки на одном уровне или, с параметром Рекурсивно, на всех уровнях. Файл: получить несколько и Бакет: найти перечисляют подходящие элементы, передавая items и count следующему шагу.

Копирование, скачивание и удаление#

Файл: скопировать копирует файл в Бакет назначения с Ключом назначения. Файл: скачать приносит файл в запуск, например чтобы расшифровать запись, которую кто-то оставил в бакете; скачанная копия удаляется по окончании запуска. Файл: удалить и Папка: удалить удаляют указанное; удаление того, чего уже нет, считается выполненным. Запуск, возобновлённый после перезапуска, никогда не повторяет копирование или удаление.

Прежде чем на это полагаться#

Шаги хранилища можно просмотреть и выполнить по отдельности из инспектора (Выполнить этот шаг сейчас), не запуская остальную доску: см. Проектирование и тестирование. Шаблоны Архивировать каждую запись в ваш бакет AWS S3 и Хранить каждую расшифровку в собственном S3-совместимом хранилище служат готовыми примерами.