Ejecución de agente con intervención humana

Ciclo de vida del estado de ejecución

El motor del agente Atlas informa el estado actual en el campo status de cada respuesta de la API de ejecución. Una ejecución que no requiere revisión humana pasa por los siguientes estados:

• pending

• running

• completed or error

Cuando una ejecución se suspende para revisión humana, pasa por los siguientes estados:

• pending

• running

• suspended

• resuming

• completed or error

Garantía de repetición

Cuando el OE reanuda la ejecución, devuelve los resultados almacenados en caché de cada paso que se completó antes de la suspensión. El agente vuelve a ejecutar la misma ruta de código, pero el OE sirve los resultados almacenados en lugar de volver a ejecutar los pasos anteriores. Solo los pasos posteriores al punto de revisión se ejecutan por primera vez.

Esta garantía de repetición evita acciones duplicadas. Por ejemplo, si un agente envía un correo electrónico antes de suspenderse para su revisión, la ejecución reanudada no envía ese correo electrónico por segunda vez.

Decisiones de los revisores

Una vez que el agente suspende la ejecución, un revisor envía una decisión al respecto. Para enviar esta decisión, proporcione la siguiente información:

La siguiente sección describe las diferentes maneras en que puede proporcionar estos datos.

Usar la API

Para reanudar una ejecución suspendida mediante la API, envíe una solicitud POST al punto final /api/v1/projects/{project_id}/executions/{execution_id}/resume?workspace_id={workspace_id} de la API. El cuerpo de la solicitud incluye la decisión del revisor, como se muestra en el cuerpo de la solicitud de reanudación. Los puntos finales de ejecución están limitados a un proyecto. Reemplace los marcadores de posición del ID del proyecto, el ID de ejecución y el ID del espacio de trabajo con sus propios valores.

Seleccione la pestaña de su herramienta preferida para ver un ejemplo de solicitud POST que reanuda una ejecución suspendida. El encabezado X-Mdb-Agent-Engine-Custom-Authorization en cada ejemplo muestra cómo reenviar un encabezado personalizado:

curl -X POST "https://agentengine.mongodb.com/api/v1/projects/$PROJECT_ID/executions/$EXECUTION_ID/resume?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Mdb-Agent-Engine-Custom-Authorization: my-user-id" \
  -H "Content-Type: application/json" \
  -d '{"decision": "approve", "reviewer_notes": "optional context"}'

import httpx
response = httpx.post(
    f"https://agentengine.mongodb.com/api/v1/projects/{project_id}/executions/{execution_id}/resume",
    params={"workspace_id": workspace_id},
    headers={
        "Authorization": f"Bearer {api_key}",
        "X-Mdb-Agent-Engine-Custom-Authorization": "my-user-id",
        "Content-Type": "application/json",
    },
    json={"decision": "approve", "reviewer_notes": "optional context"},
)

{"decision": "approve", "reviewer_notes": "approved after verifying customer identity"}

Utilice la interfaz de línea de comandos (CLI).

Al ejecutar el comando agentengine invoke sin mensaje en una terminal interactiva, la interfaz de línea de comandos (CLI) inicia una sesión de chat en tiempo real. En este modo interactivo, la CLI muestra automáticamente una solicitud de revisión en línea cuando el agente suspende una invocación para revisión humana.

La interfaz de línea de comandos (CLI) imprime el contexto de suspensión que proporcionó el agente y una lista numerada de decisiones permitidas. La salida de la CLI se asemeja al siguiente ejemplo:

--- Execution suspended for human review ---
  claim_id: CLM-4821
  task_description: Approve refund of $240 for order #98765
Select a decision:
  1) approve
  2) reject
Select [1-2]:

Después de seleccionar una decisión, la interfaz de línea de comandos (CLI) solicita notas opcionales del revisor, como se muestra en el siguiente ejemplo:

Reviewer notes (optional): [default: ]

Luego, la CLI reanuda la ejecución e imprime Execution resumed.. La sesión permanece abierta y puede enviar un mensaje de seguimiento para recuperar la salida del agente posterior a la reanudación.

Para obtener más información sobre el comando agentengine invoke, consulte Invocar un agente desde la CLI.

Utiliza la interfaz de usuario

La interfaz de usuario de Atlas Agent Engine muestra las ejecuciones suspendidas en la página Pending Reviews, donde puede inspeccionar una ejecución pausada y enviar una decisión. Para reanudar una ejecución suspendida desde la interfaz de usuario, siga los siguientes pasos: