n8n AI Agent의 도구 호출에 사람 승인 단계를 붙여 되돌리기 어려운 작업부터 막아보세요
쿠팡 파트너스 활동으로 수수료를 받을 수 있음
먼저 결론
n8n AI Agent 노드에서는 도구를 실행하기 전에 사람이 승인하도록 Human review 단계를 끼울 수 있어요. 삭제나 외부 발송처럼 되돌리기 어려운 도구에만 먼저 붙이고, 거절됐을 때 에이전트가 어떻게 답할지는 시스템 프롬프트에 적어 두세요.
어떤 도구에 사람 승인을 붙이면 되나요?
되돌릴 수 없거나 바깥으로 나가는 작업이 먼저예요. 공식 문서는 데이터 삭제, 외부 커뮤니케이션, 구매 같은 되돌리기 어려운 작업과 규정상 사람의 승인이 필요한 작업, 영향이 큰 결정을 예로 들어요.
승인은 AI Agent 노드에 붙은 모든 도구에 걸 수도 있고, 고른 도구에만 걸 수도 있어요. 처음에는 위험한 도구 하나에만 걸어 두고, 승인 요청을 몇 번 받아 본 뒤 범위를 넓히거나 줄이면 돼요. 문서도 처음에는 검토를 켜 두고 신뢰가 쌓이면 감독을 줄이는 방식을 권해요. 조회처럼 결과를 되돌릴 수 있는 도구는 승인 없이 두면 검토자가 받는 요청 수를 줄일 수 있어요.
승인 단계는 어떻게 연결하나요?
흐름은 에이전트가 승인 대상 도구를 고름 → 워크플로 일시 정지 → 승인 채널로 요청 전송 → 검토자 응답 → 도구 실행 또는 취소 순서예요. 설정은 AI Agent 노드 안에서 끝나요.
- AI Agent 노드의 Tools 커넥터를 눌러 도구 패널을 열어요.
- 패널의 Human review 섹션에서 승인 채널을 고르고 자격 증명과 설정을 채워요.
- 승인을 받아야 하는 도구를 Human review 단계의 도구 커넥터에 연결하고, 각 도구는 평소처럼 설정해요.
승인이 필요 없는 도구는 연결하지 않고 그대로 두면 돼요. 이미 만들어 둔 워크플로를 도구로 붙이는 방법은 /workflow/n8n-agents-workflow-tools-preview/에서 다뤘어요.
승인 요청 메시지에는 무엇을 보여 주나요?
검토자가 무엇을 승인하는지 알아야 하니 도구 이름과 매개변수를 함께 보내요. 문서가 제공하는 표현식은 두 가지예요.
$tool.name은 캔버스에 보이는 도구 노드 이름이에요.$tool.parameters는 AI가 도구에 넘기려는 매개변수예요.$fromAI()로 채워진 필드도 들어 있어요.
문서의 메시지 예시는 "The AI wants to use" 뒤에 $tool.name을 넣고, 다음 줄에 JSON.stringify($tool.parameters, null, 2) 결과를 붙이는 형태예요. $fromAI()가 승인 대상 도구에서도 동작하기 때문에, 검토자는 AI가 정한 값을 직접 보고 승인해요. 이 메시지 형식은 문서의 예시일 뿐이라 채널마다 화면이 어떻게 보이는지는 직접 열어 봐야 알 수 있어요.
승인 채널은 무엇을 고를 수 있나요?
문서에 적힌 채널은 n8n 내장 Chat, Slack, Discord, Telegram, Microsoft Teams, Gmail, WhatsApp Business Cloud, Google Chat, Microsoft Outlook이에요. 검토 채널은 에이전트와 대화하는 채널과 달라도 돼요. 사용자는 n8n Chat에서 에이전트와 이야기하고, 승인 요청은 정해 둔 담당자의 Slack으로 보내는 식이에요.
승인할 사람이 어느 채널을 가장 빨리 보는지부터 정하세요. 메신저를 자주 열지 않는 담당자에게 Slack으로만 요청을 보내면 워크플로가 오래 멈춰 있을 수 있어요.
승인하거나 거절하거나 답이 없으면 어떻게 되나요?
| 검토자 응답 | 도구 동작 | 에이전트 쪽 |
|---|---|---|
| 승인 | AI가 지정한 입력으로 도구 실행 | 도구 결과를 받아 이어감 |
| 거절 | 실행 취소 | 거절됐다는 사실을 전달받음 |
| 응답 없음 | 문서에 적혀 있지 않음 | 문서에 적혀 있지 않음 |
확인일: 2026-10-27 KST (출처: n8n 공식 문서 Human-in-the-loop for tools)
문서는 승인이 필요한 도구와 Human review 설정을 시스템 프롬프트에도 적으라고 안내해요. 에이전트가 거절을 알고 있어야 사용자에게 상황을 알리거나 다른 방법을 제안하거나 되물을 수 있기 때문이에요. 프롬프트에는 어떤 도구가 승인을 거치는지, 거절되면 같은 호출을 반복하지 말고 무엇을 할지를 적어 두세요.
문서에는 버전이나 요금제 조건도 적혀 있지 않아요. 쓰는 n8n 환경에서 Human review 섹션이 보이는지는 도구 패널을 열어서 확인하세요.
운영에 넣기 전에 무엇을 시험하나요?
- 승인 대상 도구가 정말 Human review 단계에 연결됐는지 도구 패널에서 확인해요.
- 승인 요청 메시지에 도구 이름과 매개변수가 읽히는 모양으로 나오는지 봐요.
- 거절했을 때 도구가 실행되지 않고 에이전트가 시스템 프롬프트에 적은 대로 답하는지 확인해요.
- 일부러 응답하지 않고 두어서 워크플로가 어떤 상태로 남는지 기록해 둬요.
- 하위 에이전트를 도구로 쓴다면 그 안의 승인 단계도 따로 시험해요. 문서는 이 경우에도 하위 에이전트의 사람 확인 단계가 제대로 동작한다고 안내해요.
먼저 삭제나 발송처럼 실제로 피해가 없는 시험용 대상 하나를 정해서 승인과 거절을 번갈아 눌러 보세요.
자주 묻는 질문
승인 단계는 AI Agent의 모든 도구에 꼭 붙여야 하나요?
아니에요, 공식 문서는 AI Agent 노드의 모든 도구에 적용할 수도 있고 선택한 도구에만 적용할 수도 있다고 설명해요.
승인 요청을 받는 채널은 에이전트와 대화하는 채널과 같아야 하나요?
아니에요, 검토 채널은 주 대화 채널과 달라도 돼요. 예를 들어 n8n Chat으로 에이전트와 대화하고 승인 요청은 Slack으로 받을 수 있어요.
검토자가 승인 요청에 응답하지 않으면 어떻게 되나요?
공식 문서에는 응답이 없을 때의 동작이 적혀 있지 않아요. 운영에 넣기 전에 직접 시험해서 확인해야 해요.
--- 공식 출처: n8n Docs (확인일 2026-10-27 KST) - Human-in-the-loop for tools: https://docs.n8n.io/advanced-ai/human-in-the-loop-tools/
자주 묻는 질문
승인 단계는 AI Agent의 모든 도구에 꼭 붙여야 하나요?
아니에요, 공식 문서는 AI Agent 노드의 모든 도구에 적용할 수도 있고 선택한 도구에만 적용할 수도 있다고 설명해요.
승인 요청을 받는 채널은 에이전트와 대화하는 채널과 같아야 하나요?
아니에요, 검토 채널은 주 대화 채널과 달라도 돼요. 예를 들어 n8n Chat으로 에이전트와 대화하고 승인 요청은 Slack으로 받을 수 있어요.
검토자가 승인 요청에 응답하지 않으면 어떻게 되나요?
공식 문서에는 응답이 없을 때의 동작이 적혀 있지 않아요. 운영에 넣기 전에 직접 시험해서 확인해야 해요.
출처와 확인일
모든 자료는 제조사·판매처가 공개한 내용을 확인한 것이며, 확인 이후 달라졌을 수 있습니다.