# DirectCloud AI의 에이전트 로그를 확인하는 방법

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

DirectCloud에서는, 생성형 AI를 활용하여 Storage에서 필요한 정보를 신속하게 찾을 수 있는 옵션 서비스인 DirectCloud AI를 제공하고 있습니다.\
DirectCloud AI가 활성화된 폴더 또는 파일을 대상으로 채팅을 시작하면, 생성형 AI가 해당 파일을 참조하여 정보를 보기 쉬운 형식으로 제시해 줍니다. 채팅에서는 질문과 답변 외에도 파일 요약, 비교, 검색 등 다양한 기능을 이용할 수 있습니다. 또한, AI 기능을 활용한 Web 검색도 가능합니다.\
DirectCloud AI가 활성화된 폴더에서는 DirectCloud AI 에디터를 사용하여 AI의 특성을 설정하거나 청크 데이터를 편집함으로써 더 정확한 답변을 얻을 수 있도록 조정할 수 있습니다. 채팅은 챗봇 위젯으로 외부 Web 사이트에 설치할 수도 있습니다.\
DirectCloud AI 및 위젯에서의 채팅 대화량에 따라 토큰 또는 크레딧이 소비됩니다.\
이 매뉴얼에서는, 관리자 페이지의 'DirectCloud AI' > 'AI 에이전트 로그'에서, 사용자가 DirectCloud AI 채팅을 이용했을 때 내부에서 동작한 에이전트 정보를 로그로 확인하는 방법에 대해 설명합니다.

***

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

* 관리자 권한이 부여된 사용자는 관리자 페이지의 'DirectCloud AI' 항목에 체크가 되어 있어야 합니다.
* 내보내기되는 텍스트 파일의 문자 인코딩은 '공유 설정' > '세부 기능 설정' 메뉴의 '문자 인코딩' 설정에서 지정됩니다.

***

### 절차

{% hint style="warning" %}
**에이전트 로그 확인하기**
{% endhint %}

**\[에이전트 로그 화면 표시하기]**

1. 'DirectCloud AI' > 'AI 에이전트 로그' 메뉴를 클릭합니다.

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

**\[DirectCloud AI에서 실행된 에이전트 로그 확인하기]**

1. 'DirectCloud AI' 탭을 클릭합니다.

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

DirectCloud AI에서 실행된 에이전트 로그가 표시됩니다.

<table><thead><tr><th width="222.5" valign="top">항목</th><th valign="top">설명</th></tr></thead><tbody><tr><td valign="top">채팅명</td><td valign="top"><p>사용자가 질문한 채팅의 이름이 표시됩니다.</p><p>NOTE：DirectCloud AI Home에서 채팅 이름이 변경된 경우에도, "채팅명"에 표시된 이름은 변경되지 않습니다.</p></td></tr><tr><td valign="top">질의 내용</td><td valign="top">사용자가 채팅에서 질문한 내용이 표시됩니다.<br>클릭하면 "실행 이력 상세 정보" 화면에서 DirectCloud AI의 처리 상세 내용이 표시됩니다.</td></tr><tr><td valign="top">요청 일시</td><td valign="top">사용자로부터 질문을 받았을 때 DirectCloud AI가 요청을 수신한 일시가 표시됩니다.</td></tr><tr><td valign="top">요청자</td><td valign="top">채팅에서 질문한 사용자의 이름이 표시됩니다.</td></tr><tr><td valign="top">요청 의도</td><td valign="top">DirectCloud AI가 분석한 사용자의 질문 의도가 표시됩니다.</td></tr><tr><td valign="top">총 처리 시간(초)</td><td valign="top">처리가 완료될 때까지 걸린 총 시간이 표시됩니다.</td></tr><tr><td valign="top">Model</td><td valign="top">채팅 처리에 사용된 GPT 모델이 표시됩니다.<br>현재 지원되는 GPT 모델에 대해서는 DirectCloud AI를 활성화하는 방법을 참조하세요.</td></tr><tr><td valign="top">총 토큰 소모량</td><td valign="top">에이전트 처리에 소비된 토큰 소비량이 표시됩니다.</td></tr></tbody></table>

2. 상세 내용을 확인하려면 '질의 내용'을 클릭합니다.

<figure><img src="/files/6ejRp0lmAUN5CSJeaAFd" alt=""><figcaption></figcaption></figure>

'실행 이력 상세 정보' 화면에 선택한 질문을 했을 때 내부 에이전트가 수행한 처리의 상세 정보가 표시됩니다.

3. 단계를 클릭하면 개별 내부 에이전트의 처리를 확인할 수 있습니다.

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

**\[챗봇 위젯에서 실행된 에이전트 로그 확인하기]**

1. '챗봇 위젯' 탭을 클릭합니다.

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

챗봇 위젯에서 실행된 채팅의 에이전트 로그가 표시됩니다.

