page no. 

Start Release No : 7.0.500.20260611-21, 7.0.610.20260611-11 / Update Release No : 품질에서 작성

작성자 :  황송희, 이영균  / 검수자 :  검수자가 작성


  1. 기능 설명

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

    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. 사용 방법
    1. i-AUD Designer > UI Bot 상단메뉴 > Container → "ExternalComponent" 메뉴를 선택합니다.
    2. ExternalComponent 우클릭 > "컴포넌트 선택" 메뉴를 선택합니다.
    3. 컴포넌트 목록에서 "AI Chat" 항목을 선택합니다.

    4. 설정 옵션

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

      옵션명설명기본값

      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



  • 분석 데이터는 질문 시점에 추출됩니다.
    • 분석 요청 시 등록된 그리드에서 데이터를 Export하여 사용합니다. 캐싱된 데이터는 변경되기 전까지 재사용됩니다.
  • 대화 맥락은 대화 이력 저장 개수(MaxHistory)와 관계없이 최근 8턴까지만 전달됩니다.
  • 응답 생성 중 재질문이 가능합니다.
    • 응답이 스트리밍되는 동안 새로운 질문을 전송하면 기존 요청은 자동 취소되고 새로운 요청이 시작됩니다.


  • DisplayMode가 inline 인 경우 open(), close(), toggle()이 동작하지 않습니다.
    • inline 모드는 항상 화면에 표시되는 방식이므로 해당 API를 호출해도 변화가 없습니다.

  • LLMName 설정값을 정확히 입력해야 합니다.

    • 존재하지 않는 프로필명을 지정한 경우 오류는 발생하지 않으며, 설정된 첫 번째 프로필이 자동 사용됩니다.

  • UI 제어 기능은 현재 활성화된 그리드에 적용됩니다.

    • 필터, 정렬, 계산 필드 생성 등의 기능은 현재 활성 상태인 그리드를 기준으로 수행됩니다. 여러 개의 그리드를 사용하는 경우 활성 그리드를 확인한 후 사용하시기 바랍니다.



기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보

  • i-AUD : 7.3.500.0-202606082202

  • maf-extend : 7.0.500.184


  • 샘플 URL : https://rnd.bimatrix.co.kr/aud7/ 또는 https://aud.bimatrix.co.kr 등 외부 접근 위치에 샘플이 있을 경우 보고서 경로를 입력합니다.
  • 샘플 파일




(BCRM#G2820) [AUD Copilot] SQL 검증 기능 숨김 기능 추가 제공

(BCRM#G2821) [AUD Copilot] 관리자 모니터링 화면 혹은 로그 분석 기능 제공