(작성중) [i-AUD][i-AUD Copilot] 보고서 데이터를 이용하여 자연어로 데이터를 질의·분석하고 화면을 제어하는 AI Chat 컴포넌트

page no.  157581320

1. 기능 설명

   1. 사용자가 자연어로 질문하면 AI 분석 서버가 등록된 데이터를 기반으로 분석 결과를 생성하여 스트리밍으로 제공하고 컴포넌트입니다.

   2. 옵션을 통해 그리드 자체를 조작(필터·정렬·계산필드·피벗 등)할 수 있습니다.

   3. 수행 필요 작업

      1. 분석 대상 등록
         

         1. OlapGrid, DataGrid, Chart 등의 컨트롤을 등록해야합니다.

      2. 동작 모드 및 LLM 프로필 설정
         

         1. 어떤 서버 핸들러(모드)를 선택할지

         2. 어떤 LLM 프로필로 동작할지

   4. 동작 방식

      

      동작 단계

      단계 1. 컴포넌트 초기화

      보고서가 열리고 컴포넌트 초기화가 완료되면 OnComponentReady 이벤트가 발생합니다.

      개발자는 이 시점에 getModel()을 통해 모델 객체를 얻은 후 다음 작업을 수행합니다.

      • 분석 대상 등록 (setGrid, addGrid, setChart)
      • 서버 핸들러 설정 (setServerHandler)
      • LLM 프로필 설정 (setLLMName)
      • 기타 옵션 설정

      이 단계에서 등록한 정보가 이후 모든 분석 기능의 기준이 됩니다.

      
      

      단계 2. 데이터 준비

      등록된 그리드의 데이터가 변경되면 컴포넌트는 분석에 필요한 정보를 준비합니다.

      addGrid()를 사용하는 경우 다음 작업이 자동으로 수행됩니다.

      • 기존 분석 캐시 초기화
      • 입력창 Placeholder 갱신
      • 추천 질문 생성
      • 메타 필드 정보 준비

      setGrid()만 사용하는 경우에는 이러한 작업이 자동 수행되지 않으므로 데이터 변경 시 refreshDataContext()를 직접 호출해야 합니다.

      단계 3. 질문 전송

      사용자가 질문을 입력하거나 sendMessage()를 호출하면 컴포넌트가 분석 요청을 준비합니다.

      동작 방식은 다음 조건에 따라 결정됩니다.

      1. setOnSend()가 설정된 경우
         • 내장 통신 기능을 사용하지 않고 사용자 정의 콜백을 호출합니다.
      2. 분석 대상이 등록된 경우
         • 현재 데이터를 수집한 후 서버에 분석 요청을 전송합니다.
      3. 분석 대상이 등록되지 않은 경우
         • 텍스트 기반 대화 모드로 동작합니다.

      서버에는 최근 대화 이력만 전달되며, 오래된 대화는 자동으로 제외됩니다.

      단계 4. 응답 수신 및 표시

      서버는 분석 결과를 스트리밍 방식으로 반환합니다.

      컴포넌트는 응답을 실시간으로 수신하여 화면에 표시하며, Markdown 형식의 응답을 자동으로 렌더링합니다.

      오류가 발생한 경우에는 오류 메시지를 사용자에게 표시합니다.

      단계 5. 액션 실행

      응답에 실행 가능한 작업 정보가 포함된 경우 컴포넌트는 실행 버튼을 생성합니다.

      사용자가 버튼을 클릭하면 현재 활성화된 그리드를 대상으로 다음과 같은 작업을 수행할 수 있습니다.

      • 필터 적용
      • 정렬 적용
      • 계산 필드 생성
      • 피벗 구성 변경
      • 기타 UI 제어 작업

      이 기능은 Full 모드에서 사용할 수 있습니다.

2. 사용 방법
   5. 설정 옵션

      컴포넌트 선택창의 속성 선택 영역에서 설정할 수 있습니다.

      

      옵션명	설명	기본값
      LLMName	사용할 LLM 프로필명. 서버 config 파일의 `NAME` 과 매칭됩니다. 빈 값이면 config 의 **첫 번째 프로필**이 사용됩니다.	"" (빈 문자열)
      ServerHandler	코파일럿 모드(서버 핸들러)를 결정합니다. LLMToolChatStream: Full(분석+UI제어) LLMLiteChatStream: Lite(SQL 조회 전용)	LLMToolChatStream
      LLMConfigFile	핸들러 기본 config 대신 사용할 커스텀 config 파일명. 비우면 핸들러 기본값을 사용합니다.	""
      DisplayMode	대화 창 표시 방식. popup: 입력바 + 토글 팝업(드래그·리사이즈 가능) inline: 컨테이너 내부 고정 3단 레이아웃.	popup
      Theme	채팅 UI 테마	light
      Placeholder	입력창 안내 문구	"데이터에 대해 질문하세요..."
      MaxHistory	컴포넌트가 보관하는 최대 메시지 수. 주의사항 보관 한도이며, **LLM 에 전송되는 대화 맥락은 별도로 최근 8턴(system 메시지 제외)으로 제한**됩니다. 값을 키워도 서버 전송 맥락 길이는 늘지 않습니다.	20
      FontSize	채팅 UI 기본 글꼴 크기(px)	14
      EnableSuggestions	추천 질문 기능 사용 여부. true: 그리드 첫 셋팅 시 1회 생성 false: 비활성.	true