다크 모드
Tool 노드
Tool은 Studio가 제공하는 도구 또는 연결된 MCP 서버의 도구를 실행하는 노드입니다. 선택한 모델이 메시지와 도구의 매개변수 스키마를 바탕으로 호출 인자를 만든 뒤 도구를 한 번 실행합니다.
언제 사용하나요?
- 웹을 검색하거나 웹 페이지의 내용을 가져올 때
- MCP 서버가 제공하는 조회, 생성, 변경 작업을 워크플로우에서 실행할 때
- 이전 노드의 결과를 외부 도구의 입력 매개변수로 변환해 전달할 때
입력
Tool은 Message에 작성한 지시와 /로 삽입한 이전 노드의 출력값을 입력으로 사용합니다. 선택한 도구의 매개변수 스키마가 있으면 모델이 메시지를 해석해 해당 스키마에 맞는 호출 인자를 생성합니다.
예를 들어 Web Search 도구를 선택하고 Message에 다음과 같이 작성할 수 있습니다.
text
INPUT.topic을 검색어로 사용하세요. 결과는 5개만 반환하세요.실제 편집기에서는 INPUT.topic 부분을 직접 입력하지 않고 /로 해당 변수를 삽입합니다.
주요 설정
| 설정 | 설명 |
|---|---|
| 이름 | 캔버스와 실행 이력에 표시할 고유한 노드 이름입니다. |
| 설명 | 이 도구 호출이 워크플로우에서 맡는 역할을 기록합니다. |
| Tool | 실행할 Studio 기본 도구 또는 연결된 MCP 도구를 선택합니다. |
| Description and Schema | 선택한 도구의 설명, 매개변수 이름, 타입, 필수 여부를 보여줍니다. 별표가 있는 매개변수는 필수입니다. |
| Model | 메시지를 도구 호출 인자로 변환할 모델입니다. 지원하는 모델은 추론 강도도 선택할 수 있습니다. |
| Message | 모델이 도구 매개변수를 만들 때 사용할 지시와 이전 노드의 값을 작성합니다. |
Studio 기본 도구 목록에는 Web Search와 Web Content가 포함됩니다. MCP 도구는 현재 사용할 수 있는 MCP 서버의 도구 목록에서 선택합니다.
출력
| 필드 | 타입 | 설명 |
|---|---|---|
tool_result | Object | 도구가 반환한 결과입니다. 실제 내부 필드와 값은 선택한 도구에 따라 달라집니다. |
다음 노드에서는 /를 입력해 TOOL.tool_result를 참조할 수 있습니다. 반환 형태가 중요한 경우 테스트 실행에서 실제 결과를 확인한 뒤 Transform이나 Code로 필요한 필드만 정리하세요.
연결과 배치 제약
- Tool, Model, Message를 모두 설정해야 워크플로우 검증을 통과합니다.
- Message에서 참조할 수 있는 값은 같은 실행 범위의 도달 가능한 이전 노드 출력으로 제한됩니다.
- Tool은 루트 워크플로우뿐 아니라 Loop와 Iteration 내부에도 배치할 수 있습니다.
- 컨테이너 안팎을 가로지르는 연결은 만들 수 없습니다.
- 선택한 MCP 도구가 실행 시점에도 존재하고 현재 사용자에게 접근 가능해야 합니다.
예시
주제에 관한 최신 자료를 검색하는 흐름은 다음과 같이 만들 수 있습니다.
- Input에 필수 String 필드
topic을 추가합니다. - Tool에서 Web Search를 선택합니다.
- 도구 설명과 매개변수 스키마에서
query가 필수인지 확인합니다. - Model을 선택합니다.
- Message에 “
/INPUT.topic을 query로 사용하고 결과 5개를 찾아 주세요.”라고 작성합니다. - 다음 LLM에서
/TOOL.tool_result를 참조해 검색 결과를 요약합니다.
주의사항
- Message에는 필수 매개변수가 어떤 값에서 만들어져야 하는지 명확하게 적으세요. 모델이 모호한 지시를 받으면 잘못된 인자를 생성할 수 있습니다.
tool_result의 구조는 도구마다 다릅니다. 도구를 바꾸면 후속 노드가 기대하는 결과 형태도 다시 확인하세요.- 생성, 수정, 삭제처럼 외부 상태를 바꾸는 MCP 도구는 테스트 입력과 권한을 먼저 점검하세요.
- MCP 서버의 연결 정보와 인증 값은 MCP 설정에서 관리하고 Message에 비밀 값을 직접 적지 마세요.
- 매개변수 스키마가 있는 도구는 모델이 호출 인자를 만든 뒤 도구를 실행하므로 두 단계의 지연 시간과 실패 가능성을 고려하세요.