> ## Documentation Index
> Fetch the complete documentation index at: https://help.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 데이터베이스

할 일을 쓰고 승인하면 내 컴퓨터에서 도는 에이전트가 코드를 고치고 결과를 PR 이나 머지로 남겨요. 이 문서에서는 처음 설정하는 법과 할 일 하나가 처음부터 끝까지 처리되는 과정을 다뤄요.

## 시작하기

### 에이전트 데이터베이스 만들기

사이드바의 **문서** 탭에서 스페이스 이름 위에 마우스를 올리고 ＋ 를 누른 뒤 **새 데이터베이스** 를 고르세요. 스페이스가 비어 있으면 스페이스 바로 아래의 **새 데이터베이스** 를 누르세요.

에이전트 데이터베이스는 스페이스 관리자(팀 소유자나 스페이스 소유자)만 만들 수 있어요.

1. **에이전트 데이터베이스** 를 고르세요.
2. 스페이스에 아직 GitHub 레포지토리가 없으면 **GitHub 연결하기** 에서 레포지토리를 고르세요. 이미 레포지토리가 있으면 이 단계는 건너뛰고 모든 레포지토리가 에이전트에 지정돼요.
3. **에이전트에게 어디까지 맡길까요?** 에서 승인 방식을 고르고 **만들기** 를 누르세요.

**에이전트 할 일** 이라는 데이터베이스가 만들어지고, 나에게 맡겨진 예시 할 일 세 개, **에이전트 지침** 문서, 할 일 템플릿 세 개가 함께 생겨요. 첫 번째 예시(우선순위 높음)는 이미 **승인됨** 상태이고, 나머지 두 개는 **승인 대기** 상태예요.

### 에이전트 켜기

에이전트를 쓰는 사람은 각자 자기 컴퓨터에서 자기 에이전트를 한 번 켜요. 데이터베이스 맨 위에 **에이전트 지침** 단추, 설정 단추, **내 에이전트** 가 있어요.

