Dateien

Dateien sind Dokumente, die der Agent während einer Ausführung lesen kann, etwa Anweisungen, Referenzdaten oder Beispiele. Sie laden sie einmal in Ihre Organisation hoch und legen für jede Ausführung oder jeden Workflow fest, welche eingebunden werden und wohin.

Dateien hochladen

Laden Sie Dateien im Dashboard unter Dateien, mit POST /v1/files oder mit ephemeral files upload hoch. Jede Datei erhält eine ID wie file_9c41… und einen Namen. Der Name ist ein relativer Pfad wie guides/refunds.md mit bis zu 240 Zeichen.

Wenn Sie erneut mit einem bereits vorhandenen Namen hochladen, wird eine neue Datei mit neuer ID angelegt. Die Dateiliste zeigt für jeden Namen den neuesten Upload. Ältere Uploads bleiben per ID verfügbar, bis Sie sie löschen.

Dateien an eine Ausführung geben

Führen Sie die Dateien im Array files der Ausführung auf. Jeder Eintrag bindet eine Datei unter einem von Ihnen gewählten path ein. Den Inhalt können Sie auf drei Arten benennen:

Bei hochgeladenen Dateien ist path standardmäßig der Name der Datei. Inline-Dateien müssen ihn angeben. Pfade müssen relativ und innerhalb der Ausführung eindeutig sein.

"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

In der microVM

Der Worker erhält die Dateien als schreibgeschütztes Verzeichnis und bekommt den Pfad jeder Datei mitgeteilt. Er kann sie nicht ändern. Sein Arbeitsverzeichnis ist ein separater Arbeitsbereich. Alles, was er dort schreibt, verschwindet mit der Zerstörung der microVM, Dateien werden also nie zwischen Ausführungen geteilt. Das Ergebnis der Ausführung ist ihre Textausgabe.

Eine Ausführung liest die Dateiinhalte, wenn sie die Warteschlange verlässt. Löschen Sie eine Datei, während eine Ausführung, die sie nutzt, noch in der Warteschlange steht, schlägt diese Ausführung fehl.

Limits

Hochladen, Herunterladen, Umbenennen und Löschen beschreibt die Dateien-API.