문서

문제 해결 가이드

문제 증상 확인. 예상과 다른 동작이 발생할 경우 여기서부터 시작하세요.

증상을 찾은 후 링크를 따라가세요.

작업이 시작되지 않음

증상원인으로 추정되는 사항확인할 위치
작업이 다음 상태에서 멈춰 있음:PENDING모든 에이전트 슬롯이 사용 중임처리 용량 및 에이전트 슬롯
전혀 시작되지 않음에이전트 시간 할당량이 소진됨한도 및 할당량
우선순위가 낮은 작업이 실행되지 않음다음 항목으로 인해 대기열이 포화됨:P0작업작업 상태

작업이 실패함

증상원인으로 추정되는 사항확인할 위치
FAILED실행 초기에 발생함깔끔한 작업 공간에서 빌드 또는 테스트 명령이 잘못됨빌드 및 테스트 설정
로컬에서는 테스트가 통과하지만 Coroid에서는 실패함테스트 스위트가 특정 서비스 또는 설정 단계에 의존함빌드 및 테스트 설정
작업이 런타임 한도에 도달함작업 규모가 너무 큼작업, 계획, 스프린트 및 레인
반복적으로 발생함NEEDS_HUMAN_REVIEW명세가 불충분한 작업사양
실행 중간에 멈춰 있음여러 가지 원인이 있음작업이 멈추거나 실패할 때
의존성 설치 시 인증 오류로 인해 실패함개인 레지스트리 인증 정보가 설정되지 않음언어 지원 및 에이전트 환경
빌드에 필요한 도구가 누락됨기본 작업 공간 이미지 외부에 있는 툴체인에이전트 환경

원하는 결과가 출력되지 않음

증상원인으로 추정되는 사항확인할 위치
잘못된 문제를 해결함수용 기준이 너무 모호함사양
요청한 범위보다 훨씬 큰 변경이 이루어짐범위 외 작업에 대한 명시적 구분이 없음사양
사용자의 규칙을 무시함프로젝트 컨텍스트가 누락됨프로젝트 컨텍스트
계획이 지속적으로 부실함너무 작은 프로필로 작업이 실행됨AI 프로필
모든 게이트를 통과했지만 여전히 잘못됨게이트는 의도가 아닌 속성만 확인함품질 게이트

저장소 및 접근 권한

증상원인으로 추정되는 사항확인할 위치
목록에 저장소가 표시되지 않음앱에 해당 저장소에 대한 권한이 없거나 토큰 범위가 좁음코드 연결하기
이전에는 연결되었으나 지금은 안 됨토큰 소유자의 접근 권한이 상실되었거나 토큰이 만료됨코드 연결하기
잘못된 브랜치에 대해 풀 리퀘스트가 열려 있음기준 브랜치가 잘못 구성됨저장소 및 브랜치 설정

릴리스 및 배포

증상원인으로 추정되는 사항확인할 위치
릴리스에 다음과 같은 메시지가 표시됩니다:Preparing게이트 통과 후에 나타나는 내용입니다.필수 승인이 누락되었거나 현재 릴리스 노트에 대한 승인이 아직 완료되지 않았습니다.릴리스 게이트를 구성하세요.
릴리스에 다음과 같은 메시지가 표시됩니다:Blocked현재 환경 게이트에 차단 요소가 있거나 임시 체크리스트 예외 기간이 만료되었습니다.릴리스 게이트를 구성하세요.
배포 요청이 확인되지 않았습니다.프로바이더 실행 결과를 확인할 수 없으므로 점검을 마칠 때까지 새로운 작업을 시작하지 마세요.배포 이벤트를 연결하세요.
파이프라인은 성공했지만 배포된 내용이 보이지 않습니다.콜백이 누락되었거나 지연되었으며, 형식이 일치하지 않거나 격리된 상태입니다.배포 이벤트를 연결하세요.
배포는 완료되었지만 시스템 상태를 주의 깊게 모니터링해야 합니다.배포 후 카나리아 테스트가 실패했습니다.시스템 상태를 확인하고 복구를 진행하세요.
이전 커밋으로 되돌려야 하는 경우이전에 정상 작동했던 릴리스 SHA를 선택하여 롤백을 요청하세요.시스템 상태를 확인하고 복구를 진행하세요.

결제 정보

증상잠재적 원인확인할 위치
모델 호출이 중단되었습니다.크레딧이 소진되었습니다.모델 크레딧
예상치 못한 비용 발생고부하 에이전트에서 비용이 많이 드는 프로필이 사용되고 있습니다.AI 프로필
비용 산정이 불가능합니다.프로젝트별 보고서를 활용하세요.사용량 및 보고서

여전히 문제가 해결되지 않았다면

지원팀에 문의하기 전에 작업 ID, 현재 상태, 그리고 실패한 단계를 반드시 확인해 주세요. 이 세 가지 정보만으로도 대부분의 문의 사항을 즉시 해결할 수 있습니다.