![에이전트 데이터베이스 맨 위의 내 에이전트. 이 기기의 스위치가 꺼져 있어요](https://mintcdn.com/bottari-help/o1rPaomCoB7ZyaSB/images/ko/09-my-agent-switch.png?fit=max\&auto=format\&n=o1rPaomCoB7ZyaSB\&q=85\&s=b196c6382407e676032e0b7f3bd26b67)

1. **내 에이전트** 의 스위치(**에이전트 켜기**)를 켜세요.
2. 처음 켤 때 레포지토리가 아직 이 컴퓨터에 없으면 내려받을 위치를 고르세요(**레포지토리를 어디에 내려받을까요?** › **폴더 고르기…**). 한 번만 고르면 되고, 설정에서 바꿀 수 있어요.
3. 폴더를 신뢰할지 물으면 **신뢰하고 시작** 를 누르세요. 터미널의 Claude Code 에서 이미 그 폴더를 신뢰했다면 에이전트 지침의 확인 명령만 물어봐요.

그다음부터는 레포지토리를 내려받고 레포지토리마다 확인 방법을 살피는 일이 알아서 진행돼요. 몇 분 걸릴 수 있어요. Claude Code 나 GitHub 에 로그인되어 있지 않으면 같은 자리에 안내와 해결 단추(예: **Claude 연결하고 켜기**)가 나타나요.

## 에이전트에게 할 일 맡기기

먼저 써 보려면 이미 **승인됨** 상태인 예시를 지켜보세요. 에이전트가 그 할 일을 가져가 결과를 PR 로 남겨요. 예시는 늘 PR 로 남고, 머지할지는 사람이 정해요.

### 할 일 쓰기

새 할 일을 만들고 본문에 무엇을 바꿔야 하는지 적으세요. 자유롭게 써도 돼요. 빠짐없이 적으려면 템플릿 **아이디어**, **버그 리포트**, **기능 요청** 가운데 하나를 고를 수 있어요. **버그 리포트** 는 증상, 재현 단계, 기대 결과, 스크린샷을 물어요.

보따리 세션에서 "이 버그로 할 일 써 줘"처럼 부탁할 수도 있어요. Claude 가 보따리 도구로 대화 내용을 바탕으로 할 일을 써요.

### 담당자 정하기

할 일의 **담당자** 를 정하세요. 담당자 컴퓨터의 에이전트가 그 할 일을 처리해요.

### 할 일 승인하기

새 할 일은 **승인 대기** 상태로 시작해요. 내용을 확인하고 **단계** 를 **승인됨** 로 바꾸세요. 그러면 에이전트가 가져갈 수 있어요. 승인은 담당자나 데이터베이스 전체 권한이 있는 사람이 했을 때만 인정돼요.

### 에이전트 작업 지켜보기

에이전트는 승인된 할 일을 에이전트 설정에서 정한 순서(**우선순위 순 (높음 → 낮음)**, **먼저 만든 순**, **마감이 가까운 순**)대로 하나씩 가져가요. 이미 진행 중인 할 일을 먼저 끝내요.

사이드바에 내 에이전트의 세션(“🤖 기기 이름 · 데이터베이스 이름”)이 나타나고, 그 아래에 할 일마다 세션이 하나씩 생겨요. 할 일 세션을 열면 에이전트가 계획하고 고치고 확인하는 과정을 따라갈 수 있어요.

이 세션들은 에이전트가 도는 기기에 머물러서 다른 사람이나 다른 기기에 넘길 수 없어요. 세션 맨 위의 사람을 누르면 **담당자** 카드를 볼 수 있어요.

승인된 할 일 가운데 급한 것을 바로 시작하려면 내 에이전트의 세션에 "T-12 먼저 해 줘"라고 쓰세요.

### 질문에 답하기

에이전트가 결정이 필요하면 세션에서 묻고, 사이드바의 할 일 세션에 **질문 중** 가 표시돼요. 입력창 위의 선택지를 고르거나 직접 답을 쓰면(**또는 직접 입력해서 답하기**) 작업이 이어져요.

답하지 않은 질문은 데이터베이스의 **답 대기** 보기에도 모여요.

### 결과 확인하기

에이전트는 레포지토리마다 정해진 확인(테스트 등)을 돌려요. **위험한 변경만 PR** 나 **항상 머지** 에서는 확인을 통과한 일반 변경을 PR 로 열어 머지하고 세션에 보여 줘요. **항상 PR만** 에서는 PR 로 남아요. PR 을 누르면 GitHub 에서 변경 내용을 볼 수 있어요. 원인, 수정 내용, 확인, 답변, PR 기록은 할 일 문서 끝에도 덧붙여져요.

변경이 위험하거나 에이전트 지침에 그 레포지토리의 확인 방법이 없으면, 머지 전에 **답 대기** 에 검토 카드가 나타나요. **머지** 는 머지 전 확인을 돌린 뒤 머지해요. **PR만 남기기** 는 할 일을 **검토 대기** 상태로 두고, GitHub 에서 PR 이 머지되면 **완료** 으로 바뀌어요.

## 에이전트 설정

데이터베이스 맨 위의 **에이전트 지침** 옆 설정 단추로 여세요. 설정은 이 데이터베이스의 모든 에이전트에 적용돼요. 스페이스 관리자와 데이터베이스 전체 권한이 있는 사람만 바꿀 수 있어요.

| 항목 | 설명 |
| - | - |
| 언제 | 에이전트가 가져갈 할 일을 **단계** 로 정해요(기본값은 승인됨). |
| 처리 순서 | **우선순위 순 (높음 → 낮음)**, **먼저 만든 순**, **마감이 가까운 순** 가운데 하나예요. |
| 레포지토리 | 에이전트가 작업할 레포지토리예요. 나중에 스페이스에 추가한 레포지토리는 여기서 켜야 해요. |
| 모델과 노력 수준 | **Opus 5.5** 또는 **Sonnet 5.5**, 노력 수준은 **낮음**, **보통**, **높음**, **최대** 가운데 하나예요. |
| 승인 방식 | 데이터베이스를 만들 때 고르고, 여기서 바꿀 수 있어요. |

### 승인 방식

| 방식 | 에이전트가 하는 일 |
| - | - |
| **위험한 변경만 PR** (추천) | 일반 변경은 머지하고 위험한 변경은 PR 로 남겨요 |
| **항상 PR만** | 언제나 사람이 머지해요 |
| **항상 머지** | CI 를 통과하면 머지해요 |

어떤 방식이든(**항상 머지** 포함) 의존성, 마이그레이션, CI, 설정 파일을 바꾸는 변경과 되돌리기 어렵거나 방향을 크게 바꾸는 변경은 사람의 검토를 기다려요.

## 에이전트 지침

에이전트 지침은 에이전트가 레포지토리마다 따르는 규칙을 적은 문서예요. 데이터베이스 맨 위의 **에이전트 지침** 단추로 여세요. 첫 초안은 데이터베이스를 만든 사람의 컴퓨터가 자동으로 써요. 그렇게 되지 않았다면, 스페이스 관리자나 데이터베이스 전체 권한이 있는 사람의 컴퓨터에서 에이전트가 돌고 Claude Code 가 준비되고 레포지토리를 내려받았을 때 그 컴퓨터가 쓰거나, 그런 사람이 지침에서 **초안 쓰기** 를 누르면 써요. 그전까지 다른 사람에게는 **관리자가 초안을 쓰면 여기 보여요** 가 보여요.

지침은 다른 문서처럼 고칠 수 있어요. 초안이 준비되면 스페이스 관리자와 데이터베이스 전체 권한이 있는 사람은 **지침 업데이트하기** 를 눌러 에이전트에게 고치게 할 수도 있어요.

| 섹션 | 설명 |
| - | - |
| 레포지토리마다 확인하는 방법 | 에이전트가 머지 전에 돌리는 테스트 명령이에요. 비어 있으면 일반 변경도 자동으로 머지하지 않고 검토 카드로 보내요. |
| 조심할 영역 | 사람이 검토해야 하는 경로예요. **위험한 변경만 PR** 에서는 이 경로를 바꾸는 변경을 위험한 변경으로 보고 검토를 기다려요. **항상 머지** 에서는 머지를 막지 않아요. |

## 제한 사항

* 에이전트는 승인되지 않은 할 일을 가져가지 않아요.
* 승인 뒤에 제목이나 본문을 고치면 승인이 풀려요. 에이전트가 아직 시작하지 않았다면 할 일이 **승인 대기** 로 돌아가고 다시 승인해야 해요.
* 내 컴퓨터가 오프라인이면 에이전트는 일하지 않아요. 컴퓨터가 한 시간 넘게 오프라인이면 에이전트가 멈추니, 계속하려면 컴퓨터를 다시 온라인으로 연결하세요.

더 궁금한 점은 [support@bottari.ai](mailto:support@bottari.ai) 로 문의하세요.

<sub>Bottari manual 13 pages (#940)</sub>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.