# 에이전트

## 에이전트란 무엇인가?

에이전트는 문제를 추론하고, 작업을 실행하고, 여러 플랫폼에 걸쳐 통신하는 격리된 AI 어시스턴트입니다. 각 에이전트는 자체 워크스페이스, 세션 기록, 모델 구성, 채널 바인딩을 갖습니다.

## 에이전트 격리

모든 에이전트에는 다음이 제공됩니다:

- **워크스페이스**, 파일, 메모, 에이전트별 데이터를 위한 전용 디렉토리
- **세션**, 독립적인 대화 기록 및 전사
- **구성**, 모델 선택, 도구 권한, 지출 한도
- **정체성**, 에이전트의 `AGENTS.md` 파일에 정의된 고유한 페르소나
- **인증 프로필**, 에이전트별 API 키 및 인증 구성

## 에이전트 페르소나

각 에이전트의 워크스페이스에는 개성, 지시, 행동 지침을 정의하는 `AGENTS.md` 파일이 포함됩니다. 이 지속적인 시스템 프롬프트는 에이전트가 응답하는 방식, 어조, 도메인 전문 지식, 형식, 도구 사용, 안전 정책, 을 형성합니다.

## 다중 에이전트 라우팅

여러 에이전트를 실행할 때 수신 메시지는 **바인딩**에 따라 자동으로 라우팅됩니다:

- **채널 바인딩**, 플랫폼의 모든 메시지를 라우팅합니다 (예: 모든 Telegram → `personal` 에이전트)
- **서버/워크스페이스 바인딩**, 특정 Discord 서버 또는 Slack 워크스페이스를 전용 에이전트로 라우팅합니다
- **채팅 유형 바인딩**, 개인 메시지를 하나의 에이전트로, 그룹 메시지를 다른 에이전트로 라우팅합니다
- **연락처/피어 바인딩**, 특정 연락처의 메시지를 특정 에이전트로 라우팅합니다

바인딩은 우선순위 순서로 평가됩니다. 첫 번째 일치가 우선합니다. 일치하지 않는 메시지는 기본 에이전트로 이동합니다.

## 서브에이전트 및 위임

에이전트는 특화된 작업을 위해 서브에이전트를 생성할 수 있습니다:

- **작업 위임**, 복잡한 작업을 분해하고 부분을 특화된 서브에이전트에 위임합니다
- **격리된 실행**, 서브에이전트는 자체 세션 컨텍스트에서 실행됩니다
- **핑퐁 대화**, 에이전트는 협력하기 위해 서로 (최대 5차례) 주고받는 교환을 할 수 있습니다
- **결과 공지**, 서브에이전트 결과는 원래 채널에 다시 게시될 수 있습니다

## 팀 및 오케스트레이션

다중 에이전트 팀은 조율된 워크플로를 가능하게 합니다:

- **병렬 실행**, 작업의 다른 측면에 대해 여러 에이전트를 동시에 실행합니다
- **순차 파이프라인**, 각 에이전트가 이전 출력을 기반으로 하는 에이전트를 연결합니다
- **하이브리드 모드**, 병렬 및 순차 실행을 결합합니다
- **작업 추적**, 각 에이전트 작업의 상태를 모니터링합니다 (대기 중, 실행 중, 완료, 오류, 취소됨)

## 도구 프로필

각 에이전트가 할 수 있는 것을 제어합니다:

| 프로필 | 사용 가능한 도구 |
|---------|----------------|
| **minimal** | 세션 상태만 |
| **coding** | 파일 I/O, 실행, 세션, 메모리, 이미지 |
| **messaging** | 메시지 전송, 세션 기록 |
| **full** | 모든 도구 (기본값) |

에이전트별, 모델 제공업체별로 커스텀 허용/거부 목록을 설정할 수 있습니다.

## 안전 모드

안전 모드는 실행 샌드박스를 제공합니다:

- **마스터 토글**, 전체적으로 활성화하거나 비활성화합니다
- **에이전트별 제어**, 신뢰할 수 있는 에이전트에 대해 비활성화하고 다른 에이전트에 대해 유지합니다
- **실행 승인**, 민감한 작업은 명시적인 사용자 승인이 필요합니다
- **정책 동기화**, 설정이 모든 연결된 클라이언트에서 실시간으로 동기화됩니다

## 에이전트 메모리

각 에이전트는 메모리 시스템에 접근할 수 있습니다:

- **MEMORY.md**, 세션 간 중요한 정보 및 메모를 위한 지속적인 파일
- **메모리 파일**, `memory/`에 있는 추가 구조화된 지식
- **벡터 검색**, 자연어 쿼리를 사용하여 메모리를 검색합니다

자세한 내용은 [세션 및 메모리](sessions-memory.md)를 참조하세요.