> 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/~/revisions/QAcqOMIS75VDXSjZirEq/alli-works/deep-research.md).

# 딥 리서치 사용하기

## 개요

딥 리서치(Deep Research)란 간단한 지시/질의 입력만으로 웹 및 문서의 다양한 정보를 수집, 분석 및 종합·추론하여 복잡한 질문에 대해 연구 보고서를 생성할 수 있는 시스템입니다. LLM Agent를 통해 구현되며, Alli의 딥 리서치 기능을 통해 웹 및 Alli에 연동된 문서를 출처로 심층적인 연구 보고서를 손쉽게 작성할 수 있습니다. 아래 사례를 포함해, 기존에 수 시간에서 수 일을 소요하던 업무를 아주 간단하게 수 분만에 실행할 수 있습니다. 

* 단순 질문-답변만으로는 충분하지 않아서 더 다각화된 정보 수집이 필요한 경우 
* 많은 사례를 포함해 심층 조사 보고서 작성이 필요한 경우
* 명확한 근거를 바탕으로 한 전략 수립이 필요한 경우

이 가이드를 통해 Alli에서 어떻게 딥 리서치를 사용하는지, 그리고 딥 리서치를 사용하기 위해 어떤 설정이 필요한지를 알 수 있습니다.

## Works 내 딥 리서치 사용 방법

Works 접속 후, 만들어진 딥 리서치 앱에 진입합니다. (앱 생성 방법은 후술됩니다.) 원하는 질문을 입력하면, 설정된 딥 리서치 Agent가 아래와 같이 조사 단계를 제안합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXczWD0InUT0OgiL9UusJ5z23cFyGO_FI3rwQtvy4L7tyY4Y9p4_A5ey7a12iQ2nhjMqJG2imuFTJEbsHfY6-rqdBrbpWKHa8LcjRjwnb1WWBKIan1oE5ztbPWSOJxajj7guORIvew?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>사용자 질문에 따른 조사 단계 제안</p></figcaption></figure>

이후, 딥 리서치 Agent 요건을 명확히 하기 위해 필요한 추가 질문을 질의합니다. 사용자가 그에 대한 답변 후, 리서치를 시작합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGYYXr80JjH4ohinhnNpQbuxJKX4Op1NnqVrMIEBXzbDN7VghYUPbXhbRAkQlAbj-wZTB0UHtqI4Ob2l54VDPIeNa1P_Z1QzE-6PetaGNsFRX0s1ci8IRK8vPECENK8KMXrf06?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>추가 질문에 대한 확인 및 리서치 시작</p></figcaption></figure>

리서치는 비동기로 실행되어, 완료 시 아래와 같이 결과가 표시됩니다. 약 10분\~수십 분이 소요되며, 진행 중 중간 단계를 확인하실 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc5mwMnJubrYC6PxO-TvjYSZGMd7p6w1c6lUKPk9Gr9aBm-QwpS5E7ruZpu3FdF3DzWD61_EJxQpsdflMnpVxcmqpMudlWlKmcjanwRtnNTHCA_rr3IDFqb_kOEg3MlaC1LucNGSA?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>결과 보고서</p></figcaption></figure>

또한, 딥 리서치 진행 전 문서 검색 범위 및 웹 검색 범위를 사용자가 지정할 수 있습니다. 권한이 있는 문서들 중 선택하거나, 신뢰할만한 웹 사이트 URL을 추가하여 제한된 범위 내에서만 보고서 작성을 지시합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcDxut9zqJSmw_uP8Ycc47x3VKpdyeRb4jjcn4rz1fUw1MO5zTYbNwPYnubMgNds4EdvwZxMVZ20p2QR-76Yh8sUJ3ZEI-cOSlNs-nFMZbi3idyvDjY_Oj9eKTk13OZ3xcjwJbo?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption></figcaption></figure>

## 딥 리서치 앱 생성 방법 (대시보드 접근 권한 필요)<br>

문의를 통해 프로젝트를 신규 생성하실 경우, 딥 리서치 앱이 기본 앱으로 내장됩니다. 그 외의 경우에도 아래와 같이 설정 가능합니다.

