> 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/error_message.md).

# DirectCloud AI 오류 메시지를 확인하는 방법

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

DirectCloud에서는 생성 AI를 활용하여 Storage 내에서 필요한 정보를 빠르게 검색하거나 요약할 수 있는 옵션 서비스인 DirectCloud AI를 제공합니다.\
Web 브라우저에서 DirectCloud AI가 활성화된 폴더에서 채팅을 시작하고 알고 싶은 내용을 질문하면, 생성 AI가 해당 폴더 내 여러 파일을 참조하여 관련 정보를 추출하고 제공합니다.\
또한 DirectCloud AI에는 이메일을 파일로 저장할 때 사용하는 파일 형식인 EML 파일을, EML 요약이 활성화된 폴더에 업로드하면 내용을 질문과 답변 형식으로 요약하여 텍스트 파일로 저장하는 기능이 있습니다.\
이렇게 요약된 텍스트 파일도 DirectCloud AI의 채팅에서 참조됩니다.\
이 매뉴얼에서는 사용자 페이지에서 DirectCloud AI를 이용할 때 표시되는 오류 메시지에 대해 설명합니다.

***

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

* 이 매뉴얼의 절차를 따라 DirectCloud AI를 사용하려면 다음 설정이 완료되어 있어야 합니다.
  * 관리자 페이지의 'DirectCloud AI'->'설정' 에서 DirectCloud AI 를 '사용' 으로 설정
  * 폴더 속성의 ‘DirectCloud AI’를 ‘사용함’으로 설정
  * [DirectCloud AI를 사용하기 위한 파일을 준비하는 방법](https://help.directcloud.net/user_manual/directcloud-ai/directcloud-ai-1) 절차에 따라 DirectCloud AI의 처리 대상 파일 준비 완료
* Web 브라우저에서 DirectCloud AI의 오류 메시지를 확인하는 방법은 다음 두 가지입니다.

  * 폴더 트리에서 DirectCloud AI가 활성화된 폴더를 표시합니다.
  * DirectCloud AI Home을 사용하는 방법의 순서에 따라 DirectCloud AI Home을 표시합니다.

  이 매뉴얼 에서는 폴더 목록 중 DirectCloud AI가 활성화된 폴더를 사용하는 예시로 설명합니다.\
  DirectCloud AI Home의 ‘파일 목록’ 영역에는 ‘텍스트 추출 중’ 등의 처리 상태 메시지나, 벡터 데이터가 생성되었음을 나타내는 ‘AI’ 라벨, 또는 처리 실패 시의 실패 아이콘이 표시되지 않습니다.\
  따라서, 이 매뉴얼의 절차를 통해 파일 목록의 오류를 확인할 수는 없습니다.

***

### 절차 <a href="#a05" id="a05"></a>

{% hint style="warning" %}
**파일 목록 오류 확인**
{% endhint %}

파일을 업로드하거나 DirectCloud AI를 활성화할 때 벡터 데이터를 만들지 못하면 파일 목록에 실패 아이콘 <img src="https://help.directcloud.jp/servlet/rtaImage?eid=ka0Q80000001BcX&#x26;feoid=00N2w00000JMb2T&#x26;refid=0EMQ800000413WE" alt="ic_failed.png" data-size="line"> 이표시됩니다. 아이콘을 클릭하면 오류 메시지가 표시됩니다.

{% hint style="info" %}
**NOTE**: 접근 권한이 업로더인 사용자는 DirectCloud AI를 사용할 수 없기 때문에, 벡터 데이터 생성에 실패하더라도 파일 목록에는 실패 아이콘이 표시되지 않습니다.
{% endhint %}

**\[오류 메시지 표시 절차]**

1. DirectCloud AI 오류를 확인할 폴더를 클릭합니다.
2. 파일 목록에 표시되는 <img src="https://help.directcloud.jp/servlet/rtaImage?eid=ka0Q80000001BcX&#x26;feoid=00N2w00000JMb2T&#x26;refid=0EMQ800000413WE" alt="ic_failed.png" data-size="line"> 아이콘에 마우스를 올리면 오류 메시지가 표시됩니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2Fzhqa6a9f2XwaI06Xbtab%2Fimage.png?alt=media&amp;token=f9cf8c72-2cd2-4ddd-bf24-83321aa1086d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**NOTE**\
청크 등 AI 처리용 데이터 생성에 실패한 파일이 있으면, 폴더·파일 목록 상단에 'AI 처리용 데이터 준비에 실패한 파일이 있습니다.'라는 오류 메시지가 표시됩니다. '다시 실행' 버튼을 클릭하면 AI 처리용 데이터 생성을 다시 요청할 수 있습니다.
{% endhint %}

3. 실패 아이콘을 클릭합니다.\
   다시 시도할 수 있는 오류이면, 오류 메시지 확인 화면에 '다시 실행' 버튼과 '닫기' 버튼이 표시됩니다.
4. '다시 실행' 버튼을 클릭합니다.

**\[파일 목록 오류 메시지]**

<table data-search="false"><thead><tr><th>오류 메세지</th><th>설명</th></tr></thead><tbody><tr><td>일시적으로 AI 파일 준비에 실패했습니다.<br>! 버튼을 선택하면 다시 시도합니다.</td><td><p>AI 처리를 담당하는 외부 엔진에 일시적인 장애(서버 과부하, 통신 끊김, 네트워크 오류, 짧은 시간에 요청이 몰려 처리 속도가 제한되는 경우 등)가 발생해 처리가 중단되면 발생합니다. 파일이나 설정 문제가 아니므로, 잠시 기다린 뒤 다시 실행하면 대부분 정상적으로 완료됩니다.</p><p>오류 메시지 확인 화면에서 '다시 실행' 버튼을 클릭하면 AI 처리용 데이터 생성을 다시 실행할 수 있습니다.</p></td></tr><tr><td>크레딧 또는 용량이 부족하여 AI 파일 준비에 실패했습니다.<br>! 버튼을 선택하면 다시 시도합니다.</td><td><p>회사에 할당된 AI 크레딧을 모두 사용했거나, 해당 월에 AI 폴더에 업로드할 수 있는 용량을 초과하면 발생합니다. 크레딧과 용량은 매월 1일에 초기화됩니다. 크레딧과 용량 추가는 전체 관리에게 문의합니다.</p><p>오류 메시지 확인 화면에서 '다시 실행' 버튼을 클릭하면 AI 처리용 데이터 생성을 다시 실행할 수 있습니다.</p></td></tr><tr><td>파일이 손상되었거나 지원하지 않는 형식이라 AI 파일 준비에 실패했습니다. 파일을 확인하세요.</td><td><p>업로드한 파일에 비밀번호가 걸려 있거나 손상된 경우, AI 처리용 데이터 생성에 실패합니다.</p><p>암호화된 파일과 손상된 파일은 구분할 수 없습니다.</p><p>이 오류이면 오류 메시지 확인 화면에 '다시 실행' 버튼이 표시되지 않습니다.</p></td></tr><tr><td>파일에 암호가 걸려 AI 파일 준비에 실패했습니다.<br>암호를 해제하세요.</td><td><p>비밀번호로 암호화된 파일을 업로드하면 AI 처리용 데이터 생성에 실패합니다.</p><p>이 오류이면 오류 메시지 확인 화면에 '다시 실행' 버튼이 표시되지 않습니다.</p></td></tr><tr><td>분당 토큰 속도 제한을 초과했거나 할당된 토큰 부족으로 요청을 처리할 수 없습니다.</td><td>Azure OpenAI Service에서 결정한 분당 사용 가능한 토큰 수 또는 월간 할당량을 초과하면 내부 오류 105에서 벡터 데이터를 만들지 못합니다.<br>오류 메시지 확인 화면에서 "재실행" 버튼을 클릭하면 벡터 데이터 생성을 다시 실행할 수 있습니다.</td></tr><tr><td>Azure OpenAI Service에서 서버와 통신 중 오류 응답을 받았습니다. 잠시 후 다시 시도해 주세요.</td><td>Azure OpenAI Service 서버 오류 500이 발생하면 내부 오류 106에서 벡터 데이터를 만들지 못합니다.<br>오류 메시지 확인 화면에서 "재실행" 버튼을 클릭하면 벡터 데이터 생성을 다시 실행할 수 있습니다.</td></tr><tr><td>Azure OpenAI Service에서 서버 과부하 응답을 받았습니다. 잠시 후 다시 시도해 주세요.</td><td>Azure OpenAI Service의 서버 오류 503이 발생하면 Azure OpenAI 서버에 대한 부하로 인해 내부 오류 107에서 벡터 데이터를 만들지 못합니다.<br>오류 메시지 확인 화면에서 "재실행" 버튼을 클릭하면 벡터 데이터 생성을 다시 실행할 수 있습니다.</td></tr><tr><td>DirectCloud AI 사용을 위한 데이터 준비에 실패하였습니다. 다시 시도하시겠습니까?</td><td>알 수 없는 오류로 벡터 데이터를 만들지 못했습니다.<br>에러 메시지 확인 화면에서 [OK] 버튼을 클릭하면 다시 벡터 데이터 작성을 실행할 수 있습니다.</td></tr><tr><td>MD 파일 생성에 실패했습니다. 다시 시도하시겠습니까?</td><td><p>알 수 없는 오류로 MD 파일 생성에 실패했습니다.</p><p>오류 메시지 확인 화면에서 '다시 시도' 버튼을 클릭하면 MD 파일을 다시 생성할 수 있습니다.</p></td></tr></tbody></table>

{% hint style="warning" %}
**'DirectCloud AI' 채팅 오류 메시지 확인**
{% endhint %}

토큰 부족이나 질문·답변 관련 오류가 발생한 경우, DirectCloud AI 채팅의 질문 또는 답변 영역에 오류 메시지가 표시됩니다.

{% hint style="info" %}
**NOTE**\
DirectCloud AI 채팅에서 질문을 입력할 때 입력 가능한 토큰 수를 초과하면, 그 이상 문자를 입력할 수 없습니다. 이 경우에는 오류 메시지가 표시되지 않습니다.
{% endhint %}

**\[오류 메시지 표시 절차]**

1. DirectCloud AI 채팅을 표시합니다.\
   질문이나 답변에 표시되는 오류 메시지를 확인합니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2FSApIRgHwlmBjISVb8uwQ%2Fimage.png?alt=media&amp;token=e20aa345-12bd-4e63-a6e0-e3874813e541" alt=""><figcaption></figcaption></figure>

**\['DirectCloud AI' 채팅 오류 메시지]**

<table data-search="false"><thead><tr><th width="318.79998779296875">오류 메세지</th><th>설명</th></tr></thead><tbody><tr><td>폴더에 파일이 없습니다. 먼저 파일을 업로드해 주세요.</td><td>DirectCloud AI가 활성화된 폴더에 파일이 없는 상태에서 질문을 입력하면 오류 메시지가 표시됩니다.</td></tr><tr><td>DirectCloud AI 사용을 위한 데이터 준비 중입니다. 잠시 후 다시 시도해 주세요.</td><td>질문을 입력할 때 벡터 데이터가 생성된 파일이 없으면 답변에 오류 메시지가 표시됩니다.</td></tr><tr><td>알 수 없는 에러가 발생했습니다. 잠시 후에 다시 이용해 주세요.</td><td>위의 내용에 해당하지 않는 오류가 발생하면 내부 오류 114입니다.<br>해당 질문 또는 답변에 오류 메시지가 표시됩니다.</td></tr><tr><td>입력값이 바르지 않습니다.</td><td>입력한 값을 AI가 인식하지 못했을 때 표시됩니다.</td></tr><tr><td>권한이 없습니다.</td><td>AI 기능을 사용할 권한이 없을 때 표시됩니다.</td></tr><tr><td>크레딧을 모두 사용하였습니다. 매월 1일 크레딧이 다시 추가됩니다.</td><td><p>이번 달에 사용 가능한 크레딧 사용량을 모두 사용했을 때 표시됩니다.</p><p>크레딧 사용량이 초기화되거나 크레딧을 추가할 때까지 질문을 입력할 수 없습니다.</p></td></tr><tr><td>비교하려면 2개 이상의 파일이 필요합니다.</td><td>'파일' 모드에서 비교 대상 파일을 2개 이상 지정하지 않고 요청한 경우에 표시됩니다.</td></tr><tr><td>요약할 파일이 지정되지 않았습니다.</td><td>'파일' 모드에서 파일명을 지정하지 않은 경우나 요약을 요청한 파일명이 대상 파일과 일치하지 않은 경우에 표시됩니다.</td></tr><tr><td>선택된 파일이 없습니다.</td><td>'파일' 모드에서 파일명을 지정하지 않은 경우나 요청한 파일명이 대상 파일과 일치하지 않은 경우에 표시됩니다.</td></tr><tr><td>요약한 내용을 찾지 못했습니다.</td><td>'파일' 모드에서 내용이 빈 파일에 대해 요약을 요청한 경우에 표시됩니다.</td></tr><tr><td>관련 내용을 찾지 못했습니다.</td><td>질문에 답변할 때 참조할 청크가 존재하지 않은 경우에 표시됩니다.</td></tr><tr><td>조건에 맞는 파일을 찾지 못했습니다.</td><td>'폴더' 모드에서 검색 조건에 일치하는 파일이 없는 경우에 표시됩니다.</td></tr><tr><td>웹에서 관련 정보를 찾지 못했습니다.</td><td>'웹 검색' 모드에서 생성형 AI 모델의 응답이 비어 있는 경우에 표시됩니다.</td></tr><tr><td>응답 생성 중 오류가 발생했습니다.</td><td><p>AI 호출이 실패했을 때 표시됩니다.</p><p>Azure OpenAI는 서버가 과부하 상태이거나 Azure 측 장애 또는 일시적 오류가 발생하면 429 또는 503을 반환합니다.</p></td></tr><tr><td>처리 중 오류가 발생했습니다.</td><td>AI 호출 외의 오류가 발생했을 때 표시됩니다.</td></tr><tr><td>세션을 찾을 수 없습니다.</td><td>질문했을 때 진행 중인 채팅의 세션 정보를 찾을 수 없으면 표시됩니다.</td></tr><tr><td>시간이 초과되어 작업이 중지되었습니다. 다시 시도하세요.</td><td>AI가 답변을 위해 참조할 파일을 요청한 후 5분 안에 응답하지 않으면 표시됩니다.</td></tr><tr><td>작업이 중지되었습니다. 새로운 질문을 입력하세요.</td><td>질문을 처리하는 중에 '중지' 버튼을 클릭하면 표시됩니다.</td></tr></tbody></table>

{% hint style="warning" %}
**챗봇 위젯의 오류 메시지를 확인**
{% endhint %}

**\[오류 메시지 표시 절차]**

챗봇 위젯의 표시 절차와 이용 방법에 대해서는 DirectCloud AI의 챗봇 위젯을 이용하는 방법을 참조하십시오.

**\[챗봇 위젯의 오류 메시지]**

<table><thead><tr><th width="240.79998779296875">오류 메시지</th><th>설명</th></tr></thead><tbody><tr><td>세션 당 채팅수를 초과하였습니다. 잠시 후 다시 시도하세요.</td><td>AI가 활성화된 폴더에 설정된 위젯의 '세션당 최대 질문 수'를 초과한 경우에 표시됩니다.</td></tr><tr><td>위젯 제공 기간이 만료되었습니다.<br>자세한 내용은 관리자에게 문의하세요.</td><td>AI가 활성화된 폴더에 설정된 위젯의 '유효 기한'이 지난 경우에 표시됩니다.</td></tr><tr><td>챗봇 서비스 이용 한도에 도달했습니다.<br>자세한 내용은 관리자에게 문의하세요.</td><td>채팅 도중에 이용 가능한 크레딧을 모두 사용한 경우에 표시됩니다.</td></tr><tr><td>이 챗봇은 서비스 관련 질문에 답변드리고 있습니다.<br>파일·폴더 조회나 개별 파일에 대한 요약 등은 지원하지 않지만, 궁금하신 주제를 물어보시면 관련 내용을 답변드릴 수 있습니다.</td><td>AI가 답변할 수 없는 질문인 경우에 표시됩니다.</td></tr></tbody></table>