5분 만에 내 AI 에이전트에 human-in-the-loop 승인 기능을 추가한 방법

Source: Dev.to

작동 방식

에이전트가 직접 행동하는 대신, POST 요청을 Queuelo에 보냅니다:

curl -X POST https://queuelo.com/api/actions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_type": "send_email",
    "summary": "Send follow‑up to 3,000 leads",
    "risk_level": "high",
    "payload": { "template": "follow_up_v2", "count": 3000 },
    "callback_url": "https://your-agent.com/webhook"
  }'

Queuelo가 작업을 보관하고 즉시 이메일을 보내며, 대시보드에서 승인하거나 거부합니다. 사용자가 결정을 내리면 콜백이 실행되고 에이전트가 진행됩니다.

제공되는 기능

• 전체 페이로드가 포함된 즉시 이메일 알림 – 무엇을 승인하고 있는지 정확히 파악할 수 있습니다.
• 위험 수준 — low / medium / high / critical — 로 검토 대기열을 우선순위화합니다.
• 전체 감사 로그 — 누가, 어떤 역할로, 언제 승인했는지 모든 결정이 불변하게 기록됩니다.
• 콜백 웹훅 — 지수 백오프를 적용한 3회 재시도로 에이전트가 항상 응답을 받도록 합니다.
• 팀 지원 — 팀원을 초대하고, 승인자 역할을 할당하며, 조직 전체에 걸쳐 결정을 범위 지정할 수 있습니다.

통합 방법

에이전트가 작업을 제출하고 결과를 폴링합니다.

제출

curl -X POST https://queuelo.com/api/actions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action_type": "deploy_code", "summary": "Deploy v2.1 to prod", "risk_level": "critical"}'

즉시 반환

{
  "id": "abc123",
  "status": "pending",
  "created_at": "..."
}

나중에 상태 확인

curl https://queuelo.com/api/actions/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

또는 callback_url 사용

작업을 제출할 때 callback_url을 제공하면 결정이 내려졌을 때 자동으로 알림을 받을 수 있습니다.

왜 중요한가

AI 에이전트가 빠르게 더 강력해지고 있습니다. 문제는 에이전트가 자율적으로 행동할 수 있느냐가 아니라, 모든 행동에 대해 그렇게 해야 하는가입니다.

• 위험도가 낮고 되돌릴 수 있는 작업은 자동 승인될 수 있습니다.
• 위험도가 높고 되돌릴 수 없는 작업은 매번 인간이 개입해야 합니다.

Queuelo는 에이전트를 다시 구축하지 않고도 이러한 제어 권한을 제공합니다.

무료로 시작할 수 있습니다 — queuelo.com