에이전트 조회
Authentication
AuthorizationBearer
API Key를 Bearer 토큰으로 전달
Path parameters
accountId
계정 ID
agentId
에이전트 ID
Response
조회 성공
agentId
에이전트 ID
name
instructions
에이전트 시스템 프롬프트
greeting
통화 연결 직후 에이전트가 먼저 인사할지 여부
language
에이전트 기본 언어
maxDurationSeconds
통화가 연결된 뒤 이 시간(초)이 지나면 통화를 끊습니다. 수신은 받은 순간, 발신은 상대가 받은 순간부터 잽니다. null 이면 제한 없음입니다. 시간이 되면 대화 중이어도 끊으며, 끊기 전 안내 멘트는 나가지 않습니다.
beginMessageDelayMs
발신 통화에서 상대가 받은 뒤 첫 인사를 시작하기 전에 기다리는 시간(밀리초)입니다. 0 이면 바로 인사합니다. greeting 이 true 일 때만 적용되며, 수신 통화에는 적용되지 않습니다.
liveEvents
통화 중 이벤트(실시간 전사·키패드) 설정. 받을 이벤트를 events 에 고르면 이 에이전트의 통화 이벤트를
GET /v1/accounts/{accountId}/calls/{callId}/live-events(·/stream) 로 받습니다. 추가 요금은 없습니다.
idle
무응답 처리 설정. 양쪽 다 말이 없는 시간이 timeout 초 이어지면 에이전트가 대화 상태를 보고 다시 묻거나 통화를 끊습니다.
설정한 적 없는 에이전트는 기본값(enabled: false)으로 나옵니다.
model
현재 에이전트가 사용하는 LLM 모델
voice
현재 음성 ID
voiceProvider
음성 출력 제공자
voiceModel
외부 TTS 모델. 모델 내장 음성에서는 null입니다.
configuration
phoneNumbers
이 에이전트에 착신 연결된 전화번호
dateCreated
dateUpdated
Errors
401
Unauthorized Error
404
Not Found Error