← 노드 한 장 전체#79 · AI Agent Tool

AI Agent Tool

도구를 불렀다고, 제대로 위임한 건 아니었습니다.

이 글은 이런 분께부모 Agent가 하위 Agent에 실제로 원문을 위임했는지 검증하고 싶은 n8n 사용자

1분 영상은 @workflow.hanjang 에 순서대로 공개돼요

JSON 받기

도구를 불렀다고, 제대로 위임한 건 아니었습니다.

직접 쓴 가상 메모를 AI Agent Tool에 맡기고 자식 반환과 부모 최종 답을 대조했어요. 두 모델은 기존 gpt-4.1-mini입니다. 실습에서는 부모의 Force Tool Call on First Iteration을 켰습니다.

먼저 결과부터

확인 순서: 실제 도구 호출 → 자식에 원문이 전달됐는지 → 자식 최종 반환과 부모 최종 답이 같은지 → 형식·누락 검사. 이번 최종 실행은 원문 전달과 반환 일치가 확인됐지만 3줄 요청 미준수와 작성자 누락은 남았습니다. Parent Agent의 Tool에 native AI Agent Tool을, 그 Chat Model에 별도 gpt-4.1-mini 모델을 연결했어요. 최종실행3 generations, 첫 실패 포함 전체6 generations를 모두 기록했습니다. child 외부 도구·메모리는 연결하지 않았습니다.
우리가 실제로 돌린 기록 · 실행 #74963·#74966 · 2026-10-30

따라 하기

실제로 실행한 워크플로우를 바탕으로 정리했어요. 계정·식별자는 공개용 값으로 치환했고, 그 밖의 차이는 아래 주의사항에 표시했어요. n8n 캔버스에서 +를 눌러 노드를 순서대로 추가하고 같은 값을 넣으면 돼요. 빨간 제목이 이번 편의 주인공 노드예요. 표 왼쪽은 n8n 편집기에 보이는 칸 이름, 오른쪽은 다운로드 JSON의 설정값이에요. 직접 입력하기 번거로우면 JSON을 받아 ⋯ → Import from File로 가져오세요.

Step 1. Manual Trigger 노드 추가이름: Run manually

설정 없이 그대로 추가해요.

Step 2. AI Agent 노드 추가이름: Parent Agent

Source for Prompt (User Message)	Define below
Prompt (User Message)	다음은 직접 작성한 가상 메모입니다. Memo_Organizer 도구에 메모 원문을 전달해 정확히 한 번 위임하세요. 도구에는 작성/검토/기한 세 줄로 정리하도록 요청하세요. 도구 반환 후에는 그 세 줄을 변경하거나 설명을 추가하지 말고 그대로 최종 답으로 반환하세요. 직접 정리하거나 도구를 두 번 부르지 마세요. 가상 메모: 안내문 초안은 지민이 작성한다. 검토는 민수가 맡는다. 초안 마감은 금요일 오후 3시다.
Require Specific Output Format	꺼짐
Enable Fallback Model	꺼짐
Options › System Message	Memo_Organizer를 정확히1회 호출하세요. memo 인자에는 사용자가 준 가상 메모 원문 세 문장을 그대로 복사하세요. 지시문만 전달하면 실패입니다. 도구 반환 후 그 결과 텍스트를 글자·줄바꿈까지 그대로 최종 답으로 전달하세요. 직접 보충하거나 재작성하지 마세요. 생각 과정은 출력하지 마세요.
Options › Max Iterations	2
Options › Force Tool Call on First Iteration	켜짐
Options › Return Intermediate Steps	꺼짐
Options › Auto-save highlighted data	꺼짐
Options › Enable Streaming	꺼짐
Options › Automatically Passthrough Binary Images	꺼짐

Step 3. AI Agent Tool 노드 추가이름: Memo_Organizer

Description	가상 메모를 작성/검토/기한 세 줄로 정리하는 전용 하위 Agent입니다. 부모는 메모 원문과 정리 지시를 이 도구에 정확히 한 번 위임합니다.
Prompt (User Message)	{{ $fromAI('memo', '정리할 메모 원문 전체를 반드시 전달하세요. 작성자 이름, 검토자 이름, 마감 시점이 모두 포함된 실제 원문 세 문장입니다. 정리 지시만 전달하지 마세요.', 'string') }}
Require Specific Output Format	꺼짐
Enable Fallback Model	꺼짐
Options › System Message	가상 메모를 세 줄로 정리하는 하위 Agent입니다. 외부 도구는 없습니다. 전달된 메모의 사실만 사용하고 정확히 작성: 이름 / 검토: 이름 / 기한: 시점 형태의 세 줄을 반환하세요. 설명이나 생각 과정은 출력하지 마세요.
Options › Max Iterations	1
Options › Return Intermediate Steps	꺼짐
Options › Force Tool Call on First Iteration	꺼짐
Options › Auto-save highlighted data	꺼짐
Options › Enable Streaming	꺼짐
Options › Automatically Passthrough Binary Images	꺼짐

Step 4. OpenAI Chat Model 노드 추가이름: Parent Chat Model

Model	gpt-4.1-mini
Options › Sampling Temperature	0
Options › Maximum Number of Tokens	256
Options › Max Retries	0

Step 5. OpenAI Chat Model 노드 추가이름: Child Chat Model

Model	gpt-4.1-mini
Options › Sampling Temperature	0
Options › Maximum Number of Tokens	128
Options › Max Retries	0

가져와서 쓸 때 확인할 것

[실제 스키마] UI 이름 AI Agent Tool의 full type은 @n8n/n8n-nodes-langchain.agentTool v3입니다. 문서 URL의 toolaiagent와 type 문자열을 혼동하지 않습니다.
[실습 조건] Parent Force Tool Call on First Iteration=true입니다. 최초 호출을 강제한 실습이지 자율적 도구 선택 성능을 증명한 것이 아닙니다.
[실제 확인] 첫 #74963은 도구1회 호출에도 원문이 전달되지 않았고 자식/부모 반환이 달라 성공으로 판정하지 않았습니다.
[실제 확인] memo 인자를 명시한 #74966은 원문 전체 전달 및 도구1회 호출이 확인됐고, 자식 반환과 부모 최종 답은 글자 단위로 같았습니다.
[실제 확인] 최신 응답은 요청한3줄이 아니라1줄이고 작성자 지민은 누락됐습니다. 위임·그대로 전달 확인과 내용 완성/정확도는 별개입니다.
[실제 확인] 최종 Parent2+Child1=3 generations, 첫 실패 포함 전체 Parent4+Child2=6 generations입니다. 전체 도구 호출은2회이며 추가 호출하지 않았습니다.
[구조 확인] child에는 외부 tool/쓰기/메일/memory 연결이 없고, 두 모델 모두 기존 승인 gpt-4.1-mini, API Max Retries0을 사용했습니다.
[공개 범위] 작업 입력·최종 반환·횟수 및 검증 결과만 공개합니다. Return Intermediate Steps=false, 숨은 reasoning/thought 또는 raw trace는 배포하지 않습니다.
[문서 기준] subnode 표현식은 첫 item에 resolve됩니다. 여러 item이면 입력 범위를 따로 설계해야 합니다.
YOUR_… 표시를 내 값으로 바꾸고, 계정이 필요한 서비스 노드만 자격 증명을 연결하세요. 그런 칸이나 노드가 없는 예제는 추가 계정 없이 실행할 수 있어요.

노드의 모든 옵션은 n8n 공식 문서에서 볼 수 있어요.

← #78 Token Splitter