9.5. 리서치 & 요약¶
주제를 조사하려면 여러 브라우저 탭을 오가며 텍스트를 복사하고, 수동으로 메모를 정리해야 하는 경우가 많습니다. Backend.AI GO의 Cowork 메뉴는 이 과정을 하나의 워크플로우로 통합합니다. 조사하고 싶은 내용을 설명하면, 에이전트가 자율적으로 웹을 검색하고, 기사를 수집하고, 데이터를 분석하여 구조화된 보고서를 작성합니다. 모든 작업은 데스크톱에서 이루어집니다.
이 가이드에서는 리서치 작업을 위한 Cowork 설정 방법과 리서치 보고서를 생성하는 단계별 예시를 제공합니다.
왜 Cowork으로 리서치를 해야 할까요?¶
| 기존 워크플로우 | Cowork 워크플로우 |
|---|---|
| 수동으로 검색하고, 탭을 열고, 텍스트를 복사 | 에이전트가 자율적으로 검색하고 콘텐츠를 수집 |
| 브라우저, 편집기, 스프레드시트를 전환하며 작업 | 전체 워크플로우를 하나의 인터페이스에서 처리 |
| 메모를 정리하고 요약을 수동으로 작성 | 에이전트가 내용을 종합하여 보고서를 작성 |
| 범위가 변경되면 처음부터 다시 작업 | Steering으로 작업 중 방향을 조정 |
사전 준비¶
시작하기 전에 다음을 확인하세요:
- Backend.AI GO가 설치되어 실행 중인 상태
- 최소 하나의 모델이 로드된 상태 — 최상의 요약 품질을 위해 7B+ 파라미터 모델 권장
- (선택) 웹 검색을 위한 Brave Search API 키 — 아래 웹 검색 설정 참조
리서치용 빌트인 도구¶
Cowork 메뉴는 리서치 워크플로우에 특히 유용한 여러 빌트인 도구를 제공합니다. 플러그인이나 확장 기능이 필요하지 않습니다.
| 도구 | 기능 |
|---|---|
web_search | Brave Search를 통해 기사, 논문, 데이터를 웹에서 검색 |
fetch_url | 웹 페이지를 가져와 읽기 쉬운 Markdown으로 변환 |
read_file | 로컬 문서 읽기 (텍스트, Markdown, 로그) |
write_file | 보고서, 요약, 메모를 파일 시스템에 저장 |
csv_reader | CSV 파일에서 표 형식 데이터를 파싱하고 분석 |
json_query | JSONPath 표현식으로 구조화된 JSON 데이터 조회 |
run_python | 데이터 처리 및 분석을 위한 Python 스크립트 실행 |
calculator | 수학 표현식 계산 |
웹 검색 설정¶
web_search 도구는 Brave Search API를 사용하며, API 키가 필요합니다.
-
brave.com/search/api에서 무료 API 키를 신청합니다 (무료 등급은 월 2,000건의 쿼리를 제공합니다).
-
Backend.AI GO에서 설정 > 도구 & 확장을 엽니다.
-
지정된 필드에 Brave Search API 키를 입력합니다.
웹 검색은 선택 사항입니다
Brave Search API 키를 설정하지 않아도, 에이전트는 사용자가 제공하는 URL에 fetch_url을 사용하거나, 로컬 문서에 read_file을 사용하거나, 허용된 폴더의 데이터 파일로 리서치할 수 있습니다. 웹 검색은 자동으로 새로운 소스를 발견하는 기능을 추가할 뿐입니다.
단계별 예시: 기술 리서치 보고서¶
이 예시는 Cowork 메뉴를 사용한 완전한 리서치 워크플로우를 보여줍니다.
1단계: Cowork 열기¶
사이드바에서 Cowork 아이콘을 클릭하여 Cowork 인터페이스를 엽니다.
2단계: 폴더 권한 설정¶
에이전트에게 리서치 결과를 저장할 장소가 필요합니다.
-
작업 입력 영역에서 폴더 권한 토글을 클릭합니다.
-
폴더 추가를 클릭하고 리서치 출력 폴더를 선택합니다 (예:
~/Documents/research). -
에이전트가 파일을 저장할 수 있도록 권한 수준을 읽기 및 쓰기로 설정합니다.
권한 수준
- 읽기 전용: 에이전트가 파일을 읽을 수 있지만 생성하거나 수정할 수 없습니다. 참고 문서를 제공할 때 유용합니다.
- 읽기 및 쓰기: 에이전트가 기존 파일을 읽고 새 파일을 생성하거나 수정할 수 있습니다. 리서치 출력에 권장됩니다.
- 전체 접근: 에이전트가 파일을 삭제하고 이동할 수도 있습니다. 주의해서 사용하세요.
3단계: Global Instructions 설정 (선택)¶
Global Instructions를 설정하면 에이전트가 일관된 리서치 스타일을 따르도록 도울 수 있습니다.
-
헤더의 톱니바퀴 아이콘을 클릭하여 설정 드로어를 엽니다.
-
Instructions 탭으로 이동합니다.
-
다음과 같은 지침을 입력합니다:
-
지침을 활성화하고 드로어를 닫습니다.
이 지침은 변경할 때까지 이후 모든 Cowork 작업에 적용됩니다.
4단계: 리서치 작업 입력¶
Cowork 페이지 하단의 작업 입력란에 리서치 목표를 설명합니다:
WebAssembly 채택 현황에 대해 조사해 주세요. 최근 기사와 기술 블로그 게시물을 검색하고, 가장 관련성 높은 3개 페이지를 가져와서, 내 리서치 폴더에
wasm-research.md로 구조화된 요약 보고서를 작성해 주세요. 주요 통계, 주요 사용 사례, 브라우저 지원 현황, WebAssembly를 프로덕션에서 사용하는 주요 프로젝트를 포함해 주세요.
Enter를 누르거나 작업 시작을 클릭하여 시작합니다.
5단계: 에이전트 작업 관찰¶
에이전트가 작업을 단계별로 분해하고 자율적으로 실행합니다. 스텝 뷰어에서 진행 상황을 확인할 수 있습니다:
-
웹 검색 — 에이전트가
web_search를 사용하여 WebAssembly 채택에 대한 최근 기사를 검색합니다. -
기사 수집 — 가장 관련성 높은 결과를 선택하고
fetch_url을 사용하여 전체 콘텐츠를 가져옵니다. 콘텐츠는 자동으로 Markdown으로 변환됩니다. -
분석 — 에이전트가 수집한 콘텐츠를 읽고 핵심 주제, 통계, 주요 프로젝트를 파악합니다.
-
보고서 생성 — 발견 사항을 구조화된 Markdown 보고서로 종합합니다.
-
저장 — 에이전트가
write_file을 사용하여 보고서를 리서치 폴더에 저장합니다. -
요약 — 핵심 발견 사항이 포함된 최종 요약이 제시됩니다.
도구 승인
에이전트가 web_search나 fetch_url을 처음 사용할 때 승인 요청이 표시될 수 있습니다. 한 번만 승인하거나 세션 동안 승인하도록 선택할 수 있습니다. 허용된 폴더 내의 읽기 작업은 기본적으로 자동 승인됩니다.
6단계: 작업 중 에이전트 안내¶
에이전트가 조정하고 싶은 방향으로 진행 중이라면, 에이전트 실행 중에 나타나는 Steering 입력을 사용하세요:
- "엣지 컴퓨팅과 서버리스 사용 사례에 더 집중해 주세요"
- "WASM과 네이티브 코드의 성능 벤치마크도 찾아보세요"
- "브라우저 지원 섹션은 건너뛰세요, 이미 알고 있습니다"
에이전트가 처음부터 다시 시작하지 않고 안내를 반영합니다.
예시: 로컬 문서 요약¶
Cowork은 이미 디스크에 있는 문서를 요약하는 데도 효과적입니다. 웹 검색이 필요하지 않습니다.
-
문서 폴더를 읽기 전용 권한으로 추가합니다 (에이전트는 읽기만 하면 됩니다).
-
요약을 저장할 출력 폴더를 읽기 및 쓰기 권한으로 추가합니다.
-
다음과 같은 작업을 입력합니다:
내 문서 폴더의 모든 PDF 파일을 읽고, 각 파일을 3-5개의 글머리 기호로 요약한 다음, 출력 폴더에
document-summaries.md로 통합 요약 문서를 저장해 주세요.
에이전트가 read_file로 각 문서를 읽고 write_file로 통합 요약을 저장합니다.
예시: 리서치 데이터 분석¶
데이터 기반 리서치의 경우, Cowork은 데이터 분석 도구와 요약을 결합할 수 있습니다.
-
데이터 폴더를 읽기 전용 권한으로 추가합니다.
-
출력 폴더를 읽기 및 쓰기 권한으로 추가합니다.
-
다음과 같은 작업을 입력합니다:
survey-results.csv의 설문 조사 결과를 분석해 주세요. 인구 통계 그룹별로 응답을 분류하고, 주요 통계(평균, 중앙값, 표준편차)를 계산한 다음, 발견 사항을 요약한 리서치 메모를survey-analysis.md로 저장해 주세요.
에이전트가 csv_reader로 CSV를 파싱하고, run_python으로 통계 계산을 수행하며, write_file로 분석 결과를 저장합니다.
고급: 다중 소스 리서치¶
포괄적인 리서치를 위해, 에이전트에게 여러 소스 유형을 결합하도록 요청할 수 있습니다:
재생 에너지 동향을 조사해 주세요. 온라인에서 최근 기사 3개를 검색하고, 로컬 파일
energy-data-2024.csv의 과거 데이터를 읽은 다음, 온라인 조사 결과와 데이터 분석을 결합한 보고서를 작성해 주세요.energy-report.md로 저장해 주세요.
에이전트가 다음을 수행합니다:
- 온라인 소스에
web_search와fetch_url사용 - 로컬 데이터에
csv_reader또는read_file사용 - 필요한 경우
run_python으로 계산 수행 - 모든 내용을 통합된 보고서로 종합
팁¶
- 명확하고 구체적인 프롬프트로 시작하세요. 원하는 형식, 깊이, 특정 주제에 대해 더 많은 세부 정보를 제공할수록 결과가 좋아집니다.
- 폴더별 지침을 활용하세요. 프로젝트 수준의 표준을 인코딩할 수 있습니다. 예를 들어, 학술 리서치 폴더에 "APA 인용 형식을 사용하세요"와 같은 지침을 첨부하세요.
- 참고 자료에는 읽기 전용 접근 권한을 부여하세요. 에이전트가 참조하되 수정하면 안 되는 기존 리서치나 데이터 파일이 있다면, 읽기 전용 권한으로 별도의 폴더로 추가하세요.
- 반복적 리서치에 Steering을 활용하세요. 처음부터 완벽한 프롬프트를 작성할 필요 없이, 작업 중인 에이전트를 안내할 수 있습니다.
- 검토하고 검증하세요. AI가 생성한 리서치는 강력한 출발점이지만, 핵심 주장과 통계는 항상 원본 출처와 대조하여 확인하세요.
문제 해결¶
| 문제 | 해결 방법 |
|---|---|
web_search가 오류를 반환 | 설정 > 도구 & 확장에서 Brave Search API 키가 설정되어 있는지 확인하세요. 무료 등급은 월 2,000건의 쿼리를 허용합니다. |
fetch_url이 특정 페이지에서 실패 | 일부 웹사이트는 자동화된 요청을 차단합니다. 다른 소스를 시도하거나, 콘텐츠를 수동으로 파일에 붙여넣고 read_file을 사용하세요. |
| 에이전트가 얕은 요약을 생성 | 더 큰 모델(13B+ 파라미터)을 사용하면 이해력과 요약 품질이 향상됩니다. "표면적인 요약이 아닌 상세한 분석을 제공하세요"와 같은 지침을 추가하세요. |
| 보고서에 출처가 누락 | Global Instructions나 폴더별 지침에 "항상 출처 URL을 포함하세요"를 추가하세요. |