AI Agent Tool 노드 문서
n8n v2.29AI Agent Tool 노드를 사용하면 워크플로의 루트 레벨 에이전트1가 다른 에이전트를 도구로 호출하여 멀티 에이전트 오케스트레이션을 단순화할 수 있습니다. 기본 에이전트는 서로 다른 작업과 지식에 특화된 AI Agent Tool 노드에 작업을 감독하고 위임할 수 있습니다.
AI Agent Tool 노드를 사용하면 워크플로의 루트 레벨 에이전트1가 다른 에이전트를 도구로 호출하여 멀티 에이전트 오케스트레이션을 단순화할 수 있습니다.
기본 에이전트는 서로 다른 작업과 지식에 특화된 AI Agent Tool 노드에 작업을 감독하고 위임할 수 있습니다. 이를 통해 서브 워크플로가 요구하는 컨텍스트와 변수 관리의 복잡성 없이 단일 워크플로에서 여러 에이전트를 사용할 수 있습니다. 더 복잡한 다계층 사용 사례를 위해 AI Agent Tool 노드를 여러 계층으로 중첩할 수도 있습니다.
이 페이지에서는 AI Agent Tool 노드의 노드 매개변수와 추가 자료 링크를 확인할 수 있습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
노드 매개변수#
다음 매개변수를 사용하여 AI Agent Tool 노드를 구성하세요.
- Description: 이 에이전트의 목적과 책임 범위를 LLM에 설명합니다. 좋은 설명은 구체적이어야 하며, 상위 에이전트가 언제 이 에이전트에 작업을 위임해야 하는지 알려줍니다.
- Prompt (User Message): 어떤 작업을 수행하고 어떤 정보를 반환해야 하는지 LLM에 설명하는 프롬프트입니다.
- Require Specific Output Format: 노드가 특정 출력 형식을 요구하도록 할지 여부입니다. 활성화하면 n8n은 기본 에이전트 페이지에 설명된 출력 파서 중 하나를 연결하도록 안내합니다.
- Enable Fallback Model: 폴백 모델을 활성화할지 여부입니다. 활성화하면 n8n은 기본 모델이 실패하거나 사용할 수 없을 때 사용할 백업 채팅 모델을 연결하도록 안내합니다.
노드 옵션#
다음 옵션을 사용하여 AI Agent Tool 노드의 동작을 세부 조정하세요.
- System Message: 대화가 시작되기 전에 에이전트에 보낼 메시지입니다.
- Max Iterations: 응답을 생성하기 위해 모델이 중단하기 전까지 실행할 최대 횟수입니다.
- Return Intermediate Steps: 에이전트가 수행한 중간 단계를 최종 출력에 포함할지 여부입니다.
- Automatically Passthrough Binary Images: 바이너리 이미지를 이미지 타입 메시지로 에이전트에 자동으로 전달할지 여부입니다.
- Batch Processing: 다음 속도 제한용 배치 처리 옵션을 활성화할지 여부입니다.
- Batch Size: 병렬로 처리할 항목 수입니다. 속도 제한에 도움이 되지만 로그 출력 순서에 영향을 줄 수 있습니다.
- Delay Between Batches: 배치 간 대기할 밀리초 수입니다.
템플릿 및 예제#
AI Agent Tool 노드 문서 통합 템플릿 둘러보기 또는 모든 템플릿 검색
$fromAI()를 사용한 도구용 동적 매개변수#
앱 노드 도구의 매개변수를 동적으로 채우는 방법을 알아보려면 $fromAI()로 AI가 도구 매개변수를 지정하도록 하기를 참고하세요.
Footnotes
-
AI 에이전트는 요청에 응답하고, 결정을 내리고, 사용자를 위해 실제 작업을 수행할 수 있는 인공지능 시스템입니다. AI 에이전트는 대규모 언어 모델(LLM)을 사용해 사용자 입력을 해석하고, 사용 가능한 정보와 리소스를 활용해 요청을 가장 잘 처리하는 방법에 대한 결정을 내립니다. ↩