> 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-works/intorduce/deep-research.md).

# 딥 리서치 사용하기

## 개요

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

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

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

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

### Works 첫 화면에서 사용하기

Works 접속 후, 아래와 같이 첫 화면에서 딥 리서치를 활성화합니다. 원하는 질문을 입력하면, 딥 리서치 앱이 실행됩니다. 이후 상세 실행 단계는 아래 "딥 리서치 앱에서 사용하기" 항목을 참고하세요.

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

### 딥 리서치 앱에서 사용하기

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 임베딩을 통한 챗봇에서 활용 시, 사용자의 범위 재설정 기능이 제한됩니다.