Agent d'opérations : stockage (S3)

Deux étapes de stockage travaillent avec votre propre stockage objet depuis un flux :

• AWS S3 : Amazon S3, avec les clés d'accès de votre compte, des identifiants temporaires ou un rôle assumé.
• S3 : tout service compatible S3, comme MinIO, Ceph, Wasabi, DigitalOcean Spaces, Backblaze B2 ou Cloudflare R2.

Les deux proposent les mêmes actions, choisies dans le réglage Action de l'étape.

• Bucket : créer, supprimer, en obtenir plusieurs, rechercher
• Fichier : téléverser, télécharger, copier, supprimer, en obtenir plusieurs
• Dossier : créer, supprimer, en obtenir plusieurs

Connecter votre stockage#

AWS S3 : choisissez la Région, collez l'ID de clé d'accès et la Clé d'accès secrète. Pour des identifiants temporaires, collez aussi le Jeton de session. Pour utiliser un rôle, réglez Identifiants sur Assumer un rôle et indiquez l'ARN du rôle (et l'ID externe si votre rôle en exige un) ; l'étape utilise d'abord les clés pour assumer le rôle. Un point de terminaison personnalisé peut être défini sous Plus d'options.

S3 : indiquez le Point de terminaison S3 du service, la Région et les clés. Activez Forcer le style de chemin quand votre service attend le bucket dans le chemin (c'est généralement le cas de MinIO). Ignorer les problèmes SSL existe pour les serveurs de test avec des certificats auto-signés ; ne l'utilisez pas en production.

Ne donnez aux clés que les permissions dont le flux a besoin, par exemple l'accès en écriture à un seul bucket ou à un seul dossier.

Téléverser un enregistrement ou une transcription#

1. Placez Télécharger l'enregistrement (ou Transcrire) avant l'étape de stockage.
2. Dans l'étape de stockage, choisissez Fichier : téléverser, le Bucket et la Clé du fichier (le chemin dans le bucket), par exemple calls/{{trigger.call_id}}.wav.
3. Téléverser : un fichier produit par une étape précédente ({{download.file}}) ou du texte que vous écrivez ici, par exemple {{transcribe.text}}. Définissez le Nom du fichier et le Type de contenu si nécessaire.

L'étape produit bucket, key, etag et une url vers le fichier avec son expiration, url_expires_at. Le lien dure jusqu'à une semaine avec des clés d'accès ; avec des identifiants temporaires ou un rôle assumé, il prend fin avec ces identifiants. Envoyez le lien dans un e-mail, ou conservez la key dans votre CRM.

Dossiers et listes#

Un dossier est un préfixe de clé : un dossier invoices contient tout ce qui se trouve sous invoices/, jamais invoices-old/. Dossier : en obtenir plusieurs liste les fichiers et les dossiers qu'il contient, sur un niveau ou, avec Récursif, sur tous les niveaux. Fichier : en obtenir plusieurs et Bucket : rechercher listent ce qui correspond, avec items et count pour l'étape suivante.

Copier, télécharger et supprimer#

Fichier : copier copie un fichier vers un Bucket de destination et une Clé de destination. Fichier : télécharger amène un fichier dans l'exécution, par exemple pour transcrire un enregistrement que quelqu'un a déposé dans un bucket ; la copie téléchargée est supprimée à la fin de l'exécution. Fichier : supprimer et Dossier : supprimer retirent ce que vous désignez ; supprimer quelque chose qui n'existe déjà plus compte comme réussi. Une exécution reprise après un redémarrage ne répète jamais une copie ni une suppression.

Avant de vous y fier#

Les étapes de stockage peuvent être prévisualisées et exécutées seules depuis l'inspecteur (Exécuter cette étape maintenant), sans exécuter le reste du tableau : voir Conception et test. Les modèles Archiver chaque enregistrement dans votre bucket AWS S3 et Conserver chaque transcription sur votre propre stockage compatible S3 sont des exemples prêts à l'emploi.