<table><thead><tr><th valign="top">항목</th><th valign="top">설명</th></tr></thead><tbody><tr><td valign="top">챗봇명</td><td valign="top">DirectCloud AI 에디터에서 폴더에 설정된 "이름"이 챗봇명으로 표시됩니다.<br><br>NOTE：DirectCloud AI 에디터에서 폴더의 "이름"이 변경된 경우에도, "챗봇명"에 표시된 이름은 변경되지 않습니다.</td></tr><tr><td valign="top">질의 내용</td><td valign="top">사용자가 챗봇 위젯에서 질문한 내용이 표시됩니다.</td></tr><tr><td valign="top">진입 경로</td><td valign="top">챗봇 위젯을 설치한 Web 페이지의 URL이 표시됩니다.</td></tr><tr><td valign="top">요청 일시</td><td valign="top">사용자로부터 질문을 받았을 때 DirectCloud AI가 요청을 수신한 일시가 표시됩니다.</td></tr><tr><td valign="top">요청자</td><td valign="top">챗봇 위젯을 사용한 사용자에게 자동으로 부여되는 고유 값이 표시됩니다.</td></tr><tr><td valign="top">총 처리 시간(초)</td><td valign="top">처리가 완료될 때까지 걸린 총 시간이 표시됩니다.</td></tr><tr><td valign="top">Model</td><td valign="top">처리에 사용된 GPT 모델이 표시됩니다.현재 지원되는 GPT 모델에 대해서는 DirectCloud AI를 활성화하는 방법을 참조하세요.</td></tr><tr><td valign="top">총 토큰 소모량</td><td valign="top">에이전트 처리에 소비된 토큰 소비량이 표시됩니다.</td></tr></tbody></table>

{% hint style="warning" %}
**DirectCloud AI 에이전트 로그 필터링하여 표시하기**
{% endhint %}

에이전트 로그 화면에서는 'DirectCloud AI' 또는 '챗봇위젯"'탭을 선택하여 각각의 에이전트 로그를 필터링하여 표시할 수 있습니다.

**\[DirectCloud AI 탭]**

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

**\[챗봇 위젯 탭]**

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

**\[필터링 항목]**

<table><thead><tr><th width="140" valign="top">No.</th><th valign="top">설명</th></tr></thead><tbody><tr><td valign="top">❶</td><td valign="top">DirectCloud AI 사용 이력을 표시할 기간을 '최근 7일', '최근 15일', '최근 1개월', '최근 3개월' 중에서 선택합니다.</td></tr><tr><td valign="top">❷</td><td valign="top">계약 시작부터 현재까지 DirectCloud AI 사용 이력을 표시할 기간을 지정합니다. 지정 가능한 기간은 12개월입니다.</td></tr><tr><td valign="top">❸</td><td valign="top"><p>'질의 내용'은 'DirectCloud AI' 탭에만 표시됩니다. 클릭하여 드롭다운 목록을 표시하고 다음 중 하나를 선택합니다. 기본적으로 '전체 구분'이 선택되어 있어 전체가 검색 대상이 됩니다.</p><ul><li>질의 응답</li><li>문서 요약</li><li>비교 분석</li><li>웹 검색</li><li>파일 검색</li><li>채팅</li></ul></td></tr><tr><td valign="top">❹</td><td valign="top">클릭하여 드롭다운 목록을 표시하고 다음 중 하나의 GPT 모델을 선택합니다. 기본적으로 '전체 모델'이 선택되어 있어 전체가 검색 대상이 됩니다.</td></tr><tr><td valign="top">❺</td><td valign="top"><p>탭에 따라 다음과 같이 DirectCloud AI 사용 이력을 필터링할 수 있습니다.</p><ul><li><p>DirectCloud AI 탭</p><ul><li>채팅명 / 질의 내용 / 요청</li></ul></li><li><p>채봇 위젯</p><ul><li>챗봇명 / 질의 내용 / 요청자 / 진입 경로</li></ul></li></ul></td></tr><tr><td valign="top">❻</td><td valign="top">에이전트 로그를 표시할 건수를 '10', '25', '50', '100' 중에서 선택합니다.</td></tr></tbody></table>

{% hint style="warning" %}
**DirectCloud AI 에이전트 로그를 CSV 파일로 다운로드하기**
{% endhint %}

이 매뉴얼에서는 'DirectCloud AI' 탭을 예시로 다운로드 절차를 설명하고 있지만, '챗봇 위젯"'탭에서도 동일하게 조작할 수 있습니다.

1. 'CSV 다운로드' 버튼을 클릭합니다.

   DirectCloud AI 사용 이력은 대량의 데이터가 될 수 있으므로, 미리 필터링하여 표시한 후 다운로드하는 것을 권장합니다.\
   CSV 파일이 다운로드됩니다.

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

2. CSV 파일을 열어 문제없이 표시되는지 확인합니다.

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


---

# Agent Instructions: 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/admin_manual/directcloud-ai/agent_log.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.