# AI 도우미 채팅 명령

## Content

### 기능 개요

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

* 페이지 측과 서버 측 호출 모두 지원
* 업무 로직의 어느 단계에든 삽입 가능
* 프롬프트 템플릿에서 수식, 변수, 키워드 지원
* JSON 구조화 데이터 추출 지원

![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260623.3833f2.png?width=800)

***

### 명령 설정

#### 기본 설정

| 설정 항목 | 설명 | 예시 값 |
| ----- | --- | ---- |
| AI 모델 선택 | 설정된 LLM 서비스 중 선택 | gpt-4o |
| 시스템 프롬프트 편집 | AI에 미리 지시할 내용 정의 | "당신은 전문 번역가입니다" |
| 사용자 프롬프트 | 사용자 입력 템플릿 | "영어로 번역해줘: [%AiUserInput%]" |
| 함수 정의 목록 | Function Calling 기능 | 데이터 테이블 조작 명령 설정 |
| 반환 결과 유형 | 텍스트/JSON 추출 | JSON 문자열 추출 시도 |

#### 입출력 설정

**1\. 사용자 입력:**

* 텍스트를 직접 입력
* 셀 값 참조(예: `=A1`)
* 수식 계산 결과(예: `=Text(Today(),"yyyy-MM-dd")`)
* 이 입력값은 사용자 프롬프트에서 키워드 `[%AiUserInput%]` 로 참조합니다.

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

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

#### 고급 설정

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

***

### 사용 시나리오

#### 기본 활용

**시나리오 1: 지능형 번역**

* 사용자 프롬프트: "다음 내용을 영어로 번역해줘: [%AiUserInput%]"
* 입력 소스: A1 셀("안녕하세요")
* 출력: result 변수("Hello")

![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260623.afe687.png?width=600)
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260623.f2c432.png)
**시나리오 2: 데이터 정제**

* 시스템 프롬프트: "당신은 데이터 전문가입니다. 다음 주소 형식을 표준화해 주세요. 출력 형식: { "시/도":"","시/군/구":"","상세주소":""}"
* 사용자 프롬프트: "원본 주소: [=원본주소]"
* 반환 결과 유형: JSON 문자열 추출 시도

![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260623.6d1120.png?width=800)
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260623.33f0b0.png?width=400)

#### 업무 통합

**시나리오 3: 지능형 승인**

* 신청 제출 시 AI 명령 트리거
* 프롬프트: "구매 신청의 합리성을 평가해 주세요. 파라미터:
    * 금액: [=구매신청기록.Amount]
    * 공급업체: [=구매신청기록.공급업체]
    * 히스토리: [%AiDataSource=(구매히스토리테이블)%]"
* 반환된 의견을 승인 의견 필드에 저장

**시나리오 4: 동적 보고서**
사용자가 자연어로 보고서 요구사항을 설명합니다(예: 분석 기준 선택 — 기간/제품군).
AI 함수 정의에 여러 사전 설정 함수를 구성하여, 명령에서 서로 다른 설정의 보고서를 내보냅니다.

***

### 모범 사례

**1\. 프롬프트 최적화:**

* 명확한 지시 형식을 사용합니다("다음 형식으로 반환해 주세요:")
* 예시 샘플을 제공합니다(Few-shot learning)

**2\. 보안 권장사항:**

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

***

### 디버그 팁

**1\. 로그 확인:**

* 서버 측 테스트 또는 브라우저 콘솔을 통해 명령 호출 로그를 확인할 수 있습니다.
* 로그에는 프롬프트 템플릿의 최종 텍스트 결과와 함수 호출 과정이 상세히 기록됩니다.

**2\. 테스트 모드:**

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

**3\. 오류 진단:**

| 코드 | 의미 |
| --- | --- |
| 403 | API 키 무효 |
| 504 | 모델 응답 타임아웃 |
| 422 | 설정 오류 |

> **설명:**
> AI 어시스턴트 명령은 AI 대화 셀과 결합하여 사용할 수 있어, 복잡하고 강력한 지능형 애플리케이션을 구현할 수 있습니다.