> For the complete documentation index, see [llms.txt](https://help.directcloud.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.directcloud.net/user_manual/directcloud-ai/widget.md).

# DirectCloud AI의 챗봇 위젯 사용 방법

### 개요 <a href="#a03" id="a03"></a>

DirectCloud에서는, 생성 AI를 활용하여 Storage에서 필요한 정보를 빠르게 찾아낼 수 있는 옵션 서비스인 DirectCloud AI를 제공하고 있습니다.\
DirectCloud AI가 유효한 폴더 또는 파일을 대상으로 채팅을 시작하면, 생성 AI가 대상 파일을 참조하여 정보를 보기 쉬운 형식으로 제시해 주는 구조입니다.\
채팅에서는, 질문과 답변 외에도 파일 요약, 비교, 검색 등 다양한 기능을 이용할 수 있습니다.\
또한, AI 기능을 활용한 Web 검색도 할 수 있습니다.\
DirectCloud AI가 유효한 폴더에서는, DirectCloud AI 에디터를 이용함으로써, AI의 특성을 설정하거나 청크 데이터를 편집하여 더 정확한 답변을 얻을 수 있도록 조정할 수 있습니다.\
채팅은, 챗봇 위젯으로 외부 웹사이트에 설치할 수도 있습니다.\
이 매뉴얼에서는, 사용자 페이지의 DirectCloud AI가 유효한 폴더에서 챗봇 위젯 설정을 하는 방법을 설명합니다.

***

### 제한·보충사항 <a href="#a04" id="a04"></a>

* DirectCloud의 폴더에서 채팅룸을 이용하는 경우와 챗봇 위젯을 이용하는 경우의 사양 차이 또한 [DirectCloud AI 사양 및 참고 사항](https://help.directcloud.net/user_manual/specification/ai_specification)을 참조해주시기 바랍니다.
* 이 매뉴얼의 절차로 DirectCloud AI를 이용하시려면, 아래 설정이 완료되어 있어야 합니다.
  * [DirectCloud AI를 활성화하는 방법](https://help.directcloud.net/admin_manual/directcloud-ai/enable_ai)의 절차에서 DirectCloud AI를 사용함으로 설정
  * 관리 페이지의 [특정 폴더에 DirectCloud AI를 활성화하는 방법](https://help.directcloud.net/admin_manual/directcloud-ai/enable_ai_folder) 또는 [사용자 페이지의 지정된 폴더에서 DirectCloud AI를 활성화하는 방법](https://help.directcloud.net/user_manual/directcloud-ai/activation)의 절차에서 폴더 속성의 DirectCloud AI를 사용함으로 설정
* 챗봇 위젯을 설정하는 사용자는 <마스터> 권한이 부여되어 있어야 합니다.

***

### 절차

{% hint style="warning" %}
**채팅을 표시하기**
{% endhint %}

DirectCloud AI가 유효한 폴더에 대해 하나의 챗봇 위젯을 설정할 수 있습니다.\
챗봇 위젯 설정을 하려면, 어플리케이션에 맞는 방법으로 채팅을 표시합니다.\
본 매뉴얼에서는, Web 브라우저의 DirectCloud AI Home을 사용하여 설명합니다.

**\[Web 브라우저]**

아래 중 하나의 방법으로, 채팅을 표시합니다.

* DirectCloud AI가 유효한 폴더의 슬라이드 화면에서 'DirectCloud AI' 탭을 표시하기
* DirectCloud AI Home을 이용하는 방법의 순서로, DirectCloud AI Home을 표시하고, '폴더' 모드의 채팅을 표시하기

**\[DirectCloud 드라이브]**

* DirectCloud AI Home을 이용하는 방법의 순서로, DirectCloud AI Home을 표시하고, '폴더' 모드의 채팅을 표시하기

{% hint style="warning" %}
**챗봇 위젯 설정하기**
{% endhint %}

**\[챗봇 위젯 사용을 시작하기]**

1. 설정 버튼을 클릭한 후 '위젯'을 선택합니다.\
   위젯 화면이 표시됩니다.

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

2. 위젯을 설정한 후 저장 버튼을 클릭합니다.

   챗봇 위젯 설정이 저장됩니다.

<figure><img src="/files/qjV5D5FtAE1KiMmnfQfG" alt="" width="481"><figcaption></figcaption></figure>

<table><thead><tr><th width="192.5">항목</th><th>내용</th></tr></thead><tbody><tr><td>버튼 이미지</td><td><p>'＋'를 클릭하면, PC의 이미지 파일을 선택하여 챗봇 위젯의 버튼 이미지를 설정할 수 있습니다.</p><p>10MB 이하의 JPEG, PNG, GIF 형식의 이미지 파일을 업로드할 수 있습니다.</p><p>가로세로 비율 1:1(정사각형)의 이미지를 설정하는 것을 권장합니다.</p></td></tr><tr><td>버튼 문구 표시</td><td><p>체크하면 챗봇 위젯의 버튼 이미지 옆에 표시되는 텍스트를 설정할 수 있게 됩니다.</p><p>15자 이내의 텍스트를 입력할 수 있습니다.</p></td></tr><tr><td>세션당 최대 질문 제한</td><td>1회 세션에서 질문할 수 있는 최대 개수를 1~300 사이에서 설정합니다.<br>기본값은 50으로 설정되어 있습니다.</td></tr><tr><td>만료일</td><td>체크하면 챗봇 위젯의 유효 기간을 설정할 수 있습니다.<br>날짜 입력란을 클릭한 후 표시되는 캘린더에서 날짜를 클릭해 유효 기간을 설정할 수 있습니다.</td></tr><tr><td>비밀번호</td><td>체크하면 챗봇 위젯을 이용하기 위한 비밀번호를 설정할 수 있습니다.<br>기본값은 8자리 비밀번호가 자동 생성되도록 설정되어 있습니다.<br>챗봇 위젯을 이용하기 위한 비밀번호는 1~32자의 반각 문자로 설정할 수 있으며, 사용할 수 있는 문자 종류와 기호에는 제한이 없습니다.</td></tr></tbody></table>

3. 설정 버튼을 클릭하고, 위젯 메뉴에 이용 중이라고 표시되는지 확인합니다.

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

**\[챗봇 위젯을 Web페이지에 설치하기]**

1. '챗봇 위젯' 화면에서, '위젯 임베드 코드'의 '복사' 버튼을 클릭합니다.

<figure><img src="/files/BW9WlXUEa3llZ2sdB1Tw" alt="" width="479"><figcaption></figcaption></figure>

2. 복사한 임베드 코드를 챗봇 위젯을 설치하려는 Web 페이지에 삽입합니다

{% hint style="info" %}
**NOTE**\
위젯은 여러 Web페이지에 삽입할 수 있습니다.
{% endhint %}

3. Web 페이지에 챗봇 위젯 아이콘이 표시되는지 확인합니다.

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

\
\&#xNAN;**\[챗봇 위젯 사용 중지하기]**

챗봇 위젯 이용을 중단하려면, 이용 중인 위젯을 삭제해야 합니다.\
위젯을 삭제하면, 위젯 삽입 코드에 기재되어 있는 'data-widget-id'가 무효가 됩니다.\
또한, 위젯 삽입 코드가 설치되어 있는 웹 페이지를 새로고침하면, 위젯 표시가 사라집니다.

1. 챗봇 위젯 설정 화면에서 '위젯 삭제' 버튼을 클릭합니다.

{% hint style="info" %}
**NOTE**\
여러 Web페이지에 위젯을 설치한 경우, 모든 Web페이지에서 챗봇 위젯을 사용할 수 없게 되므로 주의해주시기 바랍니다.
{% endhint %}

<figure><img src="/files/yiOuDbEILHvKiEdnu4mq" alt="" width="476"><figcaption></figcaption></figure>

2. Web페이지에 챗봇 위젯이 설치되어 있는 경우, 삭제 확인 화면이 표시됩니다.\
   '삭제' 버튼을 클릭합니다.

<figure><img src="/files/TbvesPgfbDs1l6nmGdrr" alt="" width="487"><figcaption></figcaption></figure>

{% hint style="warning" %}
**챗봇 위젯 이용하기**
{% endhint %}

1. 챗봇 위젯을 설치한 Web페이지를 표시한 후, 위젯 아이콘을 클릭합니다.

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

2. 챗봇 위젯에 비밀번호가 설정되어 있는 경우, 비밀번호를 입력한 후 확인 버튼을 클릭합니다.

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

3. DirectCloud의 채팅과 동일한 방식으로 DirectCloud AI에 질문합니다.\
   자세한 내용은 [DirectCloud AI의 채팅룸을 이용하는 방법](https://help.directcloud.net/user_manual/directcloud-ai/use_chat_room)을 참조해주시기 바랍니다.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.directcloud.net/user_manual/directcloud-ai/widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.