Git 통합
AI Agent용 안내: 이 페이지의 Markdown 버전은 https://ankole.agentbull.com/ko-KR/docs/git-integration/index.md, 전체 문서 색인은 https://ankole.agentbull.com/ko-KR/llms.txt에 있습니다.
Ankole Agent는 전용 Worker가 제공하는 표준 셸과 파일 도구로 영구 /workspace 디렉터리 안의 git 저장소를 다룹니다. 일반 대화와 Background Agent Job 모두에서 동일한 도구를 사용할 수 있으며, Worker 인스턴스나 이미지를 교체하더라도 /workspace의 저장소는 그대로 유지됩니다.
Agent가 git으로 할 수 있는 일
Agent는 command 도구를 사용해 Worker의 사용자 계정으로 git 명령을 실행합니다.
git clone https://github.com/your-org/your-repo.git
git checkout -b feature/agent-fix
git add -A && git commit -m "Fix: resolve the null-pointer case"
git push origin feature/agent-fix
워크스페이스(/workspace/jobs/<job-id>/ 또는 sessions/<id>/ 하위)에 저장소를 clone한 뒤 파일 편집 및 패치 도구로 코드를 수정하고, 커밋과 push까지 수행할 수 있습니다. 이 모든 과정은 셸을 통해 Worker의 사용자 권한으로 실행됩니다.
일반 대화에서는 포그라운드 셸과 파일 도구를 바로 사용합니다. 반면 작업을 Background Agent Job에 위임하면 해당 Job이 독립된 워크스페이스에서 작업을 수행한 뒤 결과를 반환하거나 조용히 종료합니다. 자세한 위임 흐름은 Background Agent Jobs를 참조하세요.
필요한 것
- Git 자격 증명. GitHub(Cloud 또는 Enterprise) 저장소는 Pod → Connections(
Ankole.Connectors)에서 GitHub App 설치 또는 개인 OAuth 계정을 연결하는 방식을 권장합니다. Ankole가 턴 범위의GIT_ASKPASS자격 증명 도우미(POST /api/internal/connectors/git-credentials)를 자동 주입하므로WorkerEnv에 정적 토큰을 저장하지 않아도 HTTPS로git clone,git fetch,git push인증이 처리됩니다. 그 밖의 Git 호스트를 사용할 때는 Console → Environment variables에서 SSH 키나 PAT를GIT_SSH_KEY,GIT_TOKEN같은 암호화 변수로 저장하세요(Environment variables 참조). - Worker에서 접근 가능한 저장소. Worker에서 git 호스트로 네트워크 연결이 가능해야 하므로, 사설 네트워크 환경이라면 Worker가 대상 git 서버에 접근할 수 있는지 확인하세요. Docker Compose 배포에서는 Worker 컨테이너가
ankole_workers네트워크에 연결되어 control plane, 인터넷, 공개 git 호스트와 통신할 수 있습니다. Helm 차트에서networkPolicy.enabled를 켜면 Worker Pod는 control plane, DNS, 공개 주소로 나갈 수 있지만, 사설 대역이networkPolicy.workerDeniedCIDRs에 포함되어 있으면 해당 대역의 git 서버에는 연결할 수 없습니다. - 모델 프로필(선택적 재정의). Agent는 별도로 재정의하지 않으면 사이트 및 Pod 모델 프로필을 상속하며, Background Agent Job은 기본적으로
heavy를 사용하고 비워 두면primary로 폴백합니다. Background Agent Job에 전용 Provider나 모델을 지정해야 할 때만heavy프로필을 구성하세요.
워크스페이스
Git 저장소는 세션별 또는 Job별 워크스페이스 아래에 clone됩니다.
/workspace/
└── jobs/<job-id>/
└── your-repo/ # cloned here
├── .git/
└── ... # the working tree
/workspace 안의 저장소는 Worker가 교체되거나 이미지가 바뀌어도 유지되지만, 스토리지 유실에 대비해 원격 저장소에 push하거나 별도 백업을 두는 것이 안전합니다. 빌드 결과물이나 전달 파일을 /workspace 밖으로 공유할 때는 /drive(예: /drive/ChatDrive 또는 /drive/Public, FUSE를 마운트하지 않는 Worker에서는 폴백인 ankole-files put)에 직접 기록합니다(파일 관리 참조).
작업 예시
PR을 리뷰하는 코딩 Agent를 설정하는 절차는 다음과 같습니다.
- Pod → Connections에서 GitHub App 또는 개인 OAuth 계정을 연결합니다(GitHub 외 호스트라면 Console → Environment variables에 암호화된 SSH 키나 PAT를 저장합니다).
- Agent를 생성합니다. 사이트와 Pod 기본 모델 프로필이 자동으로 상속되므로 대화 턴이나 Background Agent Job에 다른 모델을 쓰고 싶을 때만 개별 재정의 또는
heavy프로필을 지정합니다. - Meta Ankole → Agents에서 해당 Agent의
AGENTS.md규약에 대상 저장소, 리뷰 기준, 브랜치 명명 규칙을 작성합니다. - 채널에서 Agent에게 “Review the latest PR on
your-repo. Clone, check out, run the tests, report what you find.“라고 요청합니다. - 요청을 받은 Agent는 저장소를 clone해 브랜치를 checkout하고
command도구로 테스트를 실행한 뒤 결과를 보고합니다. 이 작업은 대화 중 직접 처리할 수도 있고 Background Agent Job에 위임할 수도 있습니다.
이 가이드가 아닌 것
이 문서는 git 명령어 사용법을 다루는 튜토리얼이 아니며, Agent는 표준 git 명령을 그대로 사용합니다. 또한 Ankole 자체에 CI/CD 실행 기능이 내장되어 있는 것은 아니지만, 저장소의 CI를 명령줄로 호출할 수 있다면 Agent가 셸 명령으로 CI를 트리거할 수는 있습니다. 별도의 코드 리뷰 전용 자동화 엔진을 설명하는 문서도 아니며, Agent는 페르소나 문서에 정의된 기준에 따라 일반 셸 도구로 코드를 검토합니다.
다음 단계
- 셸 도구 사용법은 Code execution을 참조하세요.
- 백그라운드 실행 구조는 Background Agent Jobs를 참조하세요.
- Git 자격 증명 관리는 Environment variables를 참조하세요.
- Agent 드라이브 사용법은 File management를 참조하세요.