Agentes LLM: una cola de señales de email

Description and use

Implementing a signal queue for LLM agents awaiting emails reduces uncertainty, limits tool calls, and provides clear diagnostics.

Problem

Un agente LLM que crea una cuenta de prueba y espera un email suele repetir consultas, gastar llamadas de herramienta y terminar con un diagnóstico poco útil: “no llegó el email”.

Outcome

La cola de señales reduce costos de incertidumbre, hace visible el estado, limita el número de llamadas y permite diagnósticos claros.

Workflow

• 1. Crear usuario y generar señal con signal_id, run_id, kind, recipient, expected_subject, status=waiting, expires_at.
• 2. Agente consulta la cola por signal_id y recibe estado.
• 3. Si estado es waiting, agente espera según presupuesto y vuelve a consultar.
• 4. Si estado es found, agente pasa message_id al siguiente paso.
• 5. Si estado es expired, agente detiene workflow y genera diagnóstico.
• 6. Si estado es provider_error, agente reintenta con backoff y registra código.
• 7. Worker consulta mailbox con filtros por recipient, subject, after=created_at, marca found o registra check/error.
• 8. Logs guardan solo message_id, hora de consulta, coincidencias y código de error, sin cuerpo del mensaje.
• 9. Se evalúa el workflow con tabla de escenarios y se verifica evidencia.
• 10. Checklist de implementación revisa señal, idempotencia, estados, presupuesto, logs y tests.

Evidence

Un agente que espera sin saber qué espera

Source

Una señal útil tiene un identificador y una condición de éxito concreta

Source

El worker que consulta el correo debe ser idempotente

Source

La cola también permite separar errores recuperables de errores finales

Source