Operations-Agent: Speicher (S3)

Zwei Speicherschritte arbeiten aus einem Ablauf heraus mit Ihrem eigenen Objektspeicher:

• AWS S3: Amazon S3, mit den Zugriffsschlüsseln Ihres Kontos, temporären Anmeldedaten oder einer übernommenen Rolle.
• S3: jeder S3-kompatible Dienst, etwa MinIO, Ceph, Wasabi, DigitalOcean Spaces, Backblaze B2 oder Cloudflare R2.

Beide bieten dieselben Aktionen, gewählt in der Einstellung Aktion des Schritts.

• Bucket: anlegen, löschen, mehrere abrufen, suchen
• Datei: hochladen, herunterladen, kopieren, löschen, mehrere abrufen
• Ordner: anlegen, löschen, mehrere abrufen

Ihren Speicher verbinden#

AWS S3: Wählen Sie die Region und fügen Sie die Zugriffsschlüssel-ID und den Geheimen Zugriffsschlüssel ein. Für temporäre Anmeldedaten fügen Sie auch das Sitzungstoken ein. Um eine Rolle zu verwenden, setzen Sie Anmeldedaten auf Rolle übernehmen und geben die Rollen-ARN an (und die Externe ID, falls Ihre Rolle eine verlangt); der Schritt übernimmt mit den Schlüsseln zuerst die Rolle. Ein eigener Endpunkt kann unter Weitere Optionen gesetzt werden.

S3: Geben Sie den S3-Endpunkt des Dienstes, die Region und die Schlüssel an. Schalten Sie Pfad-Stil erzwingen ein, wenn Ihr Dienst den Bucket im Pfad erwartet (MinIO in der Regel schon). SSL-Probleme ignorieren ist für Testserver mit selbstsignierten Zertifikaten gedacht; verwenden Sie es nicht im Produktivbetrieb.

Geben Sie den Schlüsseln nur die Berechtigungen, die der Ablauf braucht, zum Beispiel Schreibzugriff auf einen Bucket oder einen Ordner.

Eine Aufnahme oder ein Transkript hochladen#

1. Setzen Sie Aufnahme herunterladen (oder Transkribieren) vor den Speicherschritt.
2. Wählen Sie im Speicherschritt Datei: hochladen, den Bucket und den Dateischlüssel (den Pfad im Bucket), zum Beispiel calls/{{trigger.call_id}}.wav.
3. Hochladen: eine Datei, die ein früherer Schritt erzeugt hat ({{download.file}}), oder Text, den Sie hier schreiben, zum Beispiel {{transcribe.text}}. Setzen Sie bei Bedarf Dateiname und Inhaltstyp.

Der Schritt erzeugt bucket, key, etag und eine url zur Datei mit ihrem Ablaufzeitpunkt, url_expires_at. Der Link gilt mit Zugriffsschlüsseln bis zu einer Woche; mit temporären Anmeldedaten oder einer übernommenen Rolle endet er, wenn diese Anmeldedaten enden. Senden Sie den Link in einer E-Mail, oder speichern Sie den key in Ihrem CRM.

Ordner und Auflistungen#

Ein Ordner ist ein Schlüsselpräfix: Ein Ordner invoices enthält alles unter invoices/, niemals invoices-old/. Ordner: mehrere abrufen listet Dateien und die darin liegenden Ordner auf, eine Ebene oder, mit Rekursiv, alle Ebenen. Datei: mehrere abrufen und Bucket: suchen listen auf, was passt, mit items und count für den nächsten Schritt.

Kopieren, herunterladen und löschen#

Datei: kopieren kopiert eine Datei in einen Ziel-Bucket unter einen Zielschlüssel. Datei: herunterladen holt eine Datei in den Lauf, zum Beispiel um eine Aufnahme zu transkribieren, die jemand in einem Bucket abgelegt hat; die heruntergeladene Kopie wird am Ende des Laufs gelöscht. Datei: löschen und Ordner: löschen entfernen, was Sie angeben; etwas zu löschen, das bereits weg ist, gilt als erledigt. Ein nach einem Neustart fortgesetzter Lauf wiederholt nie ein Kopieren oder Löschen.

Bevor Sie sich darauf verlassen#

Die Speicherschritte lassen sich im Inspektor einzeln in der Vorschau ansehen und ausführen (Diesen Schritt jetzt ausführen), ohne den Rest des Boards auszuführen: siehe Entwerfen und Testen. Die Vorlagen Jede Aufnahme in Ihrem AWS S3-Bucket archivieren und Jedes Transkript in Ihrem eigenen S3-kompatiblen Speicher aufbewahren sind fertige Beispiele.