챗봇 세션의 대화 내용

Content는 한 세션에서 주고받은 대화 이력입니다. Get Content는 호출자와 Agent 사이의 대화를 조회하며, exchanges에 첫 대화 교환부터 시간순으로 담아 반환합니다.

대화 한 차례의 구성

각 SessionExchange에는 사용자 메시지인 userInput과 최종 결과인 result가 있습니다. 프롬프트에 추가 컨텍스트를 포함했다면 contexts에서 확인할 수 있습니다.

• userInput.text는 사용자가 보낸 메시지입니다.
• result.agentMarkdownResponse는 Markdown 응답입니다. interruptedOutput이 true이면 취소 요청에서 클라이언트가 제공한 응답입니다.
• result.parameterUpdates에는 Agent가 생성한 애플리케이션 변수 변경값이 들어갑니다. READ_WRITE로 설정한 변수에만 변경값을 생성할 수 있습니다. 문자열 변수는 문자열을, 객체 집합 변수는 객체 집합 RID를 반환합니다.
• result.totalTokensUsed는 모델이 사용량 정보를 지원할 때 제공됩니다. 필드가 없다는 이유로 사용량을 0으로 기록하지 않습니다.
• result.sessionTraceId는 응답 추적에 연결하는 식별자입니다.

contexts에는 클라이언트가 직접 제공한 내용과 Agent에 구성한 데이터 소스에서 자동으로 검색한 내용이 포함될 수 있습니다. 객체 컨텍스트는 객체 RID와 속성 유형 RID를 사용합니다. 함수 검색 컨텍스트에는 함수 RID, 함수 버전과 반환 문자열인 retrievedPrompt가 들어갑니다. 함수 버전의 1.2.3 형식은 Agent 버전의 1.0 형식과 구분합니다.

화면과 애플리케이션 상태에 반영

스트리밍으로 받은 텍스트를 화면에 표시한 뒤에는 대화 내용을 조회하여 최종 결과와 변수 변경값을 확인합니다. 변수 변경값은 해당 교환의 결과이므로, 모든 애플리케이션 변수의 현재값을 담은 스냅샷으로 처리하지 않습니다.

세션 목록에 표시할 제목과 메시지 수, 예상 만료 시각은 세션 메타데이터에 있습니다. 대화 내용을 시간순으로 표시할 때 이 목록의 최근 갱신순 정렬을 그대로 적용하지 않습니다.