Agent 모드와 설정
학습 목표
- Planning 모드와 Fast 모드의 차이를 이해할 수 있다
- Task Groups가 무엇인지 이해할 수 있다
- Agent 설정을 조정할 수 있다
1. Agent 모드란?
Anti-Gravity의 Agent는 작업 유형에 따라 두 가지 모드로 동작할 수 있습니다.
| 모드 | 특징 | 추천 상황 |
|---|---|---|
| Planning | 계획 수립 후 실행 | 복잡한 작업, 여러 파일 수정 |
| Fast | 바로 실행 | 간단한 작업, 빠른 수정 |
그림 6-1: 새 대화 시작 시 Agent 모드 선택
2. Planning 모드
2.1 Planning 모드란?
Planning 모드에서는 Agent가 작업을 실행하기 전에 먼저 계획을 세웁니다. 복잡한 작업을 체계적으로 처리할 때 유용합니다.
2.2 언제 사용하나요?
- 새로운 기능 개발
- 여러 파일에 걸친 수정
- 리서치가 필요한 작업
- 품질이 중요한 작업
2.3 Planning 모드의 특징
- Task Groups 생성: 작업을 작은 단위로 분할
- Artifacts 생성: 구현 계획, 워크스루 등 산출물 생성
- 체계적 실행: 단계별로 작업 진행
💡 팁
Planning 모드는 기본값입니다. 복잡한 작업에서는 Agent가 자동으로 계획을 세우고 진행합니다.
3. Fast 모드
3.1 Fast 모드란?
Fast 모드에서는 Agent가 계획 단계 없이 바로 작업을 실행합니다. 간단하고 명확한 작업에 적합합니다.
3.2 언제 사용하나요?
- 변수명 변경
- 간단한 터미널 명령어 실행
- 작은 버그 수정
- 빠른 피드백이 필요할 때
3.3 Fast 모드 선택하기
새 대화를 시작할 때 모드를 선택할 수 있습니다.
- Agent Side Panel에서 새 대화 시작
- 모드 선택 옵션 확인
- Fast 또는 Planning 선택
4. Task Groups 이해하기
4.1 Task Groups란?
Planning 모드에서 Agent가 복잡한 작업을 처리할 때, 작업을 Task Groups라는 작은 단위로 나눕니다.
전체 작업: "사용자 인증 기능 추가"
↓
Task Group 1: 로그인 폼 HTML 작성
Task Group 2: 스타일 추가
Task Group 3: JavaScript 기능 구현
Task Group 4: 테스트
4.2 Task Group 구성
각 Task Group에는 다음 정보가 포함됩니다.
| 구성 요소 | 설명 |
|---|---|
| 목표 | 이 Task Group이 달성하려는 것 |
| 수정된 파일 | 변경된 파일 목록 (클릭하여 확인) |
| 하위 작업 | 세부 단계들 (확장하여 상세 확인) |
| 대기 중 항목 | 승인이 필요한 작업 |
그림 6-2: Task Group 화면
4.3 Task Group 상세 보기
- Task Group 클릭
- 수정된 파일 목록에서 파일 선택
- 변경 내용 확인
- 필요시 하위 작업 펼치기
💡 팁
Task Group의 하위 작업은 기본적으로 접혀 있습니다. 상세 과정이 궁금하면 펼쳐서 확인할 수 있습니다.
5. Agent 설정
Settings에서 Agent의 동작 방식을 조정할 수 있습니다.
5.1 설정 열기
- 상단 메뉴에서 Settings 클릭 OR 좌측 사이드 패널 하단 Settings 클릭
- "Agent" 탭 선택
그림 6-3: Agent 설정 화면
5.2 주요 설정 옵션
1. Artifact Review Policy
Agent가 Artifacts(구현 계획, 워크스루 등)를 생성할 때 검토를 요청하는 방식을 설정합니다.
| 옵션 | 설명 |
|---|---|
| Always Proceed | Agent가 검토를 요청하지 않음. 자율성이 높지만 위험도 있음 |
| Request Review | Agent가 항상 검토를 요청 |
💡 초심자 추천
처음에는 "Request Review"를 권장합니다. Agent의 계획을 검토하고 이해하는 데 도움이 됩니다.
2. Terminal Command Auto Execution
Agent가 터미널 명령어를 실행하기 전 확인을 요청하는 방식을 설정합니다.
| 옵션 | 설명 |
|---|---|
| Always Proceed | 확인 없이 바로 실행 (Deny 목록 제외). 장시간 자율 작업에 유리하지만 위험도 있음 |
| Request Review | 항상 확인 요청 (Allow 목록 제외) |
📌 참고
이 설정 변경은 새로운 메시지에만 적용됩니다. 진행 중인 응답은 이전 설정값을 사용합니다.
3. Agent Non-Workspace File Access
Agent가 현재 워크스페이스 외부 파일을 보고 편집할 수 있도록 허용합니다.
- 기본값: 비활성화 (워크스페이스 내부만 접근)
- 활성화 시: 워크스페이스 외부 파일도 접근 가능
⚠️ 주의
이 옵션을 활성화하면 Agent가 추가적인 관련 정보에 접근할 수 있지만, 자격 증명 파일, 비밀 정보 등 워크스페이스 외부의 민감한 파일에도 접근할 수 있습니다.
6. 여러 대화 관리하기
Anti-Gravity에서는 여러 Agent 대화를 동시에 진행할 수 있습니다.
6.1 새 대화 시작
- Side Panel에서 "+ Start conversation" 버튼 클릭
- 이전 대화는 유지됨
그림 6-4: Agent Side Panel에서 새 대화 시작
6.2 대화 전환
- Agent Manager에서 대화 목록 확인
- 원하는 대화 클릭하여 전환
7. 실습: 모드별 작업 비교
7.1 실습 1: Fast 모드로 간단한 작업
- 새 대화 시작 (Fast 모드 선택)
- 다음 요청 사항 입력
hello.py 파일을 만들고 "Hello, World!"를 출력하는 코드를 작성해주세요.
- Agent가 바로 파일 생성
그림 6-5: Fast 모드에서 빠르게 파일 생성
- Run command? → Accept 버튼을 클릭하면 결과를 확인할 수 있습니다.
7.2 실습 2: Planning 모드로 복잡한 작업
- 새 대화 시작 (Planning 모드 선택)
- 다음 요청 사항 입력
간단한 계산기 웹 페이지를 만들어주세요.
HTML, CSS, JavaScript 파일로 분리해서 만들어주세요.
- Agent가 Task Groups를 생성하면 Proceed(진행) 버튼을 클릭하여 실행합니다.
그림 6-6: Planning 모드에서 Task Groups 생성
7.3 차이점 관찰
| 항목 | Fast 모드 | Planning 모드 |
|---|---|---|
| 속도 | 빠름 | 상대적으로 느림 |
| 계획 | 없음 | Task Groups 생성 |
| 적합한 작업 | 간단한 작업 | 복잡한 작업 |
8. 다음 단계
Agent 모드와 설정을 이해했다면, 실제로 Agent와 함께 프로젝트를 만들어봅시다.
Agent 실습 프로젝트에서 Agent와 대화하며 웹 페이지를 만드는 방법을 배울 수 있습니다.