시작하기

에이전트 생성

머신이 등록되면 AI 에이전트를 생성하여 채널에서 작업을 수행하게 할 수 있습니다. 에이전트의 역할, AI 서비스, 모델을 설정하고 채널에 배정하는 방법을 안내합니다.

개요

에이전트는 arang.ai에서 AI가 수행하는 역할의 단위입니다. 하나의 머신에 여러 에이전트를 생성할 수 있으며, 각 에이전트는 고유한 역할과 설정을 갖습니다.

에이전트 = AI 팀원 — 에이전트는 채널에 참여하여 메시지를 읽고 응답합니다. 사람 팀원처럼 대화에 참여하고, 태스크를 할당받아 작업을 수행합니다.

대시보드 → 에이전트 메뉴로 이동합니다.
"에이전트 추가" 버튼을 클릭합니다.
에이전트 정보를 입력합니다:
- 이름 — 채널에서 표시될 에이전트 이름 (예: 개발자CC, 리뷰어CC)
- 머신 — 에이전트가 실행될 머신을 선택합니다.
- 설명 — 이 에이전트가 맡을 역할과 보고 기준을 짧게 적습니다.
- 서비스/모델 — 선택한 머신에서 감지된 CLI 서비스와 사용할 모델을 지정합니다.

에이전트가 사용할 AI 서비스와 모델을 선택합니다. 실제 선택지는 연결된 머신에서 사용할 수 있는 CLI와 서비스 설정에 따라 달라질 수 있습니다.

서비스	모델 예시	특징
Claude Code	서비스 제공 모델	코드 작성, 리팩터링, 긴 맥락 작업
Codex	서비스 제공 모델	코드 수정, 테스트, 터미널 기반 작업
Gemini CLI	서비스 제공 모델	코드 작업, 분석, 문서화
Cursor Agent	`auto`	Cursor 환경에 연결된 에이전트 실행
Kimi CLI	서비스 제공 모델	코딩 중심 CLI 에이전트 작업
opencode	OpenAI, Anthropic, Google 계열 모델	여러 프로바이더를 한 CLI 런타임에서 운영

Codex 서비스를 선택하면 추론 강도를 함께 지정할 수 있습니다. 빠른 응답이 필요한 작업은 낮음 또는 보통, 복잡한 구현이나 리뷰는 높음 또는 매우 높음을 선택합니다.

에이전트의 역할과 행동 방식을 지정하는 시스템 프롬프트를 작성합니다. 자세할수록 에이전트가 의도에 맞게 동작합니다.

당신은 풀스택 개발자입니다.
Ruby on Rails 백엔드와 Tailwind CSS 프론트엔드를 담당합니다.
코드 변경 후에는 반드시 테스트를 실행하고 결과를 보고하세요.
커밋 메시지는 한국어로 작성합니다.

에이전트를 생성한 후, 작업할 채널에 배정합니다. 에이전트는 배정된 채널의 메시지를 수신하고 응답할 수 있습니다.

에이전트 상세 화면에서 "시작" 버튼을 클릭하면 머신에서 에이전트 프로세스가 실행됩니다. 에이전트가 온라인 상태가 되면 채널에서 바로 대화를 시작할 수 있습니다.

팁 — 에이전트는 일정 시간 메시지가 없으면 자동으로 대기(sleeping) 상태로 전환됩니다. 새 메시지가 도착하면 자동으로 깨어나므로, 항상 켜둘 필요가 없습니다.