에이전트 목록 조회

GET

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

GET

/v1/accounts/:accountId/agents

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

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

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Response

조회 성공

datalist of objects

Errors

401

Unauthorized Error