GitHub Copilot 클라우드 에이전트 문제 해결

작업을 Copilot할당할 때 발생할 수 있는 문제를 해결하는 방법을 알아봅니다.

누가 이 기능을 사용할 수 있나요?

Copilot 클라우드 에이전트는 GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business,GitHub Copilot Enterprise 플랜과 함께 사용할 수 있습니다. 에이전트는 GitHub에 저장된 모든 리포지토리에서 사용할 수 있습니다. 단, 관리형 사용자 계정가 소유한 리포지토리에서는 에이전트가 명시적으로 비활성화되어 있습니다.
Sign up for Copilot

이 기사에서

          Copilot 내 문제의 "할당자" 목록에서 사용할 수 없습니다.

계획 GitHub Copilot Pro, 계획 GitHub Copilot Pro+, 계획 GitHub Copilot Business, 또는 계획 GitHub Copilot Enterprise 을 통해 Copilot에 대한 액세스 권한이 있을 때만 Copilot에 문제를 할당할 수 있습니다.

아직 해당 플랜 중 하나의 구독이 없다면, 이 단추를 클릭하여 자세히 알아보세요.

          <a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
          <span>등록 Copilot</span><svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg></a>

당신이 _소유한 경우_GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business, 또는 GitHub Copilot Enterprise, 리포지토리에서 Copilot 클라우드 에이전트 사용이 활성화되어 있고 수동으로 비활성화되지 않았는지 확인하십시오.

  •         GitHub Copilot Business 또는 Copilot Enterprise 요금제를 사용 중인 경우, Copilot 클라우드 에이전트 사용 권한은 귀하의 기업 및/또는 조직 관리자에 의해 제어됩니다. 
        [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/adding-copilot-coding-agent-to-enterprise)을(를) 참조하세요.

  • 조직 소유 리포지토리의 경우 리포지토리의 Copilot 클라우드 에이전트 가용성은 조직 및/또는 엔터프라이즈 관리자가 관리합니다. 조직에 GitHub Copilot 클라우드 에이전트 추가을(를) 참조하세요.

  • 개인 리포지토리의 경우 리포지토리의 Copilot 클라우드 에이전트 가용성은 계정 설정에서 구성됩니다. 개별 구독자로 GitHub Copilot 정책 관리을(를) 참조하세요.

참고

설정의 Copilot 기능 페이지에서 Copilot 클라우드 에이전트이(가) 사용하도록 설정되었는지 확인할 수 있습니다: github.com/settings/copilot/features.

          Enterprise Managed User 계정이 있고 Copilot 개인 리포지토리에서 작동하지 않음

Copilot 클라우드 에이전트은(는) 관리형 사용자 계정이(가) 소유한 개인 리포지토리에서는 사용할 수 없습니다. 그 이유는 Copilot 클라우드 에이전트이(가) GitHub에서 호스팅하는 실행기에서 실행되기 때문이며, 이 실행기는 관리형 사용자 계정이(가) 소유한 개인 리포지토리에서는 사용할 수 없습니다. 자세한 내용은 GitHub 호스팅 실행기을(를) 참조하세요.

          관리형 사용자 계정가 있고 개인 리포지토리의 이슈에 Copilot를 할당하려고 하면, GitHub Actions가 귀하의 리포지토리에서 사용할 수 없다는 오류 메시지가 표시될 수 있습니다.

사용 Copilot 클라우드 에이전트하려면 개인 리포지토리 대신 조직에서 소유한 리포지토리로 작업해야 합니다.

          Copilot 에서 끌어오기 요청을 만들 수 없습니다. Copilot 채팅

          Copilot에게 끌어오기 요청을 만들도록 요청했는데 끌어오기 요청을 직접 만들 수 없다고 응답하는 경우, Copilot 클라우드 에이전트이(가) 사용 가능한지 확인하십시오.

중요

VS Code, Visual Studio, JetBrains IDE에서는 프롬프트에서 @github 채팅 참가자를 언급해야 합니다. GitHub.com의 Copilot 채팅에서는 이를 생략할 수 있습니다.

문제를 Copilot할당했지만 아무 작업도 수행되지 않습니다.

잠시 기다린 다음, 페이지를 새로 고치세요. 당신은 Copilot이/가 문제에 👀 반응을 보이는 것을 확인해야 합니다. 이 Copilot 직후 문제 타임라인에 표시되는 문제에 연결된 초안 끌어오기 요청이 열립니다.

          Copilot 끌어오기 요청을 열었지만 아무 작업도 수행되지 않습니다.

