3.1. Cowork 개요¶

Cowork는 Backend.AI GO를 단순한 챗봇에서 스스로 생각하고, 도구를 사용하며, 서브 에이전트를 조율하여 복잡한 작업을 완수하는 자율 비서로 진화시킵니다.

Cowork란 무엇인가요?¶

모델이 단순히 다음에 올 텍스트를 예측하는 일반적인 채팅과 달리, Cowork는 ReAct (Reasoning + Acting) 패턴을 따릅니다:

1. 관찰: 사용자의 요청과 현재 환경을 분석합니다.

2. 사고: 계획을 세우고 도구가 필요한지 판단합니다.

3. 행동: 도구를 실행합니다 (예: 웹 검색, 파일 읽기).

4. 관찰: 도구의 실행 결과를 보고, 계속 진행할지 아니면 최종 답변을 내놓을지 결정합니다.

주요 장점¶

• 최신 정보 활용: Cowork는 웹 검색을 통해 학습 데이터에 없는 최신 정보를 찾아낼 수 있습니다.

• 실질적인 작업 수행: 로컬 파일을 읽거나 코드를 실행하여 계산 결과를 검증하는 등 직접적인 행동을 취할 수 있습니다.

• 자율적인 추론: 상위 수준의 목표를 제시하면, Cowork가 이를 달성하기 위한 세부 단계들을 스스로 찾아냅니다.

• 병렬 실행: 서브 에이전트가 여러 작업을 동시에 처리하여 더 빠른 결과를 제공합니다.

Cowork가 필요한 경우¶

• 조사 및 리서치: "NVIDIA RTX 50 시리즈 그래픽카드의 최신 가격 정보를 찾아줘."

• 데이터 분석: "내 문서 폴더에 있는 CSV 파일을 읽고 판매 트렌드를 요약해줘."

• 코드 디버깅: "이 파이썬 스크립트를 실행해보고 왜 SyntaxError가 발생하는지 알려줘."

Cowork 시작하기¶

1. 사이드바에서 Cowork 아이콘을 클릭합니다.

2. 프로필 선택기에서 에이전트 프로필(예: "일반 비서", "웹 리서처")을 선택합니다.

3. 도구 사용(Tool Calling) 기능이 지원되는 모델을 선택합니다 (라이브러리에서 "Tool Calling" 태그가 붙은 모델을 확인하세요).

4. 작업 패널에 수행할 작업을 입력합니다.

5. 타임라인에서 에이전트의 "사고" 과정과 도구 실행 모습을 실시간으로 확인하세요.

폴더 권한¶

Cowork는 시스템의 폴더에 접근하기 위해 명시적인 권한이 필요합니다. 이를 통해 에이전트가 승인된 디렉터리 내에서만 작업하도록 보장합니다.

권한 수준¶

폴더 접근 관리¶

1. 사이드바에서 Cowork 패널을 엽니다.

2. 폴더 섹션을 클릭하여 허용된 디렉터리를 확인합니다.

3. 폴더 추가를 클릭하여 폴더 선택기를 열고 새 디렉터리에 접근 권한을 부여합니다.

4. 각 폴더의 권한 수준을 설정합니다.

5. 접근 권한을 취소하려면 폴더 항목 옆의 제거 버튼을 클릭합니다.

상시 지시사항¶

상시 지시사항(Standing Instructions)은 모든 작업에서 에이전트의 동작을 안내하는 영구적인 지침입니다. 매 상호작용 시 시스템 프롬프트에 주입됩니다.

전역 지시사항¶

전역 상시 지시사항은 어떤 폴더나 프로필이 활성화되어 있든 모든 Cowork 세션에 적용됩니다.

1. 사이드바에서 Cowork 설정을 엽니다.

2. 상시 지시사항 섹션으로 이동합니다.

3. 전역 지시사항을 입력합니다 (예: "항상 공식적인 한국어로 응답하세요", "코드 작업에는 JavaScript보다 Python을 선호하세요").

폴더별 지시사항¶

특정 폴더가 활성화된 경우에만 적용되는 상시 지시사항을 설정할 수도 있습니다:

1. 폴더 섹션에서 허용된 폴더 옆의 설정 아이콘을 클릭합니다.

2. 폴더별 지시사항을 입력합니다 (예: "이 프로젝트는 TypeScript와 Zustand를 사용하는 React 프로젝트입니다", "CONTRIBUTING.md의 코딩 규칙을 따르세요").

폴더별 지시사항은 전역 지시사항과 결합되어 시스템 프롬프트에 함께 주입됩니다.

작업 중 조종¶

Cowork 작업이 실행 중일 때, 작업을 중단하고 재시작하지 않고도 실시간으로 에이전트의 동작을 안내할 수 있습니다.

조종 방법¶

1. 작업이 진행 중일 때, 작업 타임라인 아래의 조종 입력 필드에 안내 내용을 입력합니다.

2. Enter를 눌러 조종 메시지를 전송합니다.

3. 에이전트가 다음 추론 단계에서 안내 내용을 반영합니다.

조종 메시지는 최대 10,000자까지 입력할 수 있으며, 다음과 같은 경우에 유용합니다:

• 에이전트의 접근 방식 수정 ("프론트엔드가 아닌 백엔드 파일에 집중하세요")
• 추가 컨텍스트 제공 ("데이터베이스는 MySQL이 아닌 PostgreSQL을 사용합니다")
• 우선순위 조정 ("지금은 단위 테스트를 건너뛰고 메인 구현에 집중하세요")

서브 에이전트 조율¶

복잡한 작업의 경우, Cowork는 작업의 여러 부분을 병렬로 처리하는 서브 에이전트를 생성할 수 있습니다.

서브 에이전트 작동 방식¶

• 메인 에이전트가 작업을 분석하고 유익할 때 하위 작업으로 분할합니다.
• 각 서브 에이전트는 자체 도구 접근 권한과 추론 체인으로 독립적으로 실행됩니다.
• 서브 에이전트의 결과는 메인 에이전트가 수집하고 종합합니다.

서브 에이전트 설정¶

• 최대 동시 실행 수: Cowork 설정에서 동시에 실행할 수 있는 서브 에이전트의 최대 수를 설정합니다. 값이 높을수록 더 많은 병렬 처리가 가능하지만 리소스 소모가 증가합니다.

서브 에이전트 추적기¶

Cowork UI에는 다음을 보여주는 추적기가 포함되어 있습니다:

• 활성 서브 에이전트와 현재 상태
• 각 서브 에이전트가 작업 중인 내용
• 개별 하위 작업의 진행률
• 완료된 결과

상태 표시기 이해하기¶

Cowork 인터페이스에는 현재 상태를 보여주는 눈에 띄는 상태 배지가 표시됩니다:

진행률 추적¶

상태 배지 아래에는 시각적 진행률 표시줄이 표시됩니다:

• 완료된 단계: 표시줄의 채워진 부분
• 현재 단계 설명: 에이전트가 현재 수행 중인 작업
• 단계 수: "단계 X / Y" 형식