Ephemeral Dokumentation

Ephemeral führt KI-Agenten in sicheren Wegwerf-Maschinen aus. Beschreiben Sie eine Aufgabe einmal und führen Sie sie dann aus Ihrem Code, per CLI, im Dashboard oder nach Zeitplan aus. Jede Ausführung erhält eine frische microVM, die Dateien und Verbindungen, die Sie freigeben, und ein Ausgabenlimit. Während der Arbeit streamt sie jeden Schritt, danach wird die Maschine zerstört. Die Ausgabe, die Ereignisse und die Kosten bleiben erhalten.

Eine vollständige Ausführung

curl $EPHEMERAL_URL/v1/runs \
  -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Summarize the input in one sentence","input":{"text":"…"},"max_cost_micros":500000}'

Für wen Ephemeral gedacht ist

Ephemeral ist für Entwickler gedacht, die ihren Anwendungen KI-Aufgaben im Hintergrund hinzufügen: ein Support-Ticket oder eine fehlgeschlagene Zahlung untersuchen, ein System beobachten und erklären, was sich geändert hat, einen regelmäßigen Bericht schreiben oder eine betriebliche Routineaufgabe erledigen. Ihr Code startet eine Ausführung mit einem API-Aufruf, und das Ergebnis kommt zu Ihrem Code zurück.

Was Ephemeral für Sie übernimmt

Rund um eine Modell-API müssten Sie sonst selbst bauen:

Eine frische, isolierte Maschine für jede Aufgabe, die danach zerstört wird.
Einen Broker für Zugangsdaten: Der Agent ruft Ihre APIs auf, ohne ein Geheimnis zu sehen, und nur mit den Methoden oder Tools, die Sie erlauben.
Feste Budgets pro Ausführung, vor dem Start reserviert und danach auf die genauen Kosten abgerechnet.
Einen aufgezeichneten Ablauf und die genauen Kosten jeder Ausführung.
Zeitpläne und signierte Callbacks: Arbeit startet pünktlich, und Ihr Server erfährt, wann sie endet.
Eine feste Aufbewahrungsdauer und Null-Datenspeicherung für sensible Ausführungen. Siehe auch Sicherheit und Daten.

So greift alles ineinander

Eine Ausführung ist ein Agent, der eine Aufgabe bearbeitet. Sie beschreiben sie mit einem Prompt und JSON-Eingabe und legen fest, welche Dateien der Agent lesen und welche Verbindungen er aufrufen darf. Ein Workflow ist eine unter einem Namen gespeicherte Ausführungsdefinition, sodass Ihr Code nur den Namen und die neue Eingabe senden muss. Ein Zeitplan startet einen Workflow zu festen Zeiten, in jeder Zeitzone.

Der Worker läuft in einer eigenen microVM. Er erhält nie Ihre Anbieterschlüssel oder Verbindungszugangsdaten: Modellaufrufe und Verbindungsanfragen laufen mit einem kurzlebigen Ausführungs-Token über Ephemeral, und zwar nur an die Methoden oder Tools, die Sie zugelassen haben.

Gehostet oder selbst gehostet

Beim gehosteten Dienst bezahlen Sie Ausführungen mit vorausbezahltem Guthaben, und Ihre Organisation verwalten Sie unter ephemer.al. Selbst gehostete Installationen betreiben dieselbe Engine und dasselbe Dashboard in Ihrem eigenen AWS-Konto mit Ihrem eigenen Modellanbieter.

Wie es weitergeht

SchnellstartLaden Sie Guthaben auf, erstellen Sie einen Schlüssel und starten Sie in wenigen Minuten Ihre erste Ausführung.AusführungenStatus, Ereignisse, Zeitlimits, Abbruch und was danach erhalten bleibt.VerbindungenLassen Sie Worker Ihre APIs und MCP-Server aufrufen, ohne dass sie Zugangsdaten sehen.API-ReferenzJeder Endpunkt mit Anfrage- und Antwortfeldern.BeispieleLauffähige Beispiele mit der Aufzeichnung eines echten Laufs, der genauen Anfrage und den jeweiligen Berechtigungen.

Versionen und Abkündigung

Die API ist im Pfad versioniert: Alle Endpunkte liegen unter /v1. Innerhalb einer Version kommen nur Ergänzungen hinzu: neue Endpunkte, neue optionale Anfragefelder, neue Antwortfelder und neue Ereignistypen. Bestehende Felder behalten Namen und Bedeutung; Clients sollten unbekannte Felder ignorieren.

Eine Änderung, die bestehende Clients brechen würde, erscheint als neue Version unter einem neuen Pfad. Die vorherige Version funktioniert nach der Veröffentlichung der neuen noch mindestens sechs Monate. Solange sie abgekündigt ist, tragen ihre Antworten einen Deprecation-Header und einen Sunset-Header mit dem Abschaltdatum, und die Inhaber der Organisationen werden per E-Mail informiert.