# AI 채팅 셀
## Content
셀 유형으로 「AI 채팅 셀」을 사용할 수 있게 되었습니다. 이 셀로 자연어를 사용해 애플리케이션과 여러 차례에 걸쳐 대화할 수 있습니다. 주요 기능은 다음과 같습니다.
* 지속적인 대화
* 동적인 데이터 연결 및 표시
* 함수 정의 호출
* 유연한 화면 표시 형식 설정
#### 사용 방법
**1\. 원하는 셀 영역에 AI 채팅 셀을 할당합니다\.**
배치할 영역을 선택한 뒤 셀 유형 목록의 [AI 채팅 셀 형]을 더블클릭합니다. 또는 대상 셀로 드래그 앤 드롭하여 배치합니다.
**2\. AI 채팅 셀의 세부 설정을 합니다\.**
오른쪽 창 하단의 [셀 유형] 탭을 클릭하여 AI 채팅을 설정합니다.
| 속성 이름 | 설명 |
| ----- | --- |
| 자동 AI 응답 비활성화 | 활성화하면 셀이 AI 인터페이스에 자동으로 응답을 요청하지 않습니다. 이 경우 사용자 입력 처리와 AI 응답 내용 반환은 「메시지 추가 시 명령」에서 해야 합니다. |
| AI 모델 선택 | [옵션] - [응용 프로그램 설정] - [런타임 기능을 위한 AI 모델]에서 설정한 AI 모델 중 사용할 모델을 선택합니다.
 |
| 데이터 소스 바인딩 | 데이터 소스를 설정하면 프롬프트에서 테이블 데이터를 참조할 수 있습니다. 그러면 해당 테이블 데이터에 기반한 응답이 가능해집니다. 여러 테이블 데이터를 추가할 수도 있습니다. |
| 시스템 프롬프트 편집 | 자연어, 수식, 키워드를 사용하여 시스템 프롬프트를 설정합니다.
시스템 프롬프트란 AI의 역할, 작업, 행동 패턴을 정의하기 위해 미리 설정하는 지시문입니다. 최종 사용자와의 대화가 시작되기 전에 AI에 전송되며, AI가 맥락과 작업을 이해하도록 돕습니다.
아래는 시스템 프롬프트의 예입니다. 내용을 구체적이고 정확하게 설정할수록 더 정확한 답변을 기대할 수 있습니다.
AI의 역할: 당신은 예실 관리 앱에 내장된 매우 유능한 업무 분석 어시스턴트입니다.
작업: 사용자의 질문 내용을 보고 요구되는 처리 내용(건수 집계/목록 표시/조건 추출 등)을 판단하십시오.
행동 패턴: 먼저 결론(건수나 해당 여부)을 명시하십시오. 목록 표시가 필요하면 표 형식으로 출력하고, 건수를 요청받으면 수치를 명시하십시오.
또한 함수 정의로 만든 함수를 설정하면 해당 함수를 실행할 수 있습니다.
아래는 함수 정의를 호출하는 예입니다.
입력 내용이 「등록·업데이트」에 해당하면 updateRecord를 사용한다.
입력 내용이 「알림·요청」에 해당하면 sendNotification을 사용한다.
어느 쪽에도 해당하지 않으면 함수를 호출하지 않고 이유를 반환한다. |
| 사용자 프롬프트 | 자연어, 수식, 키워드를 사용하여 사용자 프롬프트를 설정합니다.
사용자 프롬프트란 최종 사용자가 그때그때 AI에 입력하는 지시나 질문입니다. 대화나 조작 중에 전송되며, 시스템 프롬프트에서 정의한 전제를 바탕으로 AI에 구체적인 처리 내용을 지시합니다.
아래는 사용자 프롬프트의 예입니다.
사용자가 입력한 내용은 [%AiUserInput%]입니다.
[%AiUserInput%]을 바탕으로 처리해 주십시오. |
| 함수 정의 목록 | AI 모델이 분석하여 실행할 수 있는 함수의 정의 목록입니다.
함수의 처리 내용은 명령으로 정의합니다.
이를 이용해 명령 실행 결과를 답변에 활용하거나, 명령을 실행해 AI 채팅 셀 밖의 요소를 조작할 수 있습니다. 예를 들면 다음과 같습니다.
명령 결과를 반환값으로 AI에 전달하고, AI가 그 반환값으로 답변을 작성한다
테이블에 데이터를 추가, 업데이트, 삭제한다
목록 보기나 셀을 조작한다
**주의:**
함수 정의를 설정하면 출력 방식이 스트리밍에서 전체 답변을 한 번에 출력하는 방식으로 바뀝니다.
함수 정의 이름과 매개변수 이름에는 영어 카멜 케이스(filterFullName 등) 사용을 권장합니다. |
| MCP 도구 | MCP 도구를 설정합니다.
자세한 내용은 「MCP 도구」를 참조하십시오. |
| 새 채팅 생성 시 명령 | 새 AI 채팅을 시작할 때 실행되는 명령입니다. 「새 대화」 버튼을 클릭하거나 채팅 창을 초기화하는 경우가 이에 해당합니다. |
| 메시지 추가 명령 | 사용자나 AI가 보낸 메시지가 채팅 기록에 정상적으로 추가되었을 때 실행되는 명령입니다. 사용자 입력과 AI 답변이 모두 포함됩니다. |
| 사용 기록 명령 | AI 응답이 완료되었을 때 실행되는 명령입니다. 명령 안에서 컨텍스트 변수 「입력 토큰 수」, 「출력 토큰 수」, 「AI 설정 이름」, 「AI 모델 이름」, 「실행 시간」을 참조할 수 있습니다. 이 변수들을 테이블이나 텍스트 파일 등에 기록하면 기능별 AI 사용량을 토큰 수로 측정할 수 있습니다. |
| MCP 실행 전 명령 | MCP 도구를 실행하기 전에 수행할 명령을 설정합니다. |
| MCP 실행 후 명령 | MCP 도구를 실행한 후에 수행할 명령을 설정합니다. |
| 링크 클릭 명령 | 이 명령을 설정하면 AI가 생성한 링크를 클릭했을 때 해당 명령이 실행됩니다. 명령에서 컨텍스트 변수 「링크 주소」, 「링크 텍스트」를 참조할 수 있습니다.
예를 들어 외부 링크로 이동하기 전에 확인 대화 상자를 표시할 수 있습니다. 사내 사용자용 도메인 링크를 외부 사용자용 도메인으로 변환하여 페이지를 이동시키는 처리도 구현할 수 있습니다.
기본적으로 AI가 위험한 링크를 생성하면, 그 링크를 클릭했을 때 AI 채팅 셀이 경고 대화 상자를 표시하고 이동을 막습니다. 링크 클릭 시 명령을 설정하면 이 동작이 비활성화되므로 주의하십시오. |
| 제목 설정 | 제목 표시줄의 UI를 설정합니다. 아래는 설정 예입니다.
 |
| 채팅 영역 설정 | 채팅 영역의 UI를 설정합니다. 아래는 설정 예입니다.
ㅋ
추천 프롬프트: 설정한 프롬프트에 따라 AI가 생성한 추천 항목을 표시합니다. AI가 3개를 넘는 추천을 생성하면 가장 긴 3개만 표시합니다. 추천 기능의 응답 시간은 모델 성능에 따라 달라집니다. 추론 모델을 사용하면 표준 모델보다 크게 지연될 수 있습니다.
도구 호출 표시 모드: 함수나 MCP 도구를 호출했을 때 표시되는 메시지의 양을 조정합니다. 최종 사용자에게 도구 호출 메시지를 보여 주고 싶지 않을 때 등에 사용합니다. |
| 하단 영역 설정 | 입력란의 UI를 설정합니다. 아래는 설정 예입니다.
 |
| 프롤로그 설정 | AI 채팅 셀 첫머리에 표시할 메시지와 추천 항목을 설정합니다. 아래는 설정 예입니다.
 |
**3\. 필요에 따라 데이터를 연결합니다\.**
데이터 연결 방법은 「데이터 연결」을 참조하십시오.
**4\. 실행버튼을 클릭하여 애플리케이션의 동작을 확인합니다\.**
#### 명령에서 사용할 수 있는 작업
특정 조건을 충족하면 오른쪽 창의 「셀 유형」 탭에 「명령에서 사용할 수 있는 작업」 속성이 추가됩니다.
아래 작업 이름이 적힌 상자를 페이지의 셀로 드래그 앤 드롭하면 [셀 유형 작업] 명령이 설정된 버튼이 생성됩니다. 드롭한 곳이 버튼 셀이면, 그 버튼 셀에 설정된 명령의 맨 끝에 셀 유형 작업 명령이 추가됩니다.
설정 방법에 대한 자세한 내용은 「셀 유형 작업」을 참조하십시오.
| 작업 | 상세 |
| --- | --- |
| 새 채팅 생성 | 새 채팅을 시작하면 현재 대화 내용이 초기화됩니다. |
| 메시지 추가 | 텍스트 메시지를 추가합니다. 메시지 유형은 「user」 또는 「assistant」 중에서 선택할 수 있습니다.
메시지 유형이 「user」이면 AI 답변의 트리거로 설정할 수 있습니다. |
| 컴포넌트 메시지 추가 | 사용자 지정 셀을 사용하여 AI 채팅 셀에 메시지를 추가합니다. 예를 들어 사용자 지정 셀에 이미지나 링크를 설정하여 안내 카드를 표시할 수 있습니다. [이미지] |
| 도구 호출 메시지 추가 | [\[AI 도우미 명령\]](/forguncy/docs/ai/runtime-ai/ai-assistant-command) \> 고급설정\> 「도구 호출 메시지」에서 얻은 변수를 지정하면 채팅란에 도구 호출 시의 메시지를 표시할 수 있습니다\. |
| 대화 기록 가져오기 | 메시지 기록을 가져옵니다. |
| 대화 기록 설정 | 메시지 기록을 설정합니다. |
| 로딩 설정 | AI 채팅 셀을 로딩 상태로 만듭니다. 표시 체크를 해제하면 로딩 상태가 해제됩니다. |