AI 대화 셀

AI 대화 셀

기능 개요

AI 대화 셀은 Forguncy에서 제공하는 지능형 인터랙션 컴포넌트로, 최종 사용자가 자연어로 애플리케이션과 다중 턴 대화를 나눌 수 있도록 합니다. 이 컴포넌트는 다음을 지원합니다.

• 컨텍스트를 인식하는 연속 대화

• 동적 데이터 바인딩 및 표시

• 커스텀 함수 호출

• 유연한 화면 스타일 설정

쉽게 말해, 애플리케이션 안에 챗봇 창을 넣을 수 있는 기능입니다. 사용자가 채팅으로 질문하면 AI가 답해주고, 필요하면 데이터까지 보여줄 수 있어요.

예를 들면:

• "내 최근 주문 어떻게 됐어?"라고 물으면 AI가 실제 주문 데이터를 찾아서 답해줍니다.

• "이번 달 매출 1위 상품 뭐야?"라고 물으면 AI가 표를 찾아서 보여줍니다.

  
  

기본 세팅 — 3단계만 기억하세요

1단계. AI 모델 연결하기

• 메뉴에서 미리 AI 모델(예: ChatGPT 등)을 등록해 둡니다.

  
  

  파일>옵션>응용 프로그램 설정에서 런타임 AI 모델을 추가합니다.

  "연결 테스트" 버튼으로 잘 붙었는지 확인할 수 있습니다.

• 페이지에서 채팅 셀을 만들고, 등록해둔 모델 중 하나를 골라 연결합니다.

  
  

2단계. 어떤 데이터를 보여줄지 연결하기

• 채팅 셀에 데이터 테이블(예: 주문 목록)을 연결할 수 있습니다.

• 연결하면 AI에게 "이 데이터 보고 답해줘"라고 지시할 수 있게 됩니다.

  
  

3단계. AI에게 역할 알려주기 (프롬프트)

• 시스템 프롬프트 = AI에게 "너는 이런 역할이야" 알려주는 것 (예: "너는 고객 상담원이야")

• 사용자 프롬프트 = 사용자가 입력한 질문이 들어가는 자리

수식 삽입:

• Excel 수식을 직접 작성할 수 있습니다.

• 예시: [=Text(Today(),"yyyy-MM-dd")]

키워드 삽입:

• 우측 트리 메뉴를 클릭하여 빠르게 삽입할 수 있습니다.

• 날짜, 사용자, 데이터 소스 등을 지원합니다.

함수란? — AI가 "직접 행동"하게 만들기

기본적으로 AI는 말만 할 수 있습니다. 그런데 함수를 만들어주면 AI가 실제로 데이터를 조회하거나 작업을 실행할 수 있게 됩니다.

1. 함수 생성:

• 함수 이름은 영어로 짓습니다 (예: getOrderDetail = 주문 상세 가져오기)

• 파라미터와 반환값을 명확히 정의합니다.

2. 실행 제어:

• 함수 활성화/비활성화: 주로 개발 단계에서 디버그할 때 사용하며, 예를 들어 특정 함수를 임시로 비활성화할 수 있습니다.

• 실행 전 확인 설정: 민감하거나 위험한 작업의 경우 이 옵션을 체크하여 사용자가 작업을 재확인하도록 해야 합니다.

이벤트

새 대화 생성 시 명령

사용자가 새로운 AI 대화를 시작할 때(예: "새 대화 만들기" 버튼 클릭 또는 채팅창 초기화) 실행됩니다.

대표적인 활용 예시:

• 페이지의 일부 컨텍스트를 설정하거나 초기화

• 사용 가능한 작업 "컴포넌트 메시지 추가"를 통해 AI 대화 셀에 카드 메시지를 추가하여 "오프닝 멘트"로 활용

메시지 추가 시 명령

사용자나 AI가 메시지를 전송하여 채팅 기록에 성공적으로 추가될 때마다(사용자 입력과 AI 응답 모두 포함) 트리거됩니다.

대표적인 활용 예시:

• 채팅 기록을 데이터베이스에 저장(사용 가능한 작업 "히스토리 메시지 가져오기"와 함께 활용 가능)

• AI 어시스턴트 명령을 호출하거나 일반 업무 로직을 트리거

사용량 기록 명령

