에이전트 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/agents/:agentId

GET

/v1/accounts/:accountId/agents/:agentId

$ curl https://api.claw-ops.com/v1/accounts/accountId/agents/agentId \
>      -H "Authorization: Bearer <token>"

1 {
2   "agentId": "cmagent123",
3   "name": "고객 지원 에이전트",
4   "instructions": "당신은 친절하고 유능한 한국어 음성 에이전트입니다. 사용자의 요청을 주의 깊게 듣고 정확하고 간결하게 답하세요.",
5   "greeting": true,
6   "language": "ko",
7   "model": "gpt-realtime-2.1-mini",
8   "voice": "7706804e-ea85-443a-968a-b9bf363bdde8",
9   "voiceProvider": "cartesia",
10   "voiceModel": "sonic-3.5",
11   "configuration": {
12     "outputMode": "realtime_voice",
13     "language": "string",
14     "knowledge": {
15       "enabled": true,
16       "topK": 1
17     },
18     "stt": {
19       "provider": "openai",
20       "model": "gpt-4o-transcribe",
21       "language": "ko",
22       "prompt": "string",
23       "temperature": 0.5,
24       "detect_language": true,
25       "noise_reduction_type": "near_field",
26       "use_realtime": true
27     },
28     "llm": {
29       "provider": "string",
30       "model": "string",
31       "voice": "string"
32     },
33     "tts": {
34       "language": "ko",
35       "model": "sonic-3.5",
36       "provider": "cartesia",
37       "speed": 1.1,
38       "voice": "string",
39       "volume": 1.1
40     },
41     "vad": {
42       "provider": "silero",
43       "min_silence_duration": 1.1,
44       "min_speech_duration": 0.5,
45       "prefix_padding_duration": 1.1,
46       "max_buffered_speech": 1.1,
47       "activation_threshold": 0.5,
48       "sample_rate": 16000,
49       "force_cpu": true
50     },
51     "session": {
52       "turn_detection": "vad",
53       "allow_interruptions": true,
54       "min_endpointing_delay": 1.1,
55       "max_endpointing_delay": 1.1,
56       "min_interruption_duration": 1.1
57     }
58   },
59   "phoneNumbers": [
60     "07012340001"
61   ],
62   "dateCreated": "2024-01-15T09:30:00Z",
63   "dateUpdated": "2024-01-15T09:30:00Z"
64 }

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

agentIdstringRequired

에이전트 ID

Response

조회 성공

agentIdstring

에이전트 ID

namestring

instructionsstring

에이전트 시스템 프롬프트

greetingboolean

통화 연결 직후 에이전트가 먼저 인사할지 여부

languagestring

에이전트 기본 언어

modelstring

현재 에이전트가 사용하는 LLM 모델

voicestring or null

현재 음성 ID

voiceProviderstring or null

음성 출력 제공자

voiceModelstring or null

외부 TTS 모델. 모델 내장 음성에서는 null입니다.

configurationobject

phoneNumberslist of strings

이 에이전트에 착신 연결된 전화번호

dateCreateddatetime

dateUpdateddatetime

Errors

401

Unauthorized Error

404

Not Found Error