진행 중 통화에 맥락 주입
진행 중인 통화에 텍스트 맥락을 넣습니다. 에이전트는 넣은 맥락을 이후 모든 턴에서 외부 데이터로 참고합니다. response가 when_idle이면 통화가 조용해질 때 에이전트가 한 번 먼저 말하고, interrupt_agent이면 에이전트가 말하는 중인 발화를 끊고 바로 응답합니다. 202 응답은 서버가 보낸 제어 패킷을 LiveKit 룸이 수락했다는 뜻일 뿐입니다. 에이전트가 맥락을 반영했는지, 실제로 말했는지는 이후 call_context 웹훅이 control_id로 짝을 맞춰 알립니다. 웹훅에는 맥락 텍스트가 담기지 않습니다. 요청 한도는 통화당 초당 2회, 분당 10회, 응답 대기 8건, 누적 텍스트 64 KiB이며, 넘으면 429 CONTEXT_LIMIT_EXCEEDED로 응답합니다.
Authorizations
워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Headers
상태를 변경하는 POST 요청에 필요한 멱등성 키입니다. 24시간 동안 안전하게 재시도할 때 사용합니다. 값은 비어 있으면 안 됩니다. 최대 255자까지 허용합니다.
1 - 255Path Parameters
통화 ID입니다.
Body
진행 중인 통화에 넣을 맥락의 요청 본문입니다. 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로 거부합니다.
통화에 넣을 맥락 텍스트입니다. 공백만 있는 값은 거부하며, 직렬화한 control envelope이 16 KiB(UTF-8 bytes)를 넘으면 거부합니다. 이후 모든 추론에 사업장 시스템이 보낸 외부 데이터로 들어가며 사용자 발화나 지시로 취급되지 않습니다.
none은 맥락을 기억만 하고 먼저 말하지 않습니다(다음 사용자 턴의 응답부터 참고). when_idle은 통화가 조용해지는 순간 에이전트가 한 번 먼저 말하도록 예약합니다. interrupt_agent는 에이전트가 말하는 중이면 그 발화를 끊고 바로 이 맥락으로 응답하게 합니다(사용자가 말하는 중이면 그 턴이 끝난 뒤 응답에 합칩니다).
none, when_idle, interrupt_agent when_idle·interrupt_agent에서만 지정할 수 있는 응답 시작까지의 대기 기한(초). 1~180 범위이며 생략하면 90초입니다. response=none에서 지정하거나 범위를 벗어나면 INVALID_CONTEXT_REQUEST로 거부합니다.
1 <= x <= 180Response
성공 응답
맥락 제어 패킷 전달을 수락했을 때의 202 응답입니다.