Agentspan ist eine Open-Source-Ausführungsschicht für KI-Agenten, deren Arbeit Prozessabstürze, Bereitstellungen, lange Wartezeiten und menschliche Genehmigungen überstehen muss. Anstatt die gesamte Agentenschleife im Anwendungsspeicher zu belassen, speichert es den Ausführungsstatus auf einem Agentspan-Server und delegiert die Tool-Arbeit an verbundene Mitarbeiter. Das Projekt wird von Orkes auf der Workflow-Engine Conductor erstellt und ist derzeit MIT-lizenziert und kann selbst gehostet werden.
Die Unterscheidung ist wichtig: Agentspan macht einen schwachen Agenten nicht intelligent, wählt keine sicheren Berechtigungen aus und validiert kein Geschäftsergebnis. Es verändert das Fehlermodell. Ein Lauf erhält eine dauerhafte Identität, abgeschlossene Schritte haben einen Verlauf, die ausstehende Genehmigung kann serverseitig warten und ein Ersatzarbeiter kann die Verbindung wiederherstellen. Teams sollten es als Infrastruktur für verteilte Systeme bewerten, nicht als Prompt-Bibliothek.
Was ändert sich, wenn der Status den Agentenprozess verlässt?
| Sorge | In-Process-Agent-Schleife | Agentspan Modell | Der Betreiber ist immer noch Eigentümer |
|---|---|---|---|
| Prozessabsturz | Speicher und aktuelle Position können verschwinden | Der Server behält den Workflow-Status bei und nimmt die Arbeit wieder auf | Verfügbarkeit von Arbeitskräften und idempotente Tools |
| Menschliche Zustimmung | Die Anwendung muss den Status „Ausstehend“ beibehalten oder neu erstellen | Der Workflow kann serverseitig angehalten werden und später eine Antwort erhalten | Genehmigen Sie Identitäts-, Timeout- und Eskalationsrichtlinien |
| Wiederholungen | Benutzerdefinierte Schleife, oft grobkörnig | Die Wiederholung pro Schritt ist ein Workflow-Grundelement | Welche Fehler wiederholt werden können und ob Nebenwirkungen sicher sind |
| Geschichte | Anwendungsspezifische Protokolle | Eingaben, Ausgaben, Timing und Schritte sind abfragbar | Schwärzung, Aufbewahrung und Zugriffskontrollen |
| Maßstab | Status und Terminierung gekoppelt an einen Prozess | Der Server koordiniert Arbeiter und Ausführungen | Kapazität, Mietdauer, Warteschlangen und Notfallwiederherstellung |
| Terminplanung/Veranstaltungen | Separate Cron- oder Nachrichtenleitungen | Conductor Planung und Event-Integrationen | Überlappung, Deduplizierung und Verhalten bei verpassten Ereignissen |
Der Laufzeitpfad, gezeichnet als Fehlergrenze
Benutzer / Ereignis
|
v
.--------------------. Dauerhafter Zustand .-------.
| Anwendungscode | ------------------------> | Agentspan / Conductor|
| Agent + Tools | <--- task delegation ---- | run, step, history |
'--------------------' '----------+-----------'
| worker may die |
| and reconnect | calls
v v
custom tool process LLM / HTTP / MCP tools
| |
'---------------- results + side effects ---------------'
Durable checkpoint ≠ transaction over every external side effect
Die letzte Zeile ist der wichtigste betriebliche Vorbehalt. Eine Workflow-Engine kann sich merken, dass sie eine Zahlung, eine E-Mail oder eine Repository-Mutation angefordert hat, kann jedoch eine beliebige externe Aktion nicht automatisch in eine Transaktion umwandeln. Wenn ein Worker aus der Ferne erfolgreich ist und abstürzt, bevor er den Abschluss bestätigt, kann bei einem erneuten Versuch die Aktion wiederholt werden. Jedes mutierende Tool benötigt einen Idempotenzschlüssel, eine Abstimmungsabfrage oder einen menschlichen Entscheidungspfad.
Machen Sie den Crashtest vor der Happy-Path-Demo
Ein nützlicher Proof of Concept tötet den Arbeiter absichtlich an verschiedenen Grenzen. Führen Sie einen schreibgeschützten Forschungsauftrag, einen Auftrag mit kontrolliertem Nebeneffekt und einen genehmigungsgeschützten Auftrag aus. Behalten Sie die Ausführungs-ID bei, starten Sie auf einer anderen Maschine neu, stellen Sie die Verbindung wieder her und vergleichen Sie den Endzustand mit einem ununterbrochenen Kontrolllauf.
| Injektionspunkt | Erwartete Beweise | Fehler, der den Rollout blockieren sollte |
|---|---|---|
| Während einer LLM-Anfrage | Begrenzter Wiederholungsversuch und eine kohärente Fortsetzung | Unbegrenzte Token-Ausgaben oder duplizierter Kontext |
| Nach Abschluss des schreibgeschützten Tools | Fortsetzen, ohne das vorherige Ergebnis zu verlieren | Der Lauf startet von vorne |
| Nach dem Remote-Schreiben, vor der Bestätigung | Der Idempotenzschlüssel verhindert ein Duplikat | Zwei Tickets, Zahlungen, Nachrichten oder Commits |
| Während wir auf die Genehmigung warten | Beim Neustart bleiben ausstehende Anforderungen und Prüfidentitäten erhalten | Implizite Genehmigung, verlorene Anfrage oder falscher Genehmiger |
| Während der Bereitstellung | Alte und neue Arbeiter führen nicht denselben exklusiven Schritt aus | Nebenwirkungen von Split-Brain |
| Nach Serverneustart | Das dokumentierte Wiederherstellungsziel wird erreicht | Der Verlauf oder der Workflow-Status können nicht wiederhergestellt werden |
Für Wiederholungsversuche ist ein Nebeneffektvertrag erforderlich
Klassifizieren Sie Tools, bevor Sie automatische Wiederholungsversuche aktivieren. Reine Funktionen und wiederholbare Lesevorgänge können normalerweise wiederholt werden. Für Schreibvorgänge ist ein stabiler Betriebsschlüssel erforderlich, der auf den Workflow und Schritt abgestimmt ist. Für nicht wiederholbare Aktionen ist ein „Abfrage vor Wiederholung“-Adapter oder eine manuelle Abgleichswarteschlange erforderlich. Bitten Sie einen LLM nicht, aus dem Konversationskontext abzuleiten, ob eine Zahlung oder Nachricht bereits erfolgt ist.
- Sicherer Wiederholungsversuch: Berechnen Sie eine Prüfsumme, lesen Sie eine öffentliche Seite oder fragen Sie anhand einer unveränderlichen ID ab.
- Bedingt sicher: Erstellen Sie ein Ticket mit einem vom Server erzwungenen Idempotenzschlüssel oder aktualisieren Sie einen bekannten Datensatz mit Versionsprüfung.
- Standardmäßig unsicher: Senden Sie eine E-Mail, veröffentlichen Sie Inhalte, überweisen Sie Geld oder führen Sie eine Produktionsänderung ohne Deduplizierung durch.
- Kompensierbar: Reservieren Sie eine Ressource, wenn ein getesteter Stornierungsvorgang und ein nachvollziehbarer Eskalationspfad vorhanden sind.
Menschliche Zustimmung ist ein Richtliniensystem, kein Pausenknopf
Agentspan dokumentiert zur Genehmigung markierte Tools und CLI-, API oder UI-Antworten. Die Produktionsrichtlinie muss außerdem festlegen, wer genehmigen kann, welche genauen Argumente eingefroren werden, wie die Identität authentifiziert wird, wann die Anfrage abläuft und ob eine geänderte Aktion eine neue Genehmigung erstellt. Zeigen Sie dem Genehmiger die vorgeschlagene Nebenwirkung, das Ziel, die Datenoffenlegung, die geschätzten Kosten und einen für Menschen lesbaren Unterschied.
Trennen Sie Anforderer und Genehmiger für wirkungsvolle Maßnahmen. Eine Ablehnung muss die Klage beenden oder einschränken; Es sollte das Modell nicht dazu veranlassen, mit einem anderen Werkzeug um das Tor herumzufahren. Zeichnen Sie die Richtlinienversion und das Genehmigungsartefakt neben der Ausführung auf, damit bei einer Wiederholung eine alte Entscheidung nicht auf neue Argumente angewendet werden kann.
Framework-Kompatibilität bedeutet nicht identische Semantik
Die offizielle Dokumentation demonstriert seinen eigenen Agenten API und Integrationen mit LangGraph, den OpenAI Agenten SDK und Google ADK. Testen Sie genau den Adapter und die Version, die Sie bereitstellen möchten. Überprüfen Sie Streaming, Abbruch, verschachtelte Agenten, Tool-Aufruf-IDs, strukturierte Ausgabe, Kontextweitergabe und Fehlerzuordnung. Ein Wrapper kann die aufrufbare Schnittstelle beibehalten und gleichzeitig das Prüfpunkt- oder Wiederholungsverhalten ändern.
| Integrationswahl | Der beste Grund, es zu verwenden | Validierungsfrage |
|---|---|---|
| Nativer Agentspan Agent | Kleinste konzeptionelle Oberfläche und dokumentierte Grundelemente | Deckt die Modell-/Tool-Abstraktion das erforderliche Verhalten ab? |
| LangGraph | Vorhandenes Diagramm, Knoten und Zustandsdesign | Welche Schicht besitzt Checkpoints, Wiederholungsversuche und Interrupts? |
| OpenAI Agenten SDK | Bestehende Agenten, Übergaben und Rückverfolgungskonventionen | Werden Werkzeug- und Freigabeereignisse verlustfrei abgebildet? |
| Google ADK | Vorhandene Google-Agent-Implementierung | Werden Sitzungsstatus und Artefakte dauerhaft dargestellt? |
| HTTP/OpenAPI-Tool | Serverseitiger Aufruf ohne benutzerdefinierten Worker-Code | Wo werden Anmeldeinformationen, Ratenbegrenzungen und Antwortschemata durchgesetzt? |
| MCP-Tool | Die Fähigkeitsoberfläche eines MCP-Servers wiederverwenden | Kann jede offengelegte Methode unabhängig voneinander bewertet und geprüft werden? |
Anmeldeinformationen und gespeicherte Ausführungsdaten
Agentspan unterstützt Anbieterschlüssel durch Umgebungskonfiguration und vom Server ausgeführte HTTP-, OpenAPI- und MCP-Tools. Eine zentrale Ausführung kann dazu führen, dass Geheimnisse, die in jeden Mitarbeiter kopiert werden, reduziert werden, aber sie bündelt auch die Autorität. Verwenden Sie einen Secret Manager, kurzlebige Anmeldeinformationen, umgebungsspezifische Identitäten und ausgehende Zulassungslisten. Platzieren Sie Anmeldeinformationen niemals in Eingabeaufforderungen, Toolschemata oder persistenten Ergebnissen.
Der Ausführungsverlauf kann Kundentext, abgerufene Dokumente, Quellcode, Modellantworten, Toolargumente und Fehler enthalten. Entscheiden Sie, welche Felder vor der Speicherung geschwärzt werden, wer Läufe durchsuchen oder wiedergeben kann, wie Mandanten getrennt werden und wie Löschanfragen an Backups und Observability-Exporte weitergegeben werden. Verschlüsseln Sie Transport und Speicherung, prüfen Sie den Lesezugriff und testen Sie die Wiederherstellung, anstatt davon auszugehen, dass Persistenz gleichbedeutend mit Wiederherstellbarkeit ist.
Beobachtbarkeit, die zum Handeln führt
Rohspuren sind nur dann nützlich, wenn sie betriebliche Fragen beantworten. Fügen Sie eine Korrelations-ID für Trigger, Workflow, Modellaufrufe und externe Mutationen hinzu. Zeichnen Sie Modell/Version, Prompt-Policy-Version, Token-Anzahl, Tool-Latenz, Wiederholungsgrund, Genehmigungsverzögerung und Terminalklassifizierung auf. Vermeiden Sie Geheimnisse mit hoher Kardinalität in Etiketten.
| Metrisch | Warum es wichtig ist | Vorgeschlagene Warnung |
|---|---|---|
| Erfolgreiche Geschäftsergebnisse | Trennt abgeschlossene Arbeitsabläufe von korrekten Ergebnissen | Drop gegen aufgabenspezifische Baseline |
| Doppelte Nebenwirkungen | Erkennt gebrochene Idempotenz | Alle bestätigten Duplikate für kritische Tools |
| Wiederholungsversuche pro Schritt | Findet instabile Werkzeuge und versteckte Kosten | Nachhaltige Steigerung pro Tool/Version |
| Zulassungsalter | Zeigt feststeckende Arbeit und betriebliche Belastung | Vergangenes SLA oder Ablaufdatum der Richtlinie |
| Genesungserfolg | Misst das Kernhaltbarkeitsversprechen | Jeder nicht wiederherstellbare berechtigte Lauf |
| Kosten pro akzeptiertem Ergebnis | Kombiniert Modell-, Rechen- und Prüferkosten | Regression versus Kontrollworkflow |
Checkliste für Bereitstellung und Upgrade
- Pinnen Sie die Versionen SDK, Server und Conductor; Notieren Sie die Kompatibilitätsmatrix.
- Separate Entwicklungs-, Staging- und Produktionsanmeldeinformationen, Warteschlangen und Datenspeicher.
- Sichern Sie Workflow-Metadaten und testen Sie eine Wiederherstellung in einer isolierten Umgebung.
- Legen Sie Budgets für Parallelität, Token, Zeit, Wiederholungsversuche und Rekursion pro Agent und Mandant fest.
- Konfigurieren Sie Integritätsprüfungen für Server, Worker, Warteschlangen, Datenbank- und Modellanbieter.
- Nutzen Sie Canary-Worker für Upgrades und halten Sie alte Workflow-Definitionen für Ausführungen während der Ausführung bereit.
- Definieren Sie die Stornierungssemantik: Stoppen Sie zukünftige Arbeiten, widerrufen Sie Anmeldeinformationen und gleichen Sie teilweise Nebenwirkungen aus.
- Prompt-Injection des Bedrohungsmodells, SSRF, Ausgabe bösartiger Tools und übermäßige Offenlegung von MCP/OpenAPI.
Alternativen und die ehrliche Auswahlgrenze
| Option | Wählen Sie es wann | Kompromiss |
|---|---|---|
| Agentspan | Sie möchten agentenspezifische APIs über Conductor, Selbsthosting und Integrationen | Neue Steuerungsebene und sich weiterentwickelnde Projektoberfläche |
| LangGraph Persistenz | Ihre Bewerbung ist bereits stark diagrammförmig | Sie verfügen über mehr Möglichkeiten zur Produktionsorchestrierung |
| Zeitlich | Die Organisation betreibt bereits dauerhafte Arbeitsabläufe in großem Maßstab | Agent-Adapter und abspielsicherer Code erfordern Engineering |
| Conductor direkt | Sie benötigen allgemeine Workflow-Grundelemente, die über Agenten hinausgehen | Weniger agentenspezifischer Komfort |
| Restate- oder DBOS-Muster | Sie möchten dauerhafte Funktionen/Transaktionen in der Nähe des Anwendungscodes | Unterschiedliches Ökosystem und Integrationsmodell |
| Warteschlange + Datenbankzustandsmaschine | Der Workflow ist klein, deterministisch und stabil | Niedrigste Abhängigkeitsanzahl, aber benutzerdefinierte Wiederherstellung und Benutzeroberfläche funktionieren |
| Verwaltete Agentenplattform | Schneller Betrieb ist wichtiger als Infrastrukturkontrolle | Anbieter-, Daten- und Anpassungsbeschränkungen |
Fügen Sie keine dauerhafte Laufzeit hinzu, nur weil ein Workflow ein LLM verwendet. Ein kurzer synchroner Assistent ohne Nebenwirkungen muss möglicherweise nur die Protokollierung und Wiederholungsversuche anfordern. Agentspan wird überzeugend, wenn die Ausführungsdauer lang ist, Genehmigungen über die Prozesslebensdauer hinaus warten, Ereignisse Arbeit auslösen oder der Wiederherstellungsverlauf eine Produktanforderung ist.
Ein zweiwöchiger Evaluierungsplan
In der ersten Woche sollten ein Kontrollworkflow und eine Integration etabliert werden. Wählen Sie einen begrenzten Job mit drei bis zehn Schritten, einer Genehmigung und einem reversiblen externen Schreibvorgang aus. Messen Sie ununterbrochenen Erfolg und Kosten und fügen Sie dann Abstürze hinzu. Die zweite Woche sollte sich auf feindselige und operative Fälle konzentrieren: doppelte Ereignisse, verzögerte Genehmigungen, fehlerhafte Tool-Ausgabe, Ratenbegrenzungen der Anbieter, Austausch von Arbeitskräften, Server-Neustart und ein Upgrade mit einem laufenden Lauf.
Fördern Sie es nur, wenn ein anderer Techniker die Bereitstellung und Wiederherstellung anhand schriftlicher Anweisungen reproduzieren kann, jedes mutierende Tool über eine getestete Nebenwirkungsrichtlinie verfügt, der sensible Verlauf geregelt ist und die Rate der akzeptierten Ergebnisse sich ausreichend verbessert, um die Server- und Bereitschaftsbelastung zu rechtfertigen.
Häufig gestellte Fragen
Ist Agentspan ein Agent-Framework?
Es enthält einen Agenten API, sein Unterscheidungsmerkmal ist jedoch die dauerhafte Laufzeit unter dem Agenten. Es können auch Agenten ausgeführt werden, die mit unterstützten externen Frameworks erstellt wurden.
Was ist die Ausführungs-Engine?
Das Projekt besagt, dass Agentendefinitionen zu Workflows auf Conductor kompiliert werden, was dauerhafte Status-, Verlaufs-, Wiederholungsversuche- und Workflow-Primitive bereitstellt.
Kann es sich selbst hosten?
Ja. Die offizielle Website beschreibt es als MIT-lizenziert und selbsthostbar. Betreiber müssen weiterhin Abhängigkeiten, Datenspeicher, Upgrades und Supporterwartungen validieren.
Verhindert die Absturzwiederherstellung doppelte Schreibvorgänge?
Nein. Eine dauerhafte Orchestrierung reduziert den Zustandsverlust, externe Schreibvorgänge erfordern jedoch weiterhin Idempotenz, Abgleich oder Kompensation.
Sind Genehmigungen automatisch sicher?
Nein. Teams müssen Authentifizierung, Autorisierung, Argumentbindung, Ablauf, Aufgabentrennung und Audit-Aufbewahrung definieren.
Beseitigt es die Notwendigkeit eines Agenten-Frameworks?
Nein. Es kann bestehende Agentendefinitionen ergänzen. Wählen Sie einen eindeutigen Besitzer für Status, Wiederholungsversuche und Unterbrechungen, um widersprüchliche Semantiken zu vermeiden.
Wie hoch sollte die erste Produktionsauslastung sein?
Ein begrenzter, reversibler Workflow mit geringer Sensibilität mit messbarem Erfolg und klarer Eskalation – keine Zahlungen, Produktionsänderungen oder umfassender Datenzugriff.
Primärquellen
- Offizielle Agentspan-Website und Schnellstart
- Offizielle Dokumentation
- Offizielle Erklärung zu Architektur und Haltbarkeit
- Konzepte zur Agentenausführung
- Tooltypen und serverseitige Ausführung
- Unterstützte Modellanbieter und Konfiguration
- CLI, Genehmigungen und Ausführungsverlauf
- Offizielles Quell-Repository
- OWASP-Leitfaden für LLM-Anwendungsrisiken
Zuletzt überprüft am 25. Juli 2026. Agentspan entwickelt sich schnell weiter. Überprüfen Sie die genaue SDK/Server-Version, Lizenz, Framework-Adapter und Bereitstellungsanweisungen, bevor Sie sie übernehmen.
