> ## 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.

# 도구 개요

> 강력한 함수 호출 도구로 에이전트의 기능을 확장할 수 있습니다.

에이전트의 능력을 강력한 함수 호출 도구로 확장하세요. 도구를 사용하면 에이전트는 단순한 대화를 넘어 작업을 수행할 수 있습니다. 외부 데이터에 접근하거나, 애플리케이션 내의 특정 작업을 트리거하는 등 다양한 작업을 처리할 수 있게 됩니다.

## 사용 가능한 도구 유형

에이전트의 기능을 확장하기 위해 다음과 같은 도구 유형을 사용할 수 있습니다.

* **빌트인 도구**: 통화 종료, 통화 전환, 에이전트 전환, SMS 발송, DTMF 전송 등 플랫폼이 기본 제공하는 도구입니다. 별도 서버 구현 없이 설정만으로 사용할 수 있습니다.
* **API 도구**: 자체 시스템 및 비즈니스 로직을 에이전트에 연결합니다. 백엔드, DB, 타사 API와 유연하게 통합할 수 있습니다.

## API로 도구를 수정할 때

API, MCP, CLI로 에이전트를 수정할 때는 `data.builtInTools`를 전체 배열 교체 값으로 다룹니다.
프롬프트만 바꾸는 경우에는 `builtInTools`를 보내지 마세요.
기본 도구를 모두 제거하려면 `builtInTools: []`를 보내세요.
`builtInTools: null`은 삭제가 아니라 잘못된 요청입니다.
도구를 추가하거나 수정해야 한다면 먼저 현재 에이전트를 조회하고, 기존 도구 객체의 설정을 유지한 전체 배열을 다시 보내세요.

<Warning>
  기본 도구 목록을 새로 만들면 안내 후 전환, 발신자 표시, 실행 중 발화,
  끼어들기 허용, 응답 대기 방식, 스킬 내용 같은 설정이 기본값으로 돌아갈 수 있습니다.
</Warning>

## 주요 기능

```mermaid theme={null}
sequenceDiagram
    participant U as 사용자
    participant A as 에이전트(LLM)
    participant T as 도구
    U->>A: 질문/요청
    A->>A: 도구 호출 필요 판단
    A->>T: 도구 실행
    T-->>A: 결과 반환
    A->>U: 응답
```

* **함수 호출 (Function Calling)**: 에이전트가 대화의 맥락을 파악하여, 정의된 도구를 적절한 시점에 동적으로 호출하고 작업을 수행합니다.
* **유연한 통합**: 빌트인 도구로 일반적인 통화 플로우를 빠르게 구성하고, 필요에 따라 맞춤형 API 도구를 직접 구축해 확장할 수 있습니다.
* **서버 연동**: API 도구를 통해 사용자의 백엔드 서버와 직접 통신하며, 요청/응답 흐름을 에이전트 대화에 자연스럽게 결합합니다.
* **확장성**: 새로운 도구를 지속적으로 추가하여 에이전트의 작업 수행 능력을 계속해서 확장하고 고도화할 수 있습니다.

더 알아보기:

* [빌트인 도구](./builtin/end-call)
* [API 도구](./api)

***

<Accordion title="연관 검색어">
  도구, tools, 함수 호출, function calling, 빌트인 도구, API 도구, 도구 유형
</Accordion>