풀 요청 타임라인에 "Copilot started work" 이벤트가 있는 경우, 로그를 확인하려면 세션 보기를 클릭합니다. 이것들은 라이브로 스트리밍되며, Copilot가 무엇을 하는지 확인할 수 있습니다.

          Copilot 끌어오기 요청 주석에 응답하지 않음

Copilot은 해당 리포지토리에 대한 쓰기 권한이 있는 사람의 의견에만 응답합니다.

쓰기 권한이 있고, Copilot에 할당된 끌어오기 요청에서 @copilot을 언급하면, 해당 주석이 Copilot 클라우드 에이전트로 전달됩니다. 댓글에 눈 이모티콘(👀)이 추가되어 Copilot 클라우드 에이전트이/가 댓글을 보았음을 나타냅니다. 잠시 후 "Copilot started work" 이벤트가 끌어오기 요청 타임라인에 추가됩니다.

이런 일이 발생하지 않으면, Copilot가 요청에서 할당 해제되었거나 사용자에게 쓰기 권한이 없을 수 있습니다. 열려 있는 Copilot 끌어오기 요청의 멘션에만 응답합니다. 끌어오기 요청이 병합되거나 닫히면 Copilot 클라우드 에이전트 활성 개발 작업에 더 집중하기 위해 새 멘션 또는 댓글에 응답하지 않습니다.

에이전트 세션 로그에 따르면 Copilot 이(가) 멈춘 것으로 보입니다.

          Copilot 는 잠시 동안 멈춰 있는 것처럼 보이고 다시 움직일 수 있습니다.

세션이 중단된 채로 있으면 1시간 후 시간 초과됩니다. 문제를 Copilot에게 할당 취소한 다음 다시 할당하여 다시 시도할 수 있습니다.

댓글에 응답하는 동안 Copilot이(가) 멈춘 경우, 동일한 주석을 다시 끌어오기 요청에 추가해 보세요.

Copilot가 푸시할 때 내 GitHub Actions 워크플로가 실행되지 않음

          GitHub Actions 끌어오기 요청에 변경 내용을 푸시하면 워크플로가 자동으로 Copilot 실행되지 않습니다.

워크플로가 실행되도록 GitHub Actions 하려면 끌어오기 요청의 병합 상자에서 워크플로 승인 및 실행 단추를 클릭합니다. GitHub Copilot가 생성한 풀 리퀘스트 검토을(를) 참조하세요.

          Copilot가 CI 검사를 통과하지 못한 변경 사항을 푸시하고 있습니다.

문제를 Copilot 처리하는 동안, GitHub Actions의 지원을 받아 자동화된 테스트와 린터를 실행하여 푸시 전에 작업을 검증할 수 있는 자체 임시 개발 환경에 접근할 수 있습니다.

명확한 지침이 제공되면 이를 수행할 가능성이 가장 높습니다. 이를 실행하는 가장 좋은 방법은 .github/copilot-instructions.md 파일을 사용하는 것입니다. GitHub Copilot를 사용하여 작업에 대한 모범 사례을(를) 참조하세요.

방화벽에 대한 경고 GitHub Copilot 가 있습니다.

기본적으로 Copilot인터넷에 대한 액세스는 방화벽에 의해 제한됩니다.

인터넷에 대한 액세스를 제한하면 데이터 반출 위험을 관리하는 데 도움이 되며, 이와 같은 경우 예상치 못한 행동 Copilot이나 악의적인 지침이 제공되면 코드 또는 기타 중요한 정보가 원격 위치로 유출될 수 있습니다.

          Copilot 방화벽에 의해 차단된 요청을 수행하려고 하면 끌어오기 요청 본문(문제 할당에 응답하는 경우Copilot) 또는 주석(주석에 응답하는 경우Copilot)에 경고가 추가됩니다. 차단된 주소와 요청을 시도한 명령이 경고에 표시됩니다.

방화벽에 의한 차단과 관련하여 Copilot에 표시되는 경고 스크린샷

자세한 내용은 GitHub Copilot 클라우드 에이전트에 대한 방화벽 사용자 지정 또는 비활성화을(를) 참조하세요.

          Copilot 연결된 스크린샷을 인식하지 않음

허용되는 Copilot 클라우드 에이전트 최대 이미지 크기는 3.00MiB입니다. 이 이상의 이미지는 요청에서 제거됩니다.

추가 참고 자료

  •         [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)

  •         [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent)