에이전트 수정

PATCH

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

PATCH

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

$ curl -X PATCH https://api.claw-ops.com/v1/accounts/accountId/agents/agentId \
>      -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 }

에이전트 이름과 주요 실시간 음성 설정을 수정합니다. model은 OpenAI Realtime 에이전트, voice는 Cartesia 외부 TTS 에이전트에서 변경할 수 있습니다. 그 외 구성은 대시보드에서 변경합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

agentIdstringRequired

에이전트 ID

Request

This endpoint expects an object.

namestringOptional1-80 characters

instructionsstringOptional<=16000 characters

greetingbooleanOptional

modelenumOptional

Allowed values:

voicestringOptionalformat: "uuid"

Cartesia voice ID

configurationobjectOptional

에이전트 실행 설정 전체를 교체합니다. 지정하면 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

404

Not Found Error

409

Conflict Error