Agentes LLM: una cola de señales de email

说明与用途

为等待邮件的LLM代理实现信号队列，降低不确定性，限制工具调用，并提供清晰的诊断信息。

问题

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”.

结果

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

工作流

• 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.

证据

Un agente que espera sin saber qué espera

来源

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

来源

El worker que consulta el correo debe ser idempotente

来源

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

来源