AI 도우미 채팅 명령

기능 개요

AI 어시스턴트 명령은 Forguncy에서 제공하는 자동화된 AI 인터랙션 기능으로, 개발자가 설정 화면을 통해 애플리케이션 실행 중 LLM 서비스를 호출할 수 있도록 합니다. 주요 특징은 다음과 같습니다.

• 페이지 측과 서버 측 호출 모두 지원

• 업무 로직의 어느 단계에든 삽입 가능

• 프롬프트 템플릿에서 수식, 변수, 키워드 지원

• JSON 구조화 데이터 추출 지원

명령 설정

기본 설정

입출력 설정

1. 사용자 입력:

• 텍스트를 직접 입력

• 셀 값 참조(예: =A1)

• 수식 계산 결과(예: =Text(Today(),"yyyy-MM-dd"))

• 이 입력값은 사용자 프롬프트에서 키워드 [%AiUserInput%] 로 참조합니다.

2. 결과 저장 위치: 결과를 저장할 변수를 지정합니다.

• 저장 위치: result (텍스트 결과)

고급 설정

오류 처리: 타임아웃 시간을 설정합니다(기본값 100초).

사용 시나리오

기본 활용

시나리오 1: 지능형 번역

• 사용자 프롬프트: "다음 내용을 영어로 번역해줘: [%AiUserInput%]"

• 입력 소스: A1 셀("안녕하세요")

• 출력: result 변수("Hello")

시나리오 2: 데이터 정제

• 시스템 프롬프트: "당신은 데이터 전문가입니다. 다음 주소 형식을 표준화해 주세요. 출력 형식: { "시/도":"","시/군/구":"","상세주소":""}"

• 사용자 프롬프트: "원본 주소: [=원본주소]"

• 반환 결과 유형: JSON 문자열 추출 시도

업무 통합

시나리오 3: 지능형 승인

• 신청 제출 시 AI 명령 트리거

• 프롬프트: "구매 신청의 합리성을 평가해 주세요. 파라미터:

  • 금액: [=구매신청기록.Amount]

  • 공급업체: [=구매신청기록.공급업체]

  • 히스토리: [%AiDataSource=(구매히스토리테이블)%]"

• 반환된 의견을 승인 의견 필드에 저장

시나리오 4: 동적 보고서

사용자가 자연어로 보고서 요구사항을 설명합니다(예: 분석 기준 선택 — 기간/제품군).

AI 함수 정의에 여러 사전 설정 함수를 구성하여, 명령에서 서로 다른 설정의 보고서를 내보냅니다.

모범 사례

1. 프롬프트 최적화:

• 명확한 지시 형식을 사용합니다("다음 형식으로 반환해 주세요:")

• 예시 샘플을 제공합니다(Few-shot learning)

2. 보안 권장사항:

• 민감 필드는 마스킹 처리합니다.

디버그 팁

1. 로그 확인:

• 서버 측 테스트 또는 브라우저 콘솔을 통해 명령 호출 로그를 확인할 수 있습니다.

• 로그에는 프롬프트 템플릿의 최종 텍스트 결과와 함수 호출 과정이 상세히 기록됩니다.

2. 테스트 모드:

• AI 어시스턴트 명령을 단독으로 직접 테스트할 수 있습니다.

3. 오류 진단: