전체 문서
Getting Started
CICDoo란 시작하기: 온보딩 마법사 대시보드와 인프라 맵Concepts
프로덕션, 스테이징, 개발 스테이지 도메인, 서브도메인, SSL Odoo 버전과 에디션 (Community와 Enterprise) 워크스페이스와 팀 협업Servers
서버 추가하기 서버 도메인과 DNS 로드 밸런서 사용하기 서버 작업: 배포, 로그, 차트Projects & Git
프로젝트 만들기 GitHub 연결하기 GitLab 연결하기 브랜치와 인스턴스Instances & Console
인스턴스 만들기 인스턴스 재시작, 중지, 삭제 스테이지 간 브랜치 병합 웹 IDE와 원격 접속 인스턴스 설정 설명 배포와 작업 큐Agent Tasks
에이전트 작업이란 에이전트 작업 설정하기 작업 실행과 결과 검토 에이전트 시간과 추가 구매Monitoring & Backups
인스턴스 모니터링 백업과 복원 경고 알림 (이메일과 SMS)Workspaces & Permissions
워크스페이스 멤버 초대하기 멤버 권한과 리소스 접근 멤버가 리소스를 보거나 사용할 수 없습니다Account & Security
2단계 인증 (2FA) 프로필과 연동 설정 비밀번호와 계정 복구Billing & Plans
요금제와 가격 업그레이드와 구독 관리 프로젝트 구독이 미납된 경우 채널 파트너 프로그램Support & Tickets
지원 티켓 열기 CICDoo 팀에 도움 요청하기Troubleshooting
문제 해결: 서버를 연결할 수 없습니다 문제 해결: 배포가 실패했습니다 문제 해결: 저장소를 옮긴 뒤 git push가 403으로 실패합니다 문제 해결: 인스턴스가 중단되거나 느립니다 문제 해결: 도메인 또는 SSL 문제Agent Tasks
작업 실행과 결과 검토
에이전트 작업을 만들고, 계획을 읽고 승인하고, git에 무엇이 남는지, 결과를 다시 돌려보내는 방법, 실행이 실패하거나 제공업체 한도에 걸렸을 때 벌어지는 일.
작업 만들기
프로젝트의 작업 페이지나 인스턴스 콘솔의 작업 탭을 열고 작업을 하나 만드세요. 다음을 입력합니다:
- 제목과 설명. 무엇을 바꿔야 하는지 평범한 말로 씁니다. 자세할수록 좋습니다. 같은 요청이라도 맥락을 두 문장 덧붙이면 훨씬 나은 계획이 나옵니다.
- 작업할 인스턴스. 에이전트가 어떤 코드베이스를 읽고 결과를 어느 브랜치에 푸시할지가 여기서 정해집니다.
- 스킬과 첨부 파일 (선택). 스킬은 우리 팀의 관례이고, 첨부 파일은 명세서나 문제 화면 캡처처럼 에이전트가 맥락으로 가지고 있어야 할 파일입니다.
작업을 만들려면 에이전트 작업 권한이 필요합니다. 프로젝트 구독이 미납되어 프로젝트가 읽기 전용으로 바뀌었다면, 다른 모든 동작과 마찬가지로 작업 생성도 거부됩니다.
프로덕션 인스턴스를 대상으로 하려면 작업을 만들 때 confirm을 입력해야 하고, 그때부터 그 작업은 프로덕션 작업으로 기록됩니다.
계획 읽기
에이전트가 작업을 집어 들고 코드베이스를 읽은 뒤 계획을 써서 돌려줍니다. 이 시점에는 아직 아무것도 바뀌지 않았습니다.
첫 줄만이 아니라 계획 자체를 읽으세요. 코드가 쓰이기 전에 오해를 잡아낼 유일한 기회이며, 읽는 데 드는 비용은 나중에 잘못된 변경을 되돌리는 비용보다 훨씬 낮습니다.
그다음 선택하세요:
- 승인 후 실행: 에이전트가 계획을 구현합니다.
- 변경 요청: 무엇이 잘못되었는지 설명하면 여러분의 피드백을 반영해 다시 계획합니다.
- 다시 계획: 계획을 그대로 다시 실행합니다. 첫 시도가 잘못된 것이 아니라 실패했을 때 유용합니다. 안내와 함께 다시 계획은 여러분의 메모를 덧붙여 같은 일을 합니다.
- 작업 취소: 작업을 중단합니다.
승인하려면 계획 승인 권한이 필요합니다.
에이전트가 계획을 차단됨으로 보고할 때도 있습니다. 작업을 안전하게 처리할 수 없다고 판단했거나 요청이 충분히 분명하지 않다는 뜻입니다. 차단된 계획은 자동 실행이 켜진 프로젝트에서도 언제나 사람을 기다립니다.
git에 남는 것
승인하고 나면 에이전트가 인스턴스의 컨테이너 안에서 변경을 만들고, 커밋한 뒤, 그 인스턴스의 브랜치에 푸시합니다. 그 푸시가 인스턴스를 다시 배포하므로, 결과가 실행되는 곳에서 직접 확인할 수 있습니다.
풀 리퀘스트는 없습니다. 커밋은 인스턴스가 배포되는 브랜치에 바로 올라갑니다. 그래서 어떤 인스턴스를 고르는지가 중요하고, 프로덕션은 두 번의 확인 뒤에 가려져 있습니다.
바꿀 것이 없는 채로 실행이 끝나면, 커밋을 지어내는 대신 그렇다고 알려 줍니다.
결과가 맞지 않을 때
작업에서 다음 라운드 시작을 사용하세요. 무엇이 잘못되었는지 설명하면 에이전트가 처음부터 다시 시작하지 않고 이미 푸시한 코드 위에서 이어 가며 수정을 계획합니다. 무언가 실행되기 전에 새 계획을 여러분이 승인하고, 기존 커밋은 브랜치에 그대로 남습니다.
라운드는 작업에 기록되므로, 한 건의 작업이 몇 번을 거쳤고 각 라운드가 무엇을 바꿨는지 볼 수 있습니다.
문제가 생겼을 때
- 실행이 커밋한 내용으로 인스턴스가 시작되지 않는 경우. CICDoo가 그 커밋들을 구조 브랜치로 옮기고, 인스턴스의 브랜치를 되돌린 뒤, Odoo를 다시 띄웁니다. 아무것도 푸시되지 않고 아무것도 사라지지 않습니다. 원한다면 구조 브랜치에 그 작업이 남아 있습니다.
- 푸시가 실패하는 경우. 작업 내용은 사라지지 않고 컨테이너의 작업 트리에 남습니다.
- 실행이 제공업체의 사용량 한도에 걸리는 경우. 작업이 일시 중지되고 한도가 언제 초기화되는지 알려 줍니다. 이어서 진행을 누르면 승인된 계획을 그 지점부터 계속합니다. 새 라운드가 아니라 중단되었던 같은 라운드입니다.
- 실행이 보고를 멈추는 경우. 컨테이너가 작업 도중 죽으면 작업이 무한정 매달려 있지 않고 실패로 표시됩니다. 그 뒤에 에이전트가 늦게 보고해 오더라도 결과는 여전히 반영됩니다.
사용량 지켜보기
작업의 사용량 탭에는 그 작업의 모든 실행이 나열됩니다: 어떤 라운드와 단계였는지, 누가 시작했는지, 결과, 입력과 출력 토큰, 걸린 시간입니다. /agent 페이지는 이 내용을 프로젝트 전체에 걸쳐 모아, 최근 30일, 90일, 12개월 차트로 보여 줍니다.
재시도와 실패도 함께 집계됩니다. 이는 의도된 것입니다. 실제로 에이전트 시간을 쓰기 때문이며, 네 번 시도한 작업은 네 번 시도한 것처럼 보여야 합니다.
다음 단계
그 시간이 어떻게 측정되고 청구되는지는 에이전트 시간과 추가 구매를 참고하세요. 기능을 켜고 CLI를 연결하는 방법은 에이전트 작업 설정하기를 참고하세요.
문제가 해결되지 않으면 티켓 페이지나 채팅 위젯에서 지원 티켓을 열어 주세요.
여전히 해결되지 않나요? 앱에서 티켓을 열거나 엔지니어와 상담하세요.