이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

대화 요약

상태: 현재 범위: AX Code TUI 대화 요약 최종 검토: 2026-09-26 담당: AX Code 런타임 유지관리자

유휴 TUI 세션에서 /recap을 사용하면, 저장된 세션을 다시 연 경우를 포함해 최근 대화를 따라잡을 수 있습니다. AX Code는 최근 사용자 턴을 최대 여덟 개까지 짧은 배너로 요약합니다. 목표, 확인된 진행, 검증, 다음 단계 또는 막힌 지점을 담습니다. 배너는 입력하는 동안 남아 있고, 다른 턴을 시작하거나 세션을 바꾸거나 대화가 바뀌면 사라집니다. /recap은 세션 트리 전체가 끝나기를 기다립니다. goal-mode나 작업 서브에이전트가 아직 실행 중이면, 끝나지 않은 작업을 요약하지 않고 기다리라고 요청합니다.

요약은 모델을 사용하므로 불완전하거나 정확하지 않을 수 있습니다. 대화가 입력 한도를 넘으면 가장 최근 요청과 결과를 우선합니다. 정확한 결과는 대화 기록을 확인합니다. 요약은 대화 기록을 수정하거나, 도구를 실행하거나, 작업 상태를 바꾸지 않습니다.

AX Code는 세션 트리 전체가 안정된 뒤에도 요약을 자동으로 만듭니다. 턴이 끝났고 아직 실행 중인 서브에이전트가 없으며, 프롬프트가 5초 동안 조용할 때입니다. 입력하면 카운트다운이 멈추고, 프롬프트를 비우면 다시 시작됩니다. 지연 표시(pregenerate, 기본값 true)보다 조금 전에 생성이 시작되므로, 모델 지연이 한 번 더 지난 뒤가 아니라 그 표시 시점에 배너가 나타날 수 있습니다. 표시 전에 입력하면 미리 만든 요약은 조용히 버려집니다. 서브에이전트를 사용한 세션은 대화 범위의 요약을 받고, 일반 세션은 가장 최근 턴의 요약을 받습니다. 자동 표시는 tui.json에서 구성합니다.

{
  "idle_recap": {
    "enabled": true,
    "delay_ms": 5000,
    "pregenerate": true
  }
}

enabled를 false로 설정하면 자동 요약을 끕니다. /recap은 계속 사용할 수 있습니다. pregenerate를 false로 설정하면 지연이 모두 지난 뒤에만 생성하므로, 그 구간 안에서 다시 입력할 때 모델 호출을 피합니다. 생성은 사용할 수 있을 때 요약 에이전트에 구성된 모델을 쓰고, 그다음 공급자의 소형 모델, 그다음 세션 모델을 사용합니다. 요약은 별도의 모델 요청을 만들며 공급자 할당량을 쓸 수 있습니다. 실패했거나 끝나지 않은 턴과 관리되는 AX Engine 세션은 요약을 만들지 않습니다. 수동 요청은 사용할 수 있는 요약이 없으면 알림을 보여 줍니다. 자동 실패는 조용히 남고 30초 뒤 한 번 다시 시도하며, 입력하거나 다른 작업으로 넘어가면 즉시 취소됩니다. 명시적으로 다시 시도하려면 /recap을 사용합니다.

각 세션은 마지막 요약을 보관하므로, 세션 선택기는 다시 열기 전에 그 세션이 마지막으로 한 일의 짧은 미리보기를 보여 줍니다. 저장된 미리보기는 표시용 힌트일 뿐입니다. 모델에 보내지지 않고, 대화 기록의 메시지가 되지 않으며, 세션을 되돌리면 지워집니다.

/compact은 모델이 컨텍스트를 비울 수 있도록 더 이전 기록을 요약합니다. /summarize는 그 별칭으로 남아 있습니다. 따라잡기 배너에는 /recap을 쓰고, 컨텍스트 압축이 필요할 때는 /compact를 사용합니다.