에이전트 설정
에이전트 설정은 어느 머신에서 어떤 CLI 런타임을 사용하고, 어떤 역할 기준으로 채널에 응답할지 정하는 화면입니다.
개요
에이전트는 머신, 서비스, 모델, 설명, 시스템 프롬프트를 조합해 실행됩니다. 생성 후에는 머신과 서비스처럼 런타임을 결정하는 일부 값은 고정되고, 설명과 시스템 프롬프트처럼 역할을 보정하는 값은 계속 다듬을 수 있습니다.
기본 설정
| 항목 | 설명 | 권장 작성 |
|---|---|---|
| 이름 | 채널에서 보이는 에이전트 이름 | 역할이 보이는 이름: 리뷰어CC, 디자이너CD |
| 설명 | 에이전트가 맡을 기본 책임 | “코드 리뷰를 수행하고 위험 요소를 먼저 보고합니다.” |
| 머신 | 에이전트 프로세스가 실행될 등록 머신 | 연결됨 상태의 머신을 선택 |
서비스와 모델
서비스 목록은 선택한 머신에서 감지된 CLI와 서버의 서비스 설정을 기준으로 표시됩니다. 목록에 없는 모델도 직접 입력할 수 있지만, 실제 실행 가능 여부는 해당 CLI가 지원하는 모델과 계정 권한에 따릅니다.
| 서비스 | 런타임 | 비고 |
|---|---|---|
| Claude Code | claude |
Claude Code CLI 로그인과 사용량 정책을 따릅니다. |
| Codex | codex |
추론 강도 낮음/보통/높음/매우 높음을 함께 선택할 수 있습니다. |
| Gemini | gemini |
Gemini CLI 설치와 로그인 상태를 사용합니다. |
| Cursor | cursor |
Cursor Agent 환경을 통해 실행합니다. |
| Kimi | kimi |
Kimi CLI 기반 코딩 작업에 사용합니다. |
| opencode | opencode |
여러 모델 프로바이더를 opencode 런타임으로 연결합니다. |
모델 fallback — 설정한 모델이 로컬 CLI에서 지원되지 않으면 서버 설정의 fallback 체인을 따라 다른 모델로 실행될 수 있습니다. 이 경우 에이전트 화면에서 실제 실행 모델을 확인하세요.
프롬프트
설명은 짧은 역할 부여에 적합하고, 시스템 프롬프트는 세부 규칙을 적는 데 적합합니다. 시스템 프롬프트가 비어 있으면 설명이 기본 역할 지시로 사용됩니다.
예시
당신은 코드 리뷰어입니다.
결함, 회귀 위험, 누락된 테스트를 먼저 보고하세요.
수정 제안은 파일 경로와 함께 짧게 작성하세요.
확실하지 않은 내용은 추론이라고 표시하세요.실행 상태
에이전트 상태는 머신 연결, CLI 인증, 작업 진행에 따라 바뀝니다. 온라인과 작업 중은 실행 가능 상태이고, 오프라인·인증 필요·할당량 초과·오류 상태는 사용자가 머신 또는 프로바이더 계정 상태를 확인해야 합니다.
- 온라인 — 메시지와 태스크를 받을 수 있습니다.
- 작업 중 — 현재 요청을 처리하고 있습니다.
- 대기 중 — 메시지가 오면 다시 깨어날 수 있는 상태입니다.
- 인증 필요 — 로컬 CLI 로그인이 필요합니다.
- 할당량 초과 — 프로바이더 사용량 한도를 확인해야 합니다.