대시보드 에이전트

대시보드 에이전트

ClawOps 에서 AI 음성 에이전트를 만드는 방법은 두 가지입니다.

이 문서는 대시보드 에이전트 를 다룹니다.

누가 실행하나요

ClawOps 가 실행합니다. 전화가 걸려 오면 저장된 설정으로 에이전트 세션이 시작되고, 통화가 끝나면 정리됩니다. 별도로 서버를 띄우거나 프로그램을 상시 실행할 필요가 없습니다.

설정은 언제 반영되나요

다음 통화부터 적용됩니다. 진행 중인 통화에는 영향을 주지 않습니다.

프롬프트·음성·모델을 바꾸고 저장한 뒤 곧바로 전화를 걸면 새 설정으로 응답합니다.

사용할 수 있는 도구

에이전트 상세 → 도구 탭에서 확인할 수 있습니다.

발신자의 키패드 입력 받기

전화 음질에서는 숫자 음성 인식이 자주 틀립니다. 연락처·주문번호처럼 정확해야 하는 값은 키패드로 받는 편이 안전합니다.

발신자가 누른 키는 별도 설정 없이도 에이전트에게 전달됩니다. 다만 언제 전달할지는 정해 두는 편이 정확합니다 — 에이전트 상세 → 대화 탭 → 「통화 흐름」 카드의 「키패드 입력 설정」입니다.

둘을 같이 켜면 먼저 오는 쪽이 전달합니다.

종료 키 (권장)

# 또는 * 를 고릅니다. 발신자가 그 키를 누르면 그때까지 누른 값이 전달되고, 이 키 자체는 값에 포함되지 않습니다.

1234#     →  1234
900101#   →  900101

자리수와 무관하게 정확합니다. 한 통화에서 차량번호 4자리도 받고 생년월일 6자리도 받는 구성이라면 이것만 켜면 됩니다.

시스템 프롬프트에는 안내 문장을 넣어 주십시오.

연락처는 음성으로 받지 말고 키패드로 받으세요.
"연락처를 누르시고 마지막에 우물정자를 눌러 주세요" 라고 안내하십시오.

자리수 고정

받을 자리수가 매번 같을 때만 채우십시오. 비워 두면 자리수로는 확정하지 않습니다.

자리수 4로 정해 둔 경우
1234      →  1234        (네 번째 키에서 바로)
12        →  12          (멈추면 잠시 뒤)

정한 자리수보다 적게 누르고 멈추는 것은 문제가 없습니다. 그래서 "1번 요금 안내, 2번 예약" 같은 한 자리 메뉴 선택과 같이 써도 됩니다.

설정을 켜지 않을 때

입력이 잠시 끊길 때까지 기다렸다가 전달합니다. 발신자가 천천히 누르면 나누어 도착할 수 있으므로, 프롬프트에 모아서 확인하라고 지시해 두십시오.

키패드 입력이 들어오면 숫자를 모아 두었다가, 11자리가 모이면
"눌러 주신 번호는 010-1234-5678 맞으실까요?" 처럼 전체 번호를 복창하십시오.
11자리가 안 모였으면 아무 말도 하지 말고 기다리십시오.

발신자가 말이 없을 때

전화를 받고도 아무 말이 없는 경우를 위해 무응답 처리 를 켤 수 있습니다. 에이전트 상세 → 대화 탭 → 「통화 흐름」 카드입니다.

설정한 시간만큼 양쪽 다 말이 없으면 에이전트가 대화 상태를 보고 판단합니다. 접수가 남아 있으면 다시 여쭙고, 이미 마무리된 대화라면 통화를 종료합니다.

통화 시간 제한

통화가 너무 길어지지 않게 최대 통화 시간 을 정할 수 있습니다. 에이전트 상세 → 대화 탭 → 「통화 흐름」 카드에서 「최대 통화 시간 제한」을 켜거나, API 의 maxDurationSeconds 로 설정합니다.

시간이 되면 대화 중이어도 통화를 끊습니다. 끊기 전에 안내 멘트는 나가지 않으므로, 마무리 안내가 필요하면 프롬프트에 통화를 N초 안에 마치라는 지시를 함께 적어 두십시오.

이 제한은 에이전트와 나누는 대화에만 걸립니다. 담당자에게 전환된 뒤의 통화에는 적용되지 않습니다.

끼어들기와 발화 감지

에이전트가 말하는 도중 발신자가 말하면 안내를 멈추고 듣습니다(끼어들기). 누가 「발신자가 말했다」를 판단하느냐가 모드에 따라 다릅니다.

GPT-Live 는 듣는 동시에 말하는 전이중(full duplex) 모델이라, 발신자가 말을 얹어도 곧바로 멈추지 않고 모델이 스스로 멈출지 이어 갈지 판단합니다. 짧은 맞장구("네", "음")처럼 끼어들 뜻이 아닌 말에는 말을 이어 갈 수 있습니다. 아래 「ClawOps 에서 발화 감지」는 GPT-Live 에서는 쓰지 않습니다.

실시간 모델의 서버 측 감지는 지연이 가장 짧지만 민감도를 조절할 수 없고, 전화 회선의 작은 잡음에도 안내가 끊겼다가 처음부터 다시 시작될 수 있습니다. 이 증상이 있으면 에이전트 상세 → 모델 · 음성 탭 → 「대화 흐름」 카드에서 「ClawOps 에서 발화 감지」 를 켜십시오. 켜면 실시간 모델에서도 ClawOps 가 음성 감지로 발화와 끼어들기를 판단하고, 아래 항목을 조절할 수 있습니다.

통화 전환

담당자에게 연결하려면 도구 탭 → 통화 전환에서 대상을 등록합니다. 에이전트에게는 등록한 이름만 보이고 번호는 노출되지 않습니다.

전환 안내(웜 트랜스퍼)를 켜면 담당자가 전화를 받은 직후, 발신자에게는 들리지 않는 한 문장을 먼저 들려줍니다. 문구에는 두 가지 변수를 쓸 수 있습니다.

예: {발신번호} 고객님, {사유} 문의입니다

대기 시간과 대기 중 소리

연결되는 동안 발신자에게 들리는 소리와, 담당자를 기다리는 시간을 같은 화면에서 정합니다.

정한 시간 안에 담당자가 받지 않으면 전환이 실패하고 발신자의 통화도 종료됩니다. 에이전트가 다시 이어받지는 않습니다. 담당자가 통화 중이거나 전화를 거절하면 대기 시간을 채우지 않고 그 시점에 바로 종료됩니다.

API·MCP 로 관리하기

에이전트 목록·조회·수정은 REST API 와 MCP 도구로도 할 수 있습니다. 여기서 얻은 에이전트 ID 를 발신 요청의 AgentId 에 넣으면 그 에이전트로 전화를 겁니다.

list_agents 는 목록 요약만 돌려줍니다(프롬프트는 앞부분만). 프롬프트 전문과 실행 설정은 get_agent 로 조회하십시오.

update_agent 로 바꿀 수 있는 항목은 이름·프롬프트(instructions)·먼저 인사하기(greeting)· 최대 통화 시간(maxDurationSeconds, null 이면 제한 없음)·모델·음성입니다. 지정한 항목만 바뀌고, 바뀐 설정은 다음 통화부터 반영됩니다. 그 밖의 실행 설정은 대시보드나 REST 의 configuration 으로 바꾸십시오.