Τεκμηρίωση / Agent λειτουργιών
Agent λειτουργιών: αποθήκευση (S3)
Κρατήστε ηχογραφήσεις, απομαγνητοφωνήσεις και αναφορές στον δικό σας χώρο με τα βήματα S3 και AWS S3: buckets, αρχεία, φάκελοι, με συνδέσμους που λήγουν.
Τελευταία ενημέρωση:
Δύο βήματα αποθήκευσης δουλεύουν με τον δικό σας χώρο αποθήκευσης αντικειμένων μέσα από μια ροή:
- AWS S3: Amazon S3, με τα κλειδιά πρόσβασης του λογαριασμού σας, προσωρινά διαπιστευτήρια ή έναν ρόλο που αναλαμβάνεται.
- S3: οποιαδήποτε υπηρεσία συμβατή με S3, όπως MinIO, Ceph, Wasabi, DigitalOcean Spaces, Backblaze B2 ή Cloudflare R2.
Και τα δύο προσφέρουν τις ίδιες ενέργειες, που επιλέγονται στη ρύθμιση Action του βήματος.
- Bucket: δημιουργία, διαγραφή, λήψη πολλών, αναζήτηση
- Αρχείο: μεταφόρτωση, λήψη, αντιγραφή, διαγραφή, λήψη πολλών
- Φάκελος: δημιουργία, διαγραφή, λήψη πολλών
Συνδέστε τον χώρο αποθήκευσής σας#
AWS S3: επιλέξτε Region, επικολλήστε το Access key ID και το Secret access key. Για προσωρινά διαπιστευτήρια επικολλήστε και το Session token. Για να χρησιμοποιήσετε ρόλο, ορίστε το Credential σε Assume role και δώστε το Role ARN (και το External ID αν το απαιτεί ο ρόλος σας)· το βήμα χρησιμοποιεί πρώτα τα κλειδιά για να αναλάβει τον ρόλο. Ένα δικό σας endpoint ορίζεται στις Περισσότερες επιλογές.
S3: δώστε το S3 endpoint της υπηρεσίας, το Region και τα κλειδιά. Ενεργοποιήστε το Force path style όταν η υπηρεσία σας περιμένει το bucket μέσα στη διαδρομή (το MinIO συνήθως το κάνει). Το Ignore SSL issues υπάρχει για δοκιμαστικούς διακομιστές με αυτοϋπογεγραμμένα πιστοποιητικά· μην το χρησιμοποιείτε σε παραγωγή.
Δώστε στα κλειδιά μόνο τα δικαιώματα που χρειάζεται η ροή, για παράδειγμα δικαίωμα εγγραφής σε ένα bucket ή σε έναν φάκελο.
Μεταφόρτωση ηχογράφησης ή απομαγνητοφώνησης#
- Βάλτε τη Λήψη ηχογράφησης (ή την Απομαγνητοφώνηση) πριν από το βήμα αποθήκευσης.
- Στο βήμα αποθήκευσης επιλέξτε Αρχείο: μεταφόρτωση, το Bucket και το File key (τη διαδρομή μέσα στο bucket), για παράδειγμα
calls/{{trigger.call_id}}.wav. - Upload: ένα αρχείο που παρήγαγε προηγούμενο βήμα (
{{download.file}}) ή κείμενο που γράφετε εδώ, για παράδειγμα{{transcribe.text}}. Ορίστε το File name και το Content type όταν χρειάζεται.
Το βήμα παράγει τα bucket, key, etag και ένα url προς το αρχείο με τη λήξη του, url_expires_at. Ο σύνδεσμος διαρκεί έως μία εβδομάδα με κλειδιά πρόσβασης· με προσωρινά διαπιστευτήρια ή ρόλο λήγει μαζί με αυτά τα διαπιστευτήρια. Στείλτε τον σύνδεσμο σε ένα email ή κρατήστε το key στο CRM σας.
Φάκελοι και λίστες#
Ένας φάκελος είναι ένα πρόθεμα κλειδιού: ένας φάκελος invoices περιέχει ό,τι βρίσκεται κάτω από το invoices/, ποτέ το invoices-old/. Το Φάκελος: λήψη πολλών δείχνει τα αρχεία και τους φακέλους μέσα του, σε ένα επίπεδο ή, με το Recursive, σε όλα τα επίπεδα. Τα Αρχείο: λήψη πολλών και Bucket: αναζήτηση δείχνουν ό,τι ταιριάζει, με items και count για το επόμενο βήμα.
Αντιγραφή, λήψη και διαγραφή#
Το Αρχείο: αντιγραφή αντιγράφει ένα αρχείο σε ένα Destination bucket και Destination key. Το Αρχείο: λήψη φέρνει ένα αρχείο μέσα στην εκτέλεση, για παράδειγμα για να απομαγνητοφωνήσετε μια ηχογράφηση που άφησε κάποιος σε ένα bucket· το αντίγραφο που κατέβηκε διαγράφεται όταν τελειώσει η εκτέλεση. Τα Αρχείο: διαγραφή και Φάκελος: διαγραφή αφαιρούν ό,τι ορίσετε· η διαγραφή κάποιου στοιχείου που δεν υπάρχει ήδη μετρά ως ολοκληρωμένη. Μια εκτέλεση που συνεχίζει μετά από επανεκκίνηση δεν επαναλαμβάνει ποτέ μια αντιγραφή ή μια διαγραφή.
Πριν βασιστείτε σε αυτό#
Τα βήματα αποθήκευσης μπορούν να προεπισκοπηθούν και να τρέξουν μόνα τους από τον επιθεωρητή (Τρέξε αυτό το βήμα τώρα), χωρίς να τρέξει ο υπόλοιπος πίνακας: δείτε Σχεδίαση και δοκιμή. Τα πρότυπα Archive every recording to your AWS S3 bucket και Keep every transcript on your own S3-compatible storage είναι έτοιμα παραδείγματα.