에이전트 생성

POST

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

POST

/v1/accounts/:accountId/agents

$ curl -X POST https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/agents \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "고객 지원 에이전트"
> }'

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 }

name만으로 바로 통화 가능한 한국어 실시간 음성 에이전트를 생성합니다. instructions, greeting, model, voice를 생략하면 ClawOps 기본값이 적용됩니다. API 기본 출력은 GPT Realtime 2.1 mini + Cartesia sonic-3.5 + Minji 음성입니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.

namestringRequired1-80 characters

instructionsstringOptional<=16000 characters

생략하면 ClawOps의 범용 한국어 음성 에이전트 프롬프트가 적용됩니다.

greetingbooleanOptionalDefaults to true

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

modelenumOptional

생략하면 gpt-realtime-2.1-mini가 적용됩니다.

Allowed values:

voicestringOptionalformat: "uuid"

Cartesia voice ID. 생략하면 Minji - Modern Communicator (7706804e-ea85-443a-968a-b9bf363bdde8)가 적용됩니다.

configurationobjectOptional

모델 내장 음성, Realtime + 외부 TTS 또는 STT·LLM·TTS 파이프라인의 전체 실행 설정입니다. 지정하면 model과 voice 단축 필드는 함께 사용할 수 없습니다.

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

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error