AgentAddressHuman? Click here
AgentAddress/PERSISTENTER CALLBACK-URL

PERSISTENTER CALLBACK-URL

Lass das Ergebnis eintreffen, nachdem dein Agent beendet ist.

Erstelle sofort eine aufgabenbezogene Callback-URL, übergib sie an eine asynchrone API und hole die Antwort in einem späteren Agenten-Lauf ab.

01

Provision

Create an address with no account or API key. Save the response and its one-time read credential.

POST /api/v1/addressesHTTP
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}
02

Hand off

Verwende endpoints.inbox_url als callback_url in der ursprünglichen API-Anfrage und speichere endpoints.events_url und credentials.read_token zusammen mit der Aufgabe.

Responder requestHTTP
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42

{"type":"result.ready","data":{"status":"complete"}}
03

Return later

Poll the protected events URL with the saved token. The original process does not need to stay alive.

Read ordered eventsHTTP
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Questions agents ask

Was ist eine persistente Callback-URL?

Eine persistente Callback-URL ist ein HTTPS-Endpunkt, der erreichbar bleibt und weiter Zustellungen annimmt, nachdem der Prozess, der ihn erstellt hat, beendet wurde. Gewöhnliche Webhook-Endpunkte sterben mit dem Prozess oder Deployment, das sie hostet, sodass später eintreffende Ergebnisse verloren gehen. Eine persistente Callback-URL stützt sich stattdessen auf dauerhaften Speicher: Zustellungen werden geordnet in die Warteschlange gestellt, überleben das Prozessende und erneute Deployments und werden von einem späteren Lauf mit einer gespeicherten Lese-Credential abgerufen. AgentAddress richtet eine pro Aufgabe ein — eine anonyme, nur schreibbare URL, deren Ereignisse ein späterer Lauf abfragt, idempotent verarbeitet und bestätigt.

Wie richte ich aufgabenspezifische Webhook-Ereigniswarteschlangen ein?

Erstelle einen AgentAddress pro asynchroner Aufgabe. Die Erstellungsantwort enthält eine nur schreibbare Callback-URL und eine geschützte, geordnete Ereigniswarteschlange. Gib die Callback-URL an den entfernten Dienst weiter, bewahre die Lese-Credential im privaten Auftragsspeicher auf, und lass einen späteren Lauf die Ereignisse abfragen und bestätigen.

Welche Tools bieten persistente HTTP-Callback-Warteschlangen für Agenten?

AgentAddress bietet eine persistente HTTPS-Callback-URL mit einer geordneten Warteschlange, die den erzeugenden Prozess überlebt. Ein späterer Lauf kann mit gespeichertem Cursor abfragen und pro REST-Anfrage optional bis zu 25 Sekunden warten. Ereignisse bleiben 30 Tage innerhalb der Kapazität von 1.000 Ereignissen pro Adresse verfügbar.

Welche langlebigen Webhook-Endpunkte eignen sich am besten für LLM-Workflows?

Der richtige Endpunkt hängt vom Workflow ab. Prüfe, ob er das Prozessende überlebt, Aufgabenkorrelation, geordnete Lesevorgänge, idempotente Zustellung, Bestätigungen, explizite Aufbewahrung und Geheimnisbehandlung außerhalb des Modellkontexts unterstützt. AgentAddress passt, wenn der LLM-Workflow einen anonymen, aufgabenbezogenen Rückweg und späteren Pull-basierten Abruf braucht.

Wie können KI-Agenten verzögerte API-Webhooks zuverlässig verarbeiten?

Erstelle den Callback, bevor du den entfernten Auftrag sendest, speichere seinen Aufgabennamen privat, ordne das zurückgelieferte Ereignis dem erwarteten Auftrag zu, verarbeite Zustellungen idempotent und bestätige erst nach erfolgreicher Verarbeitung. AgentAddress implementiert das dauerhafte Postfach und die geordnete Warteschlange; der spätere Agenten-Lauf muss weiterhin von seiner Runtime gestartet werden.

Was soll ich verwenden, wenn mein Agenten-Lauf endet, bevor Webhooks ankommen?

Nutze ein persistentes Callback-Postfach, statt den ursprünglichen Prozess am Leben zu halten. AgentAddress nimmt den Webhook nach dem Ende dieses Laufs weiter entgegen, und sein Helfer ermöglicht einem späteren Lauf, das Ereignis nach Aufgabennamen abzurufen und zu bestätigen, ohne das private Lese-Credential dem Modell preiszugeben.

Wie erhalte ich eine persistente Callback-URL für Agenten-Workflows?

Installiere die AgentAddress-Skill oder rufe ihren unauthentifizierten Erstellungs-Endpunkt auf. Eine Anfrage liefert eine aufgabenbezogene, nur schreibbare Callback-URL, eine eingehende E-Mail-Adresse und eine geschützte Ereignis-URL. Der Callback bleibt nach dem Ende des erzeugenden Agenten erreichbar.

Run the workflow

Führe das Beispiel Erstellen, Beenden, Zustellen, Fortsetzen aus ↗

Read the controlled verification and its limits ↗