1. 앱 관리 > 새로운 앱 생성 > 대화형 앱 만들기 > 딥 리서치 노드 추가<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfaPrTwruf5LMBBSJCbHfVYEuCZCMoGG78V2MJZTm2YawAYrxMrWo3FZerxjISz54fCg_A_9PEEvEUBzdSkDzuLVzh_wZphOinEVcrj388oWBqP8PbUpH5uGIVRU_H0rkgJKcBQ?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>딥 리서치 노드 추가하기가하기</p></figcaption></figure>
2. 딥 리서치 노드 내 설정하기
   1. 질문 입력 방식을 선택할 수 있습니다. 사용자에게 직접 입력을 받을 경우, ‘사용자 입력’(멤버 입력)을 선택해주시고, 미리 설정해놓은 변수를 질문으로 사용하시려면 ‘변수’를 선택해주세요.
   2. 모델과 LLM 에이전트는 현재 가장 성능이 좋은 모델로 고정돼있어 선택할 수 없습니다. 향후 확장될 예정입니다.<br>

      <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfAYx8rY7cnoYhr7rdUu42wlR3lQsmCo-OK7D325L8FNSrE_hxgX1_RBMCxqSinLkaxc5pDPZcT40T-yq0i33Ou8Rckl2WvOYT7w_NpQmfGjKIiXwL9Hq0pNJ8znadljE4yRiXR?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>노드 내 입력 설정</p></figcaption></figure>
   3. 검색할 소스: 문서, 인터넷, 업로드된 파일(문서) 3가지를 지정할 수 있습니다.
      1. 문서: 선택할 경우, 앱을 실행하는 멤버/사용자가 권한을 가진 문서를 검색 범위로 포함합니다. 폴더나 해시태그 조정을 통해 특정 문서들만 사용하도록 범위를 좁힐 수 있습니다.
      2. 인터넷: 선택할 경우, 웹 사이트를 자료 검색 범위에 포함합니다. 특정 사이트를 추가할 경우, 해당 URL (및 하위 주소)에 속하는 웹사이트들만 검색 범위에 포함됩니다.
      3. 업로드된 파일: 선택할 경우, 멤버/사용자가 직접 문서를 업로드할 수 있고, 그 문서를 자료 검색 범위에 포함합니다. 만약 선택되지 않은 경우에는 업로드 자체가 불가능합니다.<br>

         <figure><img src="/files/EzfaDCfEYksf0O2WWZS7" alt=""><figcaption><p>노드 내 상세범위 설정</p></figcaption></figure>
3. 노드에서 위 설정을 적용 후, ‘공개하기’를 누르시면 Works/SDK 상에서 딥 리서치 앱을 사용하실 수 있습니다.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd0J9WL27WxTwdikIGAHDSj7ceztho1Rw0P9VjdNPd1uizzW93VIVgv0NpOWzVGCEHg_IqZ8vAUt9ytulL3hC7JJW68_WvuSkih28Pt0Q7WpQdCQ8rnbtufB-fk-p9aa-Unm0NlmQ?key=xT9t8x53varv0JXMeCMAqw" alt=""><figcaption><p>공개하기 통해 앱을 사용하기</p></figcaption></figure>

## 기타 유용한 정보

1. 딥 리서치 노드는 앱의 가장 마지막에만 위치할 수 있습니다. 즉, 이후에는 다른 노드가 이어질 수 없습니다.&#x20;
2. 노드의 ‘검색할 소스’에 대한 설정은 Works 사용자가 일부 추가 조정할 수 있습니다.&#x20;
   1. 노드에서 검색 범위 설정 시, 문서/인터넷/업로드된 파일을 선택하지 않으면, Works 내에서도 사용자가 임의로 사용할 수 없습니다. 즉, 문서만 선택되어있는 경우는 인터넷에서 검색이 불가능합니다.
   2. 문서/인터넷/업로드된 파일이 선택된 경우에는, 사용자가 가진 권한 내에서 노드에서 미리 지정된 상세 범위 외 다른 범위를 지정할 수 있습니다. 즉, 노드에서 지정된 값은 사용자의 편의를 위한 초기값으로 사용되며,&#x20;
3. Works 외 SDK 임베딩을 통한 챗봇에서 활용 시, 사용자의 범위 재설정 기능이 제한됩니다.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.allganize.ai/allganize-alli-works/~/revisions/QAcqOMIS75VDXSjZirEq/alli-works/deep-research.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.