사용 가능한 도구 유형
에이전트의 기능을 확장하기 위해 다음과 같은 도구 유형을 사용할 수 있습니다.- 빌트인 도구: 통화 종료, 통화 전환, 에이전트 전환, SMS 발송, DTMF 전송, 주소 검색 등 플랫폼이 기본 제공하는 도구입니다. 별도 서버 구현 없이 설정만으로 사용할 수 있습니다.
- API 도구: 자체 시스템 및 비즈니스 로직을 에이전트에 연결합니다. 백엔드, DB, 타사 API와 유연하게 통합할 수 있습니다.
API로 도구를 수정할 때
API, MCP, CLI로 에이전트를 수정할 때는data.builtInTools를 전체 배열 교체 값으로 다룹니다.
프롬프트만 바꾸는 경우에는 builtInTools를 보내지 마세요.
기본 도구를 모두 제거하려면 builtInTools: []를 보내세요.
builtInTools: null은 삭제가 아니라 잘못된 요청입니다.
도구를 추가하거나 수정해야 한다면 먼저 현재 에이전트를 조회하고, 기존 도구 객체의 설정을 유지한 전체 배열을 다시 보내세요.
실행 대기음
도구가 실행되는 동안 통화가 무음이 되지 않도록 소리를 재생할 수 있습니다. 실행 전 말하기로 앞부분을 채우더라도, 발화가 끝난 뒤 결과가 올 때까지는 여전히 비어 있습니다. 대기음은 그 남는 구간을 — 도구가 연달아 호출되거나 응답 생성이 길어지는 구간까지 — 에이전트가 다시 말하기 시작할 때까지 채웁니다. 커스텀 API 도구와 주소 검색 도구마다 실행 대기음을 하나 설정합니다. 지원 Flow 노드에도 설정할 수 있습니다. 값은none(소리 없음) · typing(타이핑음) · elevator_1~elevator_4(대기 음악 4종)이고 기본값은 소리 없음입니다. 도구 단위 설정만 있으며, 에이전트 전체 기본값은 따로 없습니다.
재생 시점은 설정 항목이 아니라 통화 상태에서 자동으로 정해집니다.
- 발화 중에는 들리지 않습니다. 실행 전 말하기나 응답이 재생되는 동안 대기음은 완전히 멈췄다가, 발화가 끝나면 이어서 재생됩니다 (처음부터 다시 시작하지 않습니다)
- 답변이 시작되는 순간 사라집니다. 사용자가 말을 시작해도 즉시 멈춥니다
- 짧게 끝나는 도구에는 재생되지 않습니다. 타이핑음은 약 0.2초, 대기 음악은 약 0.5초 이상 무음이 이어질 때만 들어옵니다
- 대기 음악은 스쳐 지나가지 않습니다. 음악이 들리기 시작했다면 최소 길이를 채우도록 답변이 아주 짧게(최대 1.5초) 기다릴 수 있습니다 — 반쯤 오르다 끊기는 소리가 오히려 잡음으로 들리기 때문입니다
지원 범위
커스텀 API 도구와 주소 검색 도구에서 설정할 수 있습니다. 흐름 에이전트에서는api·tool·sendSms 노드를 지원합니다. MCP, 다른 빌트인 도구, transferAgent 노드는 공개 설정 대상이 아닙니다. 허용되지 않는 값은 저장 시 거부됩니다.
자세한 동작과 설정 방법은 실행 대기음을 참고하세요.
주요 기능
- 함수 호출 (Function Calling): 에이전트가 대화의 맥락을 파악하여, 정의된 도구를 적절한 시점에 동적으로 호출하고 작업을 수행합니다.
- 유연한 통합: 빌트인 도구로 일반적인 통화 플로우를 빠르게 구성하고, 필요에 따라 맞춤형 API 도구를 직접 구축해 확장할 수 있습니다.
- 서버 연동: API 도구를 통해 사용자의 백엔드 서버와 직접 통신하며, 요청/응답 흐름을 에이전트 대화에 자연스럽게 결합합니다.
- 확장성: 새로운 도구를 지속적으로 추가하여 에이전트의 작업 수행 능력을 계속해서 확장하고 고도화할 수 있습니다.
연관 검색어
연관 검색어
도구, tools, 함수 호출, function calling, 빌트인 도구, API 도구, 도구 유형