> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/allganize-alli-works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/allganize-alli-works/alli-dashboard/app-management/conversation-app/multimodal.md).

# 답변 생성 노드에서 멀티 모달 옵션 사용하기

이제 답변 생성 노드에서 이미지·파일·오디오 분석은 물론, 이미지와 파일 생성 기능까지 완전히 활용할 수 있습니다. 앱의 각 노드마다 원하는 툴과 모델을 자유롭게 조합해 사용할 수 있으며, 단일 대화 흐름 안에서 문서·FAQ·웹 기반의 RAG 에이전트 실행부터 업무에 필수적인 이미지·파일 분석 및 결과물 생성까지 매끄럽게 수행할 수 있습니다.

### 1. 노드 설정 방법

<figure><img src="/files/4TsvLLNC4fpvu78qqRfC" alt=""><figcaption></figcaption></figure>

1. 대화형 앱 내에서 답변 생성 노드를 클릭합니다.
2. 실행 유형으로 RAG Agent를 선택합니다.
3. 베이스 모델을 선택합니다.
   * 이 모델은 RAG Agent에서 질문이 들어왔을 때, 질문이 어떤 툴로 분류되어야 하는지 의도 분류에도 사용됩니다. 또한, 이미지 생성 시에도 텍스트 답변을 생성할 때 해당 베이스 모델이 활용됩니다.
4. 검색 소스를 선택합니다. (1개 이상의 검색 소스 선택이 필요합니다)

<figure><img src="/files/RFi2QdrMCiUQLWcD3EzJ" alt=""><figcaption></figcaption></figure>

5. **필요한 멀티 모달 옵션을 활성화합니다.**

### 2. 멀티 모달 옵션 설정 방법

멀티 모달 옵션은 **분석**과 **생성** 두 가지 분류로 나뉩니다. 각 분류별로 사용할 수 있는 툴과 조건을 알아보겠습니다.

***

#### 2-1. 분석

분석 옵션을 사용하면 파일, 이미지, 오디오를 대화 내에서 인입하고 모델이 이를 분석할 수 있습니다. 각 툴별 조건은 다음과 같습니다.\
\
**파일 분석**

<figure><img src="/files/RWsW1BpEZ0gXc7XMrSYj" alt=""><figcaption></figcaption></figure>

해당 툴을 ON으로 활성화하면 대화 내에서 파일을 업로드하고, 지정한 모델로 분석할 수 있습니다.\
OFF 상태에서는 대화 내에서 파일을 첨부할 수 없습니다.

한 번에 최대 5개의 파일을 업로드할 수 있으며, 총 용량은 100MB를 넘을 수 없습니다.

* 예: 파일 하나가 100MB인 경우 1개만 업로드 가능
* 파일이 1MB인 경우, 총합이 100MB를 넘지 않더라도 최대 5개까지만 업로드 가능합니다.

인입할 수 있는 파일 확장자는 하기와 같습니다.

```
- txt
- docx
- xlsx
- pdf
- csv
- hwpx
- pptx
```

\
**이미지 분석**

<figure><img src="/files/rWuCbD5kKX7ozTWG1dkg" alt=""><figcaption></figcaption></figure>

해당 툴을 ON으로 활성화하면 대화 내에서 이미지를 업로드하고, 지정한 모델로 분석할 수 있습니다.\
OFF 상태에서는 이미지 첨부가 불가능합니다.

한 번에 최대 5개의 이미지를 업로드할 수 있으며, 총 용량은 50MB를 넘을 수 없습니다.

* 예: 이미지 하나가 50MB인 경우 1개만 업로드 가능
* 이미지가 1MB인 경우, 총합이 50MB를 넘지 않더라도 최대 5개까지 업로드 가능합니다.

\
인입할 수 있는 이미지 확장자는 하기와 같습니다.

```
- jpeg
- jpg
- png
```

\
**오디오 분석**

<figure><img src="/files/O1XHoBTGsmBi3jhPlMtQ" alt=""><figcaption></figcaption></figure>

해당 툴을 ON으로 활성화하면 대화 내에서 오디오 파일을 업로드하고, 지정한 모델로 분석할 수 있습니다.\
OFF 상태에서는 오디오 첨부가 불가능합니다.

한 번에 최대 10개의 오디오 파일을 업로드할 수 있으며, 총 용량은 100MB를 넘을 수 없습니다.

* 예: 오디오 파일 하나가 100MB인 경우 1개만 업로드 가능
* 파일이 1MB인 경우, 총합이 100MB를 넘지 않더라도 최대 5개까지 업로드 가능합니다.
* **오디오 파일은 용량과 재생 시간이 비례하지 않을 수 있습니다. 안정적인 처리를 위해 1시간 미만의 음성 파일 업로드를 권장합니다.**

\
인입할 수 있는 이미지 확장자는 하기와 같습니다.

```
- mp3
- wav
- mpga
- m4a
```

#### 2-2. 생성

생성 옵션을 사용하면 파일이나 이미지를 대화 내에서 모델이 생성할 수 있습니다. 각 툴별 조건은 다음과 같습니다.

**파일 생성**

