위험 작업 승인 (Human-in-the-Loop)

사람이 개입하는 승인 흐름

자율 에이전트의 도구 실행은 입력창의 톱니 메뉴 → 에이전트 설정 → 작업 승인에서 선택한 모드에 따릅니다. 실행 전 사용자가 검토하고 허용하거나 거절하는 흐름을 **Human-in-the-Loop(HITL)**이라고 부릅니다.

변경은 즉시 저장되며 이후 도구 작업부터 적용됩니다. 에이전트가 시작되기 전 저장한 설정은 시작할 때 적용됩니다.

스마트 모드에서는 작업의 내용과 인자에 따라 승인 여부를 판단합니다. 다음과 같은 작업을 검토할 때는 실행 대상과 범위를 확인하세요.

• 파일 삭제 또는 덮어쓰기
• 외부 네트워크 호출(웹 크롤링, API 호출)
• 패키지 설치
• 터미널 명령 실행 중 rm, chmod 등 파괴적 명령

승인 요청 화면

에이전트가 승인이 필요한 작업에 도달하면:

1. 채팅 화면에 "승인 대기" 상태가 표시됩니다.
2. 실행하려는 작업의 요약(도구 이름, 인자, 대상)이 노출되고, 코드 보기 로 실행 명령을 먼저 확인할 수도 있습니다.
3. 사용자는 다음 중 하나를 선택합니다.

[!TIP]

• 반복되는 안전한 작업이라면 이번 세션 승인 을 사용해 흐름을 끊지 마세요.
• 세션 승인은 해당 대화 세션에서만 유효합니다. 새 대화에서는 다시 묻습니다.

승인 대기 중 동작

• 에이전트는 대기 상태로 전환되어 응답을 멈춥니다.
• 입력창에 "현재 작업에 반영하거나 순서대로 실행해요…" 메시지가 표시됩니다.
• 추가 입력은 가능하면 현재 에이전트 작업의 다음 도구 경계에 반영되고, 이미 마무리된 경우에는 답변 후 다음 실행으로 자동 연결됩니다.
• 사용자가 메시지를 입력하면, 승인 처리 후 대기열에 추가되어 에이전트 응답이 끝나면 자동으로 전송됩니다.

실행 중단

에이전트 모드의 실행은 자율적으로 진행되므로 채팅 화면에서 중단할 수 없습니다. 승인을 거절하면 해당 작업은 실행되지 않고 에이전트가 피드백을 받아 다음 행동을 결정합니다. (빠른 대화의 스트리밍 응답은 입력창의 중단 버튼으로 멈출 수 있습니다.)

[!WARNING]

• 이미 외부에 side-effect를 일으킨 작업(예: 이미 실행된 삭제 명령)은 거절해도 되돌릴 수 없습니다.

감사 로그

에이전트가 접근하는 모든 리소스(도구 호출, 지식 베이스 검색, 노트 조작, 파일 전달)는 감사 로그에 기록됩니다. 이 로그는 관리자가 /admin/agent-runtime/audit-logs 에서 조회할 수 있습니다.

자세한 내용은 관리자 가이드 → 감사 로그 를 참고하세요.

다음 단계

• 채팅 설정 — 모델·추론·비전 등 세부 옵션
• 도구 등록 — 외부 API · MCP를 에이전트에 연결