휴먼 인 더 루프(Human-in-the-Loop) 에이전트 실행

개요

HITL(Human-in-the-Loop) 실행을 통해 에이전트 실행 중간에 일시 중지하고 사람이 작업을 검토 할 때까지 기다렸다가 계속할 수 있습니다. 에이전트 에이전트 코드에 정의된 인적 검토 도구를 호출하면 실행을 일시 중단하고 검토자를 위해 컨텍스트를 표시하며 검토자가 결정을 제출한 후에만 다시 시작됩니다.

MongoDB Atlas Agent Engine에서 HITL은 실행 파이프라인 에 내장되어 있습니다. 일시 중단, 검토 및 재개 실행 파이프라인 수명 주기는 에이전트 Atlas Agent Engine API, agentengine CLI 또는 Atlas Agent Engine UI 에서 호출하는지 여부에 관계없이 적용됩니다. 이 가이드 HITL 수명 주기의 단계와 일시 중단된 실행에 대한 결정을 제출 방법을 설명합니다.

수명 주기 일시 중단, 검토 및 재개

에이전트 실행 중에 인적 검토 도구를 호출하면 인적 검토 에 들어갑니다. 인적 검토 활성화 하려면 LangGraph 어댑터의 interrupt() 함수를 사용하여 에이전트 코드에 이 도구를 추가합니다.

그런 다음 Atlas Agent Engine은 다음 라이프사이클을 통해 실행을 이동합니다.

1. 일시 중단: 에이전트 인적 검토 도구를 호출하여 실행 일시 중지합니다. 에이전트 샌드박스는 에이전트 상태 의 체크포인트 저장하고 suspended 상태를 오케스트레이션 엔진(OE)에 보고합니다.

2. 알림: UI 가 일시 중지된 실행을 표시하고 검토자에게 알립니다. 일시 중단된 실행은 에이전트 중단 점 에서 제공한 컨텍스트를 전달합니다.

3. 검토: 검토자는 표면화된 컨텍스트를 검사하고 승인 또는 거부와 같은 결정을 제출합니다. 결정은 API 게이트웨이를 통해 OE로 이동합니다.

4. 재개: OE는 검토자의 결정에 따라 실행을 에이전트 샌드박스로 다시 보냅니다. 결정 결과는 에이전트 코드에 따라 달라집니다. 어느 쪽이든 에이전트 샌드박스는 체크포인트 에서 에이전트 를 복원하고 그래프 다시 실행합니다.

5. 완료: 에이전트 나머지 작업을 완료한 후 OE는 실행을 completed로 표시합니다. 실행은 종료 상태에 도달하기 전에 여러 번 일시 중단되었다가 재개될 수 있습니다.

일시 중단 컨텍스트 검토

에이전트 일시 중단되면 검토 대상을 설명하는 suspend_context 객체 제공합니다. 에이전트 중단 점 에서 이 객체 의 필드를 정의하므로 정확한 내용은 에이전트 마다 다릅니다. 예시 를 들어, 환불 승인 에이전트 요청된 조치 에 대한 클레임 ID 와 설명을 표시할 수 있습니다.

suspend_context 객체 리뷰어가 제출 수 있는 결정을 제한하는 allowed_decisions 목록이 포함될 수도 있습니다. 이 목록이 있고 비어 있지 않은 경우 OE는 목록에 없는 모든 결정을 거부합니다.

일시 중단된 실행 재개

Atlas Agent Engine API, agentengine CLI 또는 Atlas Agent Engine UI 에서 일시 중단된 실행을 재개할 수 있습니다.

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"}

--- 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]:

Reviewer notes (optional): [default: ]

자세히 알아보기

실행 재개에 대해 자세히 학습 API 설명서를 참조하세요.

에이전트 호출에 대해 자세히 학습 에이전트 호출 가이드 참조하세요.