MINARA

실행 중인 턴에 지시 추가

POST /v1/chat/interject: 세션에서 진행 중인 턴에 대한 조정 메시지를 큐에 넣습니다. 게이트웨이는 다음 단계 경계에서 현재 턴에 이를 주입합니다.

POST /v1/chat/interject

세션에서 진행 중인 턴에 대한 조정 메시지를 큐에 넣습니다. 게이트웨이는 다음 단계 경계에서 실행 중인 턴에 이를 주입하고, 모델은 새 턴을 시작하지 않고 현재 작업에 반영합니다. 라이브 /v1/chat/stream 연결은 주입을 user_interjection 이벤트({ message, ts_ms })로 에코합니다.

메서드POST
경로/v1/chat/interject
인증GATEWAY_AUTH_TOKEN 설정 시 Authorization: Bearer <token> 필요
카테고리chat

요청 본문

{ "session_id": "sess_abc", "message": "skip the 1h chart, focus on funding rates" }

응답 본문

{ "status": "injected" }

참고

긴 턴이 아직 스트리밍 중일 때 사용자가 후속 메시지를 입력하고, 해당 메시지가 중단 대신 진행 중인 작업을 조정해야 하는 경우(범위 축소, 제약 추가, 잘못된 가정 수정)에 사용합니다.

응답: 실행 중인 턴에 메시지가 큐잉되면 200{ "status": "injected" }를 반환합니다. 세션에 실행 중인 턴이 없으면 409{ "status": "no_active_turn" }를 반환하며, 이 경우 클라이언트는 일반 POST /v1/chat/stream 요청으로 메시지를 보냅니다. session_id 또는 message가 누락되었거나 비어 있으면 400을 반환합니다.

큐에 들어갔지만 주입하기에 너무 늦게 도착한 메시지는 스트림 최종 done 이벤트의 pending_interjections에 담겨 반환됩니다. 클라이언트는 이를 일반 메시지로 다시 보냅니다.

목차