Skip to main content
도구는 에이전트가 통화 중에 대화 맥락을 보고 스스로 부르는 기능이에요. 이렇게 에이전트가 도구를 골라 부르고 결과를 받아 답을 잇는 것을 함수 호출(Function Calling)이라고 해요. 도구 추가 메뉴의 빌트인 도구와 커스텀 도구 목록 도구는 에이전트 설정의 도구에서 추가를 눌러 붙이세요. 빌트인 도구는 설정 창만 채우면 되고, 커스텀 도구는 구축 > 도구에서 먼저 만들어 두세요. 어떤 도구든 함수 설명과 프롬프트에 부를 상황을 함수 이름으로 적어야 에이전트가 제때 불러요.

통화 끝내고 넘기기

통화 종료

대화가 끝났다고 판단되면 에이전트가 스스로 통화를 끊게 할 수 있어요.

통화 전환

사람 상담사나 외부 번호로 통화를 넘길 수 있어요.

에이전트 전환

같은 워크스페이스의 다른 에이전트에게 응대를 넘길 수 있어요.

통화 중에 일 처리하기

문자 발신

통화 중인 고객에게 예약 정보나 링크를 문자로 보낼 수 있어요.

DTMF 전송

ARS 안내에 맞춰 번호를 눌러 원하는 메뉴나 내선으로 들어갈 수 있어요.

주소 검색

통화 중 들은 주소로 후보를 찾고 고객에게 확인받을 수 있어요.

변수 추출

고객이 말하거나 키패드로 누른 값을 변수에 저장해 프롬프트와 다른 도구에서 쓸 수 있어요.

자체 시스템 연결하기

주문 조회나 예약 접수처럼 자체 서버가 필요한 일은 API 도구로 연결하세요. 에이전트가 대화에서 얻은 값으로 요청을 보내고, 응답을 보고 답을 이어가요. 플로우의 정해진 지점에서 실행하려면 도구 노드를 쓰세요.

공통 실행 설정

변수 추출을 뺀 빌트인 도구 여섯 가지는 설정 창에 아래 두 칸이 똑같이 있어요. 변수 추출은 부르는 즉시 끝나서 이 칸과 실행 대기음이 없어요.
  • 실행 전 말하기: 도구를 실행하기 직전에 고객에게 할 말이에요. 메시지를 여러 개 넣으면 호출할 때마다 그중 하나를 말하고, 끄면 말없이 실행해요.
  • 도구 실행 중 끼어들기 허용: 켜 두면 실행 중에 고객이 말할 때 실행을 멈추고 대화로 돌아가요. 끄면 실행이 끝날 때까지 고객이 끼어들 수 없어요. 주소 검색은 꺼짐, 나머지 도구는 켜짐이 기본값이에요.
문자 발신과 API 도구에는 결과를 기다릴지 정하는 응답 대기 방식이 더 있어요. 동작은 API 도구에 있어요. 실행하는 동안 무음 대신 소리를 재생하려면 실행 대기음을 고르세요.

API로 빌트인 도구 바꾸기

API, MCP, CLI로 에이전트를 수정할 때는 data.builtInTools를 배열 전체를 바꾸는 값으로 다뤄요.
  • 프롬프트만 바꿀 때는 builtInTools를 보내지 마세요.
  • 빌트인 도구를 모두 빼려면 builtInTools: []를 보내세요. builtInTools: null은 삭제가 아니라 잘못된 요청이에요.
  • 도구를 더하거나 고칠 때는 먼저 에이전트를 조회하고, 기존 도구 객체의 설정을 그대로 둔 전체 배열을 다시 보내세요.
도구 목록을 새로 만들어 보내면 안내 후 전환, 발신자 표시, 실행 전 말하기, 끼어들기 허용, 응답 대기 방식, 스킬 내용 같은 설정이 기본값으로 돌아갈 수 있어요.

관련 문서

  • API 도구: 자체 서버나 외부 API를 호출하는 도구 만들기
  • 실행 대기음: 도구가 실행되는 동안 재생할 소리 고르기
  • 도구 노드: 플로우의 정해진 지점에서 도구 실행하기