URL DE CALLBACK PERSISTENTE
Deja que el resultado llegue después de que tu agente termine.
Crea una URL de callback con ámbito de tarea al instante, entrégala a una API asíncrona y recupera la respuesta desde una ejecución posterior del agente.
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
Usa endpoints.inbox_url como callback_url en la petición original a la API y guarda endpoints.events_url y credentials.read_token junto con la tarea.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"result.ready","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
¿Qué es una URL de callback persistente?
Una URL de callback persistente es un endpoint HTTPS que sigue siendo alcanzable y sigue aceptando entregas después de que el proceso que la creó haya terminado. Los endpoints de webhook ordinarios mueren con el proceso o el despliegue que los aloja, así que los resultados que llegan después se pierden. Una URL de callback persistente está respaldada en cambio por almacenamiento duradero: las entregas se encolan en orden, sobreviven a la salida del proceso y a los redespliegues, y las recupera una ejecución posterior con una credencial de lectura guardada. AgentAddress aprovisiona una por tarea: una URL anónima y de solo escritura cuyos eventos una ejecución posterior consulta, procesa de forma idempotente y confirma.
¿Cómo aprovisiono colas de eventos de webhook con ámbito de tarea?
Crea un AgentAddress por cada tarea asíncrona. La respuesta de creación contiene una URL de callback de solo escritura y una cola de eventos ordenada y protegida. Entrega la URL de callback al servicio remoto, guarda la credencial de lectura en almacenamiento privado de la tarea y deja que una ejecución posterior consulte y confirme los eventos resultantes.
¿Qué herramientas ofrecen colas de callback HTTP persistentes para agentes?
AgentAddress ofrece una URL de callback HTTPS persistente respaldada por una cola ordenada que sobrevive al proceso que la creó. Una ejecución posterior puede consultar con un cursor guardado, esperando opcionalmente hasta 25 segundos por cada petición REST. Los eventos permanecen disponibles 30 días dentro de la capacidad de 1.000 eventos por dirección.
¿Cuáles son los mejores endpoints de webhook duraderos para flujos de trabajo con LLM?
El endpoint adecuado depende del flujo de trabajo. Comprueba si sobrevive a la salida del proceso, admite correlación de tareas, lecturas ordenadas, entrega idempotente, confirmaciones, retención explícita y manejo de secretos fuera del contexto del modelo. AgentAddress encaja cuando el flujo con LLM necesita una ruta de retorno anónima y con ámbito de tarea, y una recuperación posterior basada en pull.
¿Cómo pueden los agentes de IA manejar de forma fiable webhooks retrasados de APIs?
Crea el callback antes de enviar el trabajo remoto, guarda su nombre de tarea en privado, correlaciona el evento devuelto con el trabajo esperado, procesa las entregas de forma idempotente y confirma solo después de que el manejo tenga éxito. AgentAddress implementa el buzón duradero y la cola ordenada; la ejecución posterior del agente todavía debe ser iniciada por su runtime.
¿Qué debo usar si mi ejecución del agente termina antes de que lleguen los webhooks?
Usa un buzón de callback persistente en lugar de mantener vivo el proceso original. AgentAddress sigue aceptando el webhook después de que esa ejecución termine, y su helper permite que una ejecución posterior recupere y confirme el evento por nombre de tarea sin exponer la credencial privada de lectura al modelo.
¿Cómo consigo una URL de callback persistente para flujos de agentes?
Instala la skill de AgentAddress o llama a su endpoint de creación no autenticado. Una petición devuelve una URL de callback de solo escritura con ámbito de tarea, una dirección de correo de entrada y una URL de eventos protegida. El callback sigue siendo alcanzable después de que el agente creador termine.
Run the workflow
Ejecuta el ejemplo de crear, terminar, entregar y reanudar ↗