AI 사용 현황을 기록합니다. AI 요청이 끝날 때마다 이 명령 목록이 호출됩니다.

MCP 실행 전 명령

MCP 실행 전에 실행할 명령을 설정합니다.

MCP 실행 후 명령

MCP 실행 후에 실행할 명령을 설정합니다.

링크 클릭 명령

링크 클릭 명령을 추가하면, AI가 생성한 링크를 클릭할 때 해당 명령이 실행됩니다.

• 링크 클릭 명령이 설정되지 않은 경우, AI가 위험한 링크를 생성하면 AI 대화 셀이 링크 이동을 차단하고 사용자에게 경고합니다. 링크를 클릭하면 경고 대화상자가 팝업됩니다.

• 링크 클릭 명령이 설정된 경우, 위험한 링크는 차단되지 않습니다.

화면 커스터마이징

제목 설정

• 제목바 표시

• 새 대화 버튼 표시

• 커스텀 제목 아이콘

• 커스텀 제목 텍스트

채팅 영역 설정

• 채팅 시간 표시

• 복사 버튼 표시

• 재생성 버튼 표시

• 사용자 질문 제안 표시

• 도구 호출 표시 모드: 기본값은 전체 표시이며, 숨김 또는 단순 표시로 설정 가능

• 커스텀 AI 대화 아이콘

하단 바 설정

• 하단 바 표시

• 커스텀 텍스트 입력란 워터마크

• 커스텀 입력 질문 최대 길이

오프닝 멘트 설정

• 커스텀 오프닝 문구

• 커스텀 오프닝 질문 목록

사용 가능한 작업

• 새 대화 생성

• 메시지 추가

• 컴포넌트 메시지 추가

• 도구 호출 정보 추가

• 히스토리 메시지 가져오기

• 히스토리 메시지 설정

• 로딩 상태 설정

대표적인 시나리오

고객 서비스 시나리오

1. 고객 히스토리 주문 테이블을 바인딩하고, 필요에 따라 조회 조건과 가져올 행 수 등을 설정합니다.

2. 시스템 프롬프트를 설정합니다:

당신은 전문 고객 상담 담당자입니다. 고객의 히스토리 주문 정보를 기반으로 질문에 답변해 주세요.
사용 가능한 데이터: [%AiDataSource=(고객 히스토리 주문 테이블)%]
현재 시간: [%Date.Now%]
현재 사용자명: [%CurrentUser.UserName%]

3. 사용자 질문: "제 최근 주문 상태는 어떤가요?"

데이터 조회 시나리오

1. 조회 함수 "매출 데이터 조회"를 생성하고, 설명을 "지정된 상위 N개 행의 데이터 가져오기"로 작성합니다.

2. 파라미터 "top"을 추가합니다.

3. 반환값 "data"를 추가합니다.

4. 명령을 편집하여 변수 설정 명령을 추가하고, 변수 이름을 "data"로 지정한 뒤 데이터 테이블에서 값을 가져오며, 조회 행 수는 수식 "=top"으로 설정합니다.

5. 애플리케이션을 실행하고 사용자가 질문합니다: "이번 달 매출 상위 10개 제품을 보여줘"

6. 채팅 메시지에 작업 실행 중임이 표시됩니다(작업 실행 결과, 즉 명령의 반환값 data가 다시 AI에 전송됩니다).

7. 채팅창에 AI의 답변이 표시됩니다.

주의사항

1. 성능 최적화:

• 복잡한 함수의 호출 명령에는 로딩 상태 표시를 추가하는 것을 권장합니다.

• 대량의 데이터 조회는 페이지네이션 처리를 권장합니다.

2. 보안 권장사항:

• 사용자 입력에 대해 민감 단어 필터링을 적용합니다.

• 핵심 작업에는 반드시 실행 확인을 설정해야 합니다.

3. 경험 개선:

• 자주 사용하는 작업에는 빠른 명령을 추가합니다("사용 가능한 작업 → 텍스트 메시지 추가"를 통해 구현).

• 오프닝 멘트나 대화 예시를 제공하여 사용자를 안내합니다.

문제 해결

팁: 테스트 환경에서 프롬프트와 대화 로직을 충분히 검증한 후 운영 환경에 배포하는 것을 권장합니다.