Agente operativo: storage (S3)

Due passaggi di storage lavorano con il vostro object storage da un flusso:

• AWS S3: Amazon S3, con le chiavi di accesso del vostro account, credenziali temporanee o un ruolo assunto.
• S3: qualsiasi servizio compatibile S3, come MinIO, Ceph, Wasabi, DigitalOcean Spaces, Backblaze B2 o Cloudflare R2.

Entrambi offrono le stesse azioni, scelte nell'impostazione Azione del passaggio.

• Bucket: creare, eliminare, ottenerne molti, cercare
• File: caricare, scaricare, copiare, eliminare, ottenerne molti
• Cartella: creare, eliminare, ottenerne molte

Collegare il vostro storage#

AWS S3: scegliete la Regione, incollate l'ID chiave di accesso e la Chiave di accesso segreta. Per credenziali temporanee incollate anche il Token di sessione. Per usare un ruolo, impostate Credenziale su Assumi ruolo e indicate il Role ARN (e l'External ID se il vostro ruolo lo richiede); il passaggio usa le chiavi per assumere prima il ruolo. Un endpoint personalizzato si imposta sotto Altre opzioni.

S3: indicate l'Endpoint S3 del servizio, la Regione e le chiavi. Attivate Forza path style quando il vostro servizio si aspetta il bucket nel percorso (MinIO di solito sì). Ignora problemi SSL esiste per server di prova con TLS autofirmato; non usatelo in produzione.

Date alle chiavi solo i permessi di cui il flusso ha bisogno, per esempio l'accesso in scrittura a un solo bucket o a una sola cartella.

Caricare una registrazione o una trascrizione#

1. Mettete Scarica registrazione (o Trascrivi) prima del passaggio di storage.
2. Nel passaggio di storage scegliete File: carica, il Bucket e la Chiave del file (il percorso nel bucket), per esempio calls/{{trigger.call_id}}.wav.
3. Carica: un file prodotto da un passaggio precedente ({{download.file}}) oppure del testo che scrivete qui, per esempio {{transcribe.text}}. Impostate il Nome del file e il Tipo di contenuto quando serve.

Il passaggio produce bucket, key, etag e un url al file con la sua scadenza, url_expires_at. Il link dura fino a una settimana con le chiavi di accesso; con credenziali temporanee o un ruolo assunto termina quando terminano quelle credenziali. Inviate il link in un'e-mail, oppure conservate la key nel vostro CRM.

Cartelle ed elenchi#

Una cartella è un prefisso di chiave: una cartella invoices contiene tutto ciò che sta sotto invoices/, mai invoices-old/. Cartella: ottienine molte elenca i file e le cartelle contenute, a un livello oppure, con Ricorsivo, a tutti i livelli. File: ottienine molti e Bucket: cerca elencano ciò che corrisponde, con items e count per il passaggio successivo.

Copiare, scaricare ed eliminare#

File: copia copia un file in un Bucket di destinazione e una Chiave di destinazione. File: scarica porta un file nell'esecuzione, per esempio per trascrivere una registrazione che qualcuno ha lasciato in un bucket; la copia scaricata viene eliminata alla fine dell'esecuzione. File: elimina e Cartella: elimina rimuovono ciò che indicate; eliminare qualcosa che non c'è più conta come fatto. Un'esecuzione ripresa dopo un riavvio non ripete mai una copia o un'eliminazione.

Prima di farci affidamento#

I passaggi di storage possono essere visti in anteprima ed eseguiti da soli dall'ispettore (Esegui ora questo passaggio), senza eseguire il resto della lavagna: vedere Progettazione e prove. I modelli Archivia ogni registrazione nel vostro bucket AWS S3 e Conserva ogni trascrizione sul vostro storage compatibile S3 sono esempi pronti.