LAUF-ÜBERGREIFENDER ZUSTAND
Zustand zwischen Agenten-Läufen persistieren.
AgentAddress gibt jeder Aufgabe einen kleinen dauerhaften JSON-Speicher: 32 Schlüssel und 65.536 Bytes pro Adresse, gelesen und geschrieben mit derselben Credential wie die Ereigniswarteschlange.
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42"}Hand off
Kein Antwortender ist beteiligt. Schreibe den Zustand mit der Adress-Credential in diesem Lauf und lies ihn aus dem späteren Lauf, der dieselbe Adresse wiederhergestellt hat.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"state.updated","data":{"status":"complete"}}Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}Questions agents ask
Wie persistiere ich Zustand zwischen KI-Agenten-Läufen?
Zustand zwischen Agenten-Läufen persistieren bedeutet, den Wert vor dem Ende des Agentenprozesses in einen Speicher außerhalb des Prozesses zu schreiben und ihn aus einem späteren Lauf wiederzulesen. AgentAddress implementiert dies pro Aufgabe: Jede Adresse hat einen dauerhaften JSON-Speicher mit 32 Schlüsseln und 65.536 Bytes, geschrieben und gelesen mit derselben Credential wie die Ereigniswarteschlange, mit Revisionsprüfungen, damit gleichzeitige Läufe sich nicht stillschweigend gegenseitig überschreiben.
Was ist dauerhafter Schlüssel-Wert-Zustand für KI-Agenten?
Dauerhafter Schlüssel-Wert-Zustand ist eine kleine strukturierte Datenmenge — ein Fortschrittsmarker, eine To-do-Liste, ein Checkpoint — die außerhalb des Agentenprozesses gespeichert wird, um das Ende des Laufs zu überleben. AgentAddress bietet sie pro Aufgabenadresse: Werte sind JSON-Objekte oder einfache Werte unter 32 benannten Schlüsseln, insgesamt höchstens 65.536 Bytes einschließlich Metadaten, und sie bleiben bestehen, bis sie ersetzt oder gelöscht werden oder die Adresse abläuft oder gelöscht wird.
Wie überlebt eine To-do-Liste über Agenten-Läufe hinweg?
Eine To-do-Liste überlebt, wenn sie in einen aufgabenbezogenen dauerhaften Speicher geschrieben wird, nicht wenn sie im Arbeitsspeicher oder Kontextfenster des Prozesses bleibt. AgentAddress speichert sie als benannten Schlüssel im JSON-Zustand der Adresse: Der erste Lauf speichert die Liste, endet, und ein späterer Lauf liest denselben Schlüssel mit der gespeicherten Credential zurück. Der Schreibvorgang sendet auch ein state.updated-Ereignis in denselben geordneten Feed wie Callbacks und E-Mail, sodass der spätere Lauf die Änderung in seinem Aktivitätsverlauf sieht.
Warum verliert mein KI-Agent zwischen Läufen sein Gedächtnis?
Ein Agent verliert zwischen Läufen sein Gedächtnis, weil sein Kontext im Prozess lebt: Wenn der Lauf endet, verschwinden Arbeitsgedächtnis, Variablen und ungespeicherter Kontext mit ihm. Die Lösung ist, was der nächste Lauf braucht, vor dem Ende in einen Speicher außerhalb des Prozesses zu schreiben. AgentAddress ist ein solcher Speicher für aufgabengroße Daten: 32 JSON-Schlüssel und 65.536 Bytes pro Adresse, plus ein geordneter 30-Tage-Ereignis-Feed, der aufzeichnet, was geschah, während der Agent weg war.
Wie vermeiden zwei Agenten-Läufe, sich gegenseitig den Zustand zu überschreiben?
Nutze revisionsbasiertes Compare-and-Set: Lies den Wert zusammen mit seiner Revisionsnummer und sende dann deinen Schreibvorgang gegen diese Revision. Hat ein anderer Lauf ihn zuvor geändert, wird der Schreibvorgang mit 409 revision_conflict abgelehnt, statt die Änderung stillschweigend zu ersetzen. AgentAddress-Zustandsschreibvorgänge funktionieren so, und jeder erfolgreiche Schreibvorgang committet ein state.updated-Ereignis atomar mit der Wertänderung in den Feed.
Speichert AgentAddress Dateien oder Dokumente für Agenten?
Nicht als allgemeinen Dateispeicher. AgentAddress speichert kleine JSON-Werte — bis zu 32 Schlüssel und 65.536 Bytes pro Adresse — als dauerhaften Lauf-übergreifenden Zustand, und eingehende E-Mail-Anhänge bleiben beim Provider mit Abruf auf Anforderung, statt persistiert zu werden. Allgemeiner Datei- und Artefakt-Speicher ist geplante Richtung, keine ausgelieferte Fähigkeit. Nutze den JSON-Zustand für Checkpoints, Fortschrittsprotokolle und kleinen strukturierten Kontext.