대화 컨텍스트 요약

POST /v1/sessions/:id/compact

완료된 대화 기록 전체를 즉시 요약합니다. 한 번의 대화만 있어도 사용할 수 있으며 대화 횟수의 최소 기준은 없습니다. 기존 요약과 새 기록을 합치고, 컨텍스트 예산 내에서 사용자 메시지의 원문을 보존합니다. 원본 대화 기록은 바뀌지 않습니다. 자동 요약의 실행 조건과 최근 기록 보존 정책은 그대로 유지합니다.

응답 본문

{ "messagesSummarized": 12, "toolCallsSummarized": 2 }

참고

개수가 0이면 skipped: "empty"는 빈 대화, skipped: "unchanged"는 마지막 요약 이후 새 메시지가 없음을 뜻합니다. 대화가 없으면 404, 보조 작업이면 400, 처리 중인 대화이면 409를 반환합니다. 요약 생성이나 저장에 실패하면 500을 반환하고 이전 요약을 유지합니다. 새 대화 턴은 요약이 끝날 때까지 기다립니다.

대체 가능한 내용이 512 tokens 미만이면 모델을 호출하지 않고 skipped: too_small을 반환합니다. 보존하는 사용자 메시지와 요약 마커를 포함한 절감량이 128 tokens 미만이면 skipped: no_savings를 반환하고 원래 컨텍스트를 유지합니다. 수동 요약과 자동 요약은 같은 검사를 사용합니다.