> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구 노드

> 플로우 에이전트에서 외부 도구를 실행하는 도구 노드를 설정하는 방법을 안내합니다.

도구 노드는 플로우 대화 중에 외부 도구를 실행하는 노드입니다. 에이전트 설정에 등록된 도구를 선택하여 특정 시점에 실행할 수 있습니다.

## 언제 사용하나요

* 대화 중 외부 시스템의 데이터를 **조회**하거나 **조작**해야 할 때 (예: 주문 상태 조회, CRM 조회)
* API 노드보다 **재사용 가능한 도구**를 만들어 여러 플로우에서 공유하고 싶을 때
* 도구 실행 결과에 따라 **대화 흐름을 분기**해야 할 때

<Info>
  API 노드와의 차이점: API 노드는 노드 안에서 직접 HTTP 요청을 설정하고, 도구 노드는 미리 등록된 도구를 선택해서 실행합니다. 같은 API를 여러 플로우에서 호출해야 한다면 도구로 등록하여 재사용하는 것이 효율적입니다.
</Info>

## 설정

### 도구 선택

에이전트에 등록된 도구 목록에서 실행할 도구를 선택합니다. 도구가 없으면 에이전트 설정에서 먼저 도구를 추가해야 합니다.

선택한 도구의 [응답 대기 방식](/docs/build/tools/api#응답-대기-방식) 설정은 노드에 그대로 상속됩니다 — 노드에서 별도로 변경할 수 없습니다. `요청만 보내고 계속 진행(fire_and_forget)` 도구는 결과 기반 전환 조건과 함께 쓸 수 없습니다.

<Info>
  도구 생성 및 관리 방법은 [도구 개요](/docs/build/tools/overview)를 참조하세요.
</Info>

### 프롬프트

도구 실행 전후에 에이전트가 사용자에게 전달할 메시지를 설정합니다.

| 타입          | 설명                     |
| ----------- | ---------------------- |
| **없음**      | 메시지 없이 도구만 실행합니다.      |
| **고정 발화**   | 미리 작성한 고정 문장을 말합니다.    |
| **동적 프롬프트** | LLM이 상황에 맞는 응답을 생성합니다. |

### 전환 조건

도구 실행 결과에 따라 다른 노드로 분기할 수 있습니다. 성공/실패 등 결과에 따라 전환 조건을 설정하세요.

## 사용 예시

* 주문 상태 조회 도구를 호출한 후 결과에 따라 안내 노드 또는 에러 처리 노드로 분기
* CRM 시스템에서 고객 정보를 조회한 후 VIP/일반 고객별 대화 흐름 분기

***

<Accordion title="연관 검색어">
  도구 노드, tool node, 도구 실행, 도구 호출, custom tool, tool execution, 외부 도구
</Accordion>