Skip to main content
POST
진행 중 통화에 맥락 주입

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Headers

Idempotency-Key
string
required

상태를 변경하는 POST 요청에 필요한 멱등성 키입니다. 24시간 동안 안전하게 재시도할 때 사용합니다. 값은 비어 있으면 안 됩니다. 최대 255자까지 허용합니다.

Required string length: 1 - 255

Path Parameters

call_id
string<uuid>
required

통화 ID입니다.

Body

application/json

진행 중인 통화에 넣을 맥락의 요청 본문입니다. response가 none이거나 생략된 경우 expires_in_seconds를 보내면 400 INVALID_CONTEXT_REQUEST로 거부됩니다. 자동 생성 예시에 두 필드가 함께 있으면 expires_in_seconds를 제거하거나 response를 when_idle 또는 interrupt_agent로 바꿉니다.

유효한 요청 예시입니다.

맥락만 넣는 요청 예시입니다.

진행 중인 통화에 텍스트 맥락을 넣는 요청입니다. 빈 text와 범위를 벗어난 expires_in_seconds는 스키마가 아니라 서비스가 400 INVALID_CONTEXT_REQUEST로 거부합니다.

text
string
required

통화에 넣을 맥락 텍스트입니다. 공백만 있는 값은 거부하며, 직렬화한 control envelope이 16 KiB(UTF-8 bytes)를 넘으면 거부합니다. 이후 모든 추론에 사업장 시스템이 보낸 외부 데이터로 들어가며 사용자 발화나 지시로 취급되지 않습니다.

response
enum<string>
default:none

none은 맥락을 기억만 하고 먼저 말하지 않습니다(다음 사용자 턴의 응답부터 참고). when_idle은 통화가 조용해지는 순간 에이전트가 한 번 먼저 말하도록 예약합니다. interrupt_agent는 에이전트가 말하는 중이면 그 발화를 끊고 바로 이 맥락으로 응답하게 합니다(사용자가 말하는 중이면 그 턴이 끝난 뒤 응답에 합칩니다).

Available options:
none,
when_idle,
interrupt_agent
expires_in_seconds
integer

when_idle·interrupt_agent에서만 지정할 수 있는 응답 시작까지의 대기 기한(초). 1~180 범위이며 생략하면 90초입니다. response=none에서 지정하거나 범위를 벗어나면 INVALID_CONTEXT_REQUEST로 거부합니다.

Required range: 1 <= x <= 180

Response

성공 응답

맥락 제어 패킷 전달을 수락했을 때의 202 응답입니다.

call_id
string<uuid>
required

맥락을 넣은 통화 UUID입니다.

control_id
string
required

이 요청의 안정적인 control ID입니다. call_context webhook의 control_id와 짝을 맞추는 데 사용합니다.

status
string
required

LiveKit Room으로 control packet 전달을 수락한 상태입니다. 맥락 반영이나 에이전트 발화 결과는 call_context webhook으로 따로 알립니다.

Allowed value: "accepted"