Ausführungen

Eine Ausführung ist ein Agent, der eine Aufgabe in einer eigenen microVM bearbeitet. Sie senden einen Prompt, JSON-Eingabe sowie die Dateien und Verbindungen, die er nutzen darf. Ephemeral stellt sie in die Warteschlange, startet eine frische Maschine, zeichnet jeden Schritt auf und zerstört die Maschine, wenn die Ausführung endet.

Woraus eine Ausführung besteht

Jede Ausführung hat einen Prompt und optional eine Eingabe. Der Rest der Definition legt fest, welches Modell sie verwendet, was sie lesen und aufrufen darf, wie lange sie dauern und wie viel sie ausgeben darf. Sie können die gesamte Definition direkt mitsenden oder einen gespeicherten Workflow benennen und nur die Eingabe senden.

{
  "prompt": "Find out why this payment failed. Follow the playbook.",
  "input": { "payment_id": "pay_123" },
  "model": "anthropic/claude-haiku-5.5",
  "files": [{ "file": "playbook.md" }],
  "connections": { "payments": { "ref": "payments-api", "allowed_methods": ["GET"] } },
  "timeout_seconds": 120,
  "shell": false,
  "max_cost_micros": 500000
}

In der microVM kann der Agent die eingebundenen Dateien immer lesen. Bei aktivierter shell, der Standardeinstellung, kann er außerdem Shell-Befehle ausführen und Dateien in seinem Arbeitsverzeichnis schreiben. Jede freigegebene Verbindung fügt Tools hinzu, die er aufrufen kann, und bei aktiviertem Webzugriff kann er Seiten lesen, suchen und öffentliche APIs aufrufen. Die Maschine selbst hat kein Internet. Das Arbeitsverzeichnis wird mit der Maschine verworfen, sodass nichts in die nächste Ausführung übernommen wird.

Lebenszyklus

Eine Ausführung durchläuft diese Status. Die letzten fünf sind final; sobald eine Ausführung einen davon erreicht, ändert sie sich nicht mehr.

Ausführungen verlassen die Warteschlange in der Reihenfolge ihrer Erstellung. Eine selbst gehostete Installation führt standardmäßig zwei gleichzeitig aus; die übrigen warten in queued. Das Zeitlimit zählt ab dem Moment, in dem eine Ausführung die Warteschlange verlässt, die Wartezeit verbraucht es also nicht.

Limits

Eine Ausführung verfolgen

Es gibt drei Wege, zu erfahren, was eine Ausführung gerade tut und wann sie endet.

• Fragen Sie GET /v1/runs/{id} ab, bis der Status final ist.
• Streamen Sie GET /v1/runs/{id}/events. Das ist ein Server-Sent-Events-Stream, der alles bisher Aufgezeichnete wiedergibt und dann live fortfährt, bis die Ausführung endet.
• Legen Sie für die Ausführung einen Callback fest. Ephemeral sendet eine signierte Anfrage an Ihren Server, sobald die Ausführung einen finalen Status erreicht.

Das Schließen des Ereignis-Streams hat keine Auswirkung auf die Ausführung. Sie können sich mit der zuletzt erhaltenen Ereignis-ID erneut verbinden und von dort aus fortfahren.

Ereignistypen

Ephemeral entfernt bekannte Zugangsdaten, etwa Verbindungs-Tokens, aus Ereignissen und Ausgaben, bevor es sie speichert. Das genaue Stream-Format zeigt die API-Referenz.

Eine Ausführung abbrechen

POST /v1/runs/{id}/cancel stoppt eine Ausführung im Status reserving, queued, starting oder running. Der Worker wird gestoppt und die microVM beendet. Das Abbrechen einer bereits beendeten Ausführung ändert nichts.

Null-Datenspeicherung

Setzen Sie zero_data_retention bei einer Ausführung oder in einem gespeicherten Workflow auf true, wenn die Aufgabe sensibel ist. Ephemeral zeichnet dann nichts vom Inhalt der Ausführung auf: Sie erhalten nur die Ausgabe.

• Ereignisse werden weiterhin gestreamt, solange die Ausführung läuft, über GET /v1/runs/{id}/events auf jeder Engine. Sie liegen in einem flüchtigen Speicher und werden wenige Minuten nach dem Ende der Ausführung gelöscht.
• Die Ausgabe wird einmal geliefert. Das erste GET /v1/runs/{id} nach dem Ende der Ausführung enthält sie und löscht sie. Hat die Ausführung einen Callback, liefert der Callback die Ausgabe, und Lesezugriffe lassen sie bis dahin bestehen. In jedem Fall wird sie spätestens nach einer Stunde gelöscht. output_available und output_expires_at zeigen, ob sie noch vorgehalten wird.
• Modellaufrufe gehen nur an Anbieter, die Ihre Daten weder speichern noch zum Training verwenden. Ein Modell ohne einen solchen Anbieter wird mit 400 abgelehnt, bevor etwas reserviert wird.
• Im gehosteten Dienst kostet die Ausführung 10 % mehr: Der Aufschlag gilt für Rechenzeit, Modellaufrufe und Webanfragen, zählt zum Budget und erscheint in der Kostenaufschlüsselung. Selbst gehostete Installationen berechnen nichts zusätzlich.
• Flüchtige Daten liegen in Tabellen, die jedes Backup auslässt. Eine wiederhergestellte Datenbank enthält sie daher nie.

Nach einer Ausführung

Die Ausführung behält ihre Ausgabe, Fehlermeldung, Zeitstempel, Ereignisse und Kosten. Betrachten Sie die Kosten als endgültig, sobald der Status final und billing_pending auf false gesetzt ist; siehe Budgets und Abrechnung.

Beendete Ausführungen werden 30 Tage nach ihrem Ende gelöscht, zusammen mit ihren Ereignissen. Eine Ausführung wird länger aufbewahrt, solange ihre Abrechnung, die Callback-Zustellung oder die Bereinigung der microVM noch aussteht. Selbst gehostete Installationen können die Aufbewahrungsdauer ändern.

Um dieselbe Aufgabe erneut auszuführen, rufen Sie GET /v1/runs/{id}/definition ab. Sie liefert die Definition, die die Ausführung tatsächlich verwendet hat, ohne Zugangsdaten. So können Sie sie prüfen, ein neues Budget festlegen und sie absenden.