대시보드 에이전트
코드 없이 대시보드에서 AI 음성 에이전트를 만드는 방법. 실행 주체·설정 반영 시점·사용 가능한 도구·키패드 입력 처리를 설명합니다.
대시보드 에이전트
ClawOps 에서 AI 음성 에이전트를 만드는 방법은 두 가지입니다.
| 대시보드 에이전트 | Voice Agent SDK | |
|---|---|---|
| 만드는 방법 | 대시보드에서 설정 | Python 코드 작성 |
| 실행 | ClawOps 가 실행 | 직접 서버에서 상시 실행 |
| 도구 | 기본 도구 + MCP 연결 | 코드로 자유롭게 정의 |
| 적합한 경우 | 예약 접수·안내·상담 연결 | 자체 시스템과 깊게 연동 |
이 문서는 대시보드 에이전트 를 다룹니다.
누가 실행하나요
ClawOps 가 실행합니다. 전화가 걸려 오면 저장된 설정으로 에이전트 세션이 시작되고, 통화가 끝나면 정리됩니다. 별도로 서버를 띄우거나 프로그램을 상시 실행할 필요가 없습니다.
SDK 문서의 agent.serve() 는 에이전트를 직접 호스팅할 때 쓰는 방법입니다. 대시보드에서
만든 에이전트에는 필요하지 않습니다.
설정은 언제 반영되나요
다음 통화부터 적용됩니다. 진행 중인 통화에는 영향을 주지 않습니다.
프롬프트·음성·모델을 바꾸고 저장한 뒤 곧바로 전화를 걸면 새 설정으로 응답합니다.
사용할 수 있는 도구
에이전트 상세 → 도구 탭에서 확인할 수 있습니다.
| 도구 | 설명 | 켜는 곳 |
|---|---|---|
| 통화 종료 | 대화를 마치고 전화를 끊습니다 | 항상 켜짐 |
| DTMF 전송 | 상대방 ARS 에 키패드 신호를 보냅니다 | 항상 켜짐 |
| 지식 검색 | 등록한 문서에서 답을 찾습니다 | 「지식」 탭 |
| 통화 전환 | 담당자에게 연결합니다 | 「도구」 탭 → 통화 전환 |
| 외부 도구 | 직접 운영하는 MCP 서버의 도구를 호출합니다 | 「도구」 탭 → 외부 도구 연결 |
자체 서버의 함수를 통화 중에 호출하려면 외부 도구 연결(MCP) 을 사용하세요. SDK 의
@agent.tool 에 해당하는 기능을 대시보드에서 직접 정의할 수는 없습니다.
발신자의 키패드 입력 받기
전화 음질에서는 숫자 음성 인식이 자주 틀립니다. 연락처·주문번호처럼 정확해야 하는 값은 키패드로 받는 편이 안전합니다.
발신자가 누른 키는 자동으로 에이전트에게 전달됩니다. 별도 설정은 필요 없고, 시스템 프롬프트에 안내 문장만 넣으면 됩니다.
여러 자리를 받을 때는 「다 모일 때까지 기다리라」고 지시하세요. 이 문장이 없으면 에이전트가 중간에 끼어들어 "현재까지 010이 입력되었습니다" 같은 응답을 반복할 수 있습니다.
연락처는 음성으로 받지 말고 키패드로 받으세요.
"연락처를 키패드로 눌러 주세요" 라고 안내하십시오.
키패드 입력이 들어오면 숫자를 모아 두었다가, 11자리가 모이면
"눌러 주신 번호는 010-1234-5678 맞으실까요?" 처럼 전체 번호를 복창하십시오.
11자리가 안 모였으면 아무 말도 하지 말고 기다리십시오.입력이 잠시 끊기면 그때까지 눌린 숫자가 전달되므로, 발신자가 천천히 누르면 나누어 도착할 수 있습니다. 위와 같이 모아서 확인하라고 지시해 두면 나누어 도착해도 에이전트가 이어서 처리합니다.
자릿수를 지정하거나 # 으로 입력을 끝내는 방식은 대시보드 에이전트에서 지원하지 않습니다.
필요하시면 문의해 주세요.
발신자가 말이 없을 때
전화를 받고도 아무 말이 없는 경우를 위해 무응답 처리 를 켤 수 있습니다. 에이전트 상세 → 대화 탭 → 「통화 흐름」 카드입니다.
| 항목 | 범위 |
|---|---|
| 조용할 때 기다리는 시간 | 3 ~ 120초 |
| 다시 여쭤보는 횟수 | 0 ~ 5회 |
| 다시 여쭤볼 때 쓸 말 | 문구 입력 |
설정한 시간만큼 양쪽 다 말이 없으면 에이전트가 대화 상태를 보고 판단합니다. 접수가 남아 있으면 다시 여쭙고, 이미 마무리된 대화라면 통화를 종료합니다.
마무리 인사 뒤 전화가 끊기지 않는다면 이 기능을 켜 보세요. 인사만 하고 통화가 남아 있는 상태를 정리해 줍니다.
통화 전환
담당자에게 연결하려면 도구 탭 → 통화 전환에서 대상을 등록합니다. 에이전트에게는 등록한 이름만 보이고 번호는 노출되지 않습니다.
전환 안내(웜 트랜스퍼)를 켜면 담당자가 전화를 받은 직후, 발신자에게는 들리지 않는 한 문장을 먼저 들려줍니다. 문구에는 두 가지 변수를 쓸 수 있습니다.
| 변수 | 채워지는 값 |
|---|---|
{발신번호} | 걸려 온 번호 |
{사유} | 에이전트가 통화에서 파악한 문의 유형 |
예: {발신번호} 고객님, {사유} 문의입니다
안내 문구 전체를 에이전트가 작성하지는 않습니다. 고정 문구에 {사유} 만 채워집니다.
전환 결과를 시스템에서 받으려면 전환 웹훅을 사용하세요.
대기 시간과 대기 중 소리
연결되는 동안 발신자에게 들리는 소리와, 담당자를 기다리는 시간을 같은 화면에서 정합니다.
| 설정 | 값 | 기본 |
|---|---|---|
| 대기 시간 | 10~60초 | 30초 |
| 연결되는 동안 발신자에게 | 대기 음악 · 통화 연결음 · 무음 | 대기 음악 |
정한 시간 안에 담당자가 받지 않으면 전환이 실패하고 발신자의 통화도 종료됩니다. 에이전트가 다시 이어받지는 않습니다. 담당자가 통화 중이거나 전화를 거절하면 대기 시간을 채우지 않고 그 시점에 바로 종료됩니다.
「무음」은 발신자가 통화가 끊긴 것으로 오해하기 쉽습니다. 대기가 몇 초 이상 이어지는 구성이라면 대기 음악이나 통화 연결음을 권합니다.