<figure><img src="/files/CBFUhjnVM1AInQCl3XyW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/m2aBp4aKFaVXMExd86qg" alt=""><figcaption></figcaption></figure>

해당 툴을 ON으로 활성화하면, 대화 중 질문에 따라 파일을 생성할 수 있습니다.\
OFF 상태에서는 파일 생성이 불가능하며, 대화에서 파일 생성을 요청할 경우 에이전트가 “현재 파일 생성은 불가능하다”는 안내 메시지를 표시합니다.

생성 시에는 하기 4개 확장자를 지원합니다.&#x20;

```
- pdf
- xlsx
- docx
- pptx
```

**이미지 생성**

<figure><img src="/files/GX0F6u47DjXtwuP7q4IL" alt=""><figcaption></figcaption></figure>

해당 툴을 ON으로 활성화하면, 대화 중 질문에 따라 이미지를 생성할 수 있습니다.\
OFF 상태에서는 이미지 생성이 불가능하며, 대화에서 이미지 생성을 요청할 경우 에이전트가 “현재 이미지 생성은 불가능하다”는 안내 메시지를 표시합니다.

현재 이미지 편집 기능은 제공되지 않습니다. 추후 생성된 이미지 및 업로드한 이미지를 편집·재생성할 수 있는 기능을 제공 예정입니다.

#### 4. 대화 기록

<figure><img src="/files/lvHFUEuZfrY2UNpGN6i6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/XmsyQpCyxMDvdRdKRJGw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Zf0K2l3FL3Pq2kPGVEVq" alt=""><figcaption></figcaption></figure>

대시보드 내 대화기록을 통해 유저가 업로드한 파일 및 이미지, 생성된 내용등을 확인할 수 있습니다.

#### 5. 소비된 크레딧 확인&#x20;

<figure><img src="/files/L5ZAdfLZ1ICQ5vRnMSyY" alt=""><figcaption></figcaption></figure>

사용된 크레딧은 결제 > 답변 생성 영역에서 확인하실 수 있습니다. &#x20;

#### 6. 안내 사항

**3-1. 앱 미리보기**

<figure><img src="/files/vuvb1V6ol5TuxHMG0lmR" alt=""><figcaption></figcaption></figure>

* 현재 Works 화면에서만 여러 이미지 및 여러 파일 업로드가 지원되며, SDK에서는 지원되지 않습니다.
* 따라서 앱 프리뷰(SDK 화면)에서는 파일 첨부 아이콘이 표시되지 않아, 멀티 모달 기능을 정상적으로 테스트할 수 없습니다.

이를 위해 하기 순서에 따라 테스트를 진행해 주세요.

<figure><img src="/files/7k2DuQq1oAzOYRCW82mK" alt=""><figcaption></figcaption></figure>

1. 먼저 앱 공개를 통해 본인을 앱 뷰어로 지정합니다.
2. 검증을 진행합니다.
3. 검증이 완료되면 접근 권한 목록을 조정한 후 앱을 재공개 합니다.

이 가이드를 따라 주시면 멀티 모달 기능을 안전하게 테스트하실 수 있습니다.

**3-2. 대화 내 파일 업로드 방식**

<figure><img src="/files/Qb80QzqOBSYm7gRpz2yR" alt=""><figcaption></figcaption></figure>

이미지, 파일, 오디오를 대화에 첨부하려면 우측 하단의 첨부파일 버튼 > ‘대화 내 업로드’를 통해 여러 파일을 선택하여 채팅과 함께 전송할 수 있습니다. 드래그 앤 드롭, 복사·붙여넣기도 지원됩니다.\
\
각 타입별 전송 제한은 다음과 같습니다.

* 이미지: 최대 50MB, 최대 5개
* 파일: 최대 100MB, 최대 5개
* 오디오: 최대 100MB, 최대 5개

**3-3. 크레딧 주의 사항**

<figure><img src="/files/dcNcgFITisI47qFu9k9X" alt=""><figcaption></figcaption></figure>

에이전트는 토큰 허용 범위 내에서 기존 대화, 파일, 오디오, 이미지 등을 메모리에 저장하고, 매 질문 시 이를 조합니다.\
따라서 새로운 이미지나 질문을 입력할 경우, 대화 내 기존에 업로드한 다른 파일도 함께 참조될 수 있으며, 이때 크레딧이 부과될 수 있습니다.

만약 기존 내용과 무관하게 방금 올린 파일만을 기반으로 작업을 진행하고 싶다면, ‘새 대화하기’를 클릭하여 대화를 갱신해 주세요.

**3-4. 개인 문서함 공용 문서함과의 차이**

<figure><img src="/files/P9WFoWVtS0F0BscuDh8k" alt=""><figcaption></figcaption></figure>

기존 문서함에 올린 문서는 DI 파이프라인을 거쳐 정리·저장된 후 모델이 답변을 만들 때 참고 자료로 사용되지만, 대화 중 업로드한 파일이나 자료는 별도의 파이프라인 없이 바로 모델에 전송되어 즉시 답변 생성에 사용되며, 문서함과 달리 다른 대화에서 참조할 수 없고 RAG 과정도 거칠 수 없다는 점에 주의해 주세요.