Skip to main content

GitHub Copilot 코딩 에이전트 문제 해결 방법

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

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

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

Copilot을 내 이슈의 "Assignees" 목록에서 사용할 수 없습니다.

GitHub Copilot Pro 플랜, GitHub Copilot Pro(프로)+ 플랜, GitHub Copilot Business 플랜 또는 GitHub Copilot Enterprise 플랜을 통해 Copilot에 액세스할 수 있는 경우 이슈를 Copilot에만 할당할 수 있습니다.

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

GitHub Copilot Pro, GitHub Copilot Pro(프로)+, GitHub Copilot Business 또는 GitHub Copilot Enterprise를 보유하고 있는 경우 Copilot 코딩 에이전트이(가) 활성화되어 있으며 리포지토리에서 수동으로 비활성화되지 않았는지 확인하세요.

참고 항목

Copilot 설정의 기능 페이지(github.com/settings/copilot/features)에서 Copilot 코딩 에이전트을(를) 활성화했는지 확인할 수 있습니다.

Enterprise Managed User 계정을 보유하고 있으며, 내 개인 리포지토리에서 Copilot이(가) 작동하지 않습니다.

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

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

개인 리포지토리가 아니라 조직이 소유한 리포지토리를 사용해야 Copilot 코딩 에이전트을(를) 사용할 수 있습니다.

Copilot은(는) 부조종사 채팅의 끌어오기 요청을 생성할 수 없습니다.

Copilot에 끌어오기 요청을 생성하도록 요청한 후 끌어오기 요청을 직접 생성할 수 없다는 응답을 받은 경우, Copilot 코딩 에이전트의 사용 가능 여부를 확인하세요.

중요

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

이슈를 Copilot에 할당했지만 작동하지 않습니다.

잠시 기다린 다음, 페이지를 새로 고치세요. Copilot이(가) 이슈에 👀 응답을 남기는 것을 확인할 수 있습니다. 잠시 후, Copilot이(가) 이슈에 연결된 끌어오기 요청의 초안을 열며, 이는 이슈 타임라인에 표시됩니다.

Copilot은(는) 끌어오기 요청을 열었는데, 작동하지 않습니다.

"Copilot이(가) 작업을 시작함" 이벤트가 끌어오기 요청 타임라인에 있는 경우, 세션 보기를 클릭하여 세션 로그를 확인하세요. 이는 라이브로 스트리밍되어 수행 중인 작업을 Copilot에서 확인할 수 있습니다.

Copilot은(는) 끌어오기 요청 주석에 응답하지 않습니다.

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

쓰기 액세스가 있고 @copilot을(를) Copilot에 할당되는 끌어오기 요청에 언급할 경우, Copilot 코딩 에이전트(으)로 댓글이 전달됩니다. 눈 이모티콘(👀)이 댓글에 추가됩니다. 이는 Copilot 코딩 에이전트이(가) 댓글을 읽었음을 나타냅니다. 잠시 후, 끌어오기 요청 타임라인에 “Copilot이(가) 작업을 시작함” 이벤트가 추가됩니다.

해당 이벤트가 발생하지 않는 경우, 쓰기 권한이 없거나 Copilot이(가) 끌어오기 요청에서 할당이 취소된 것일 수 있습니다. 열려 있는 풀 리퀘스트의 멘션에만 Copilot이(가) 응답합니다. 끌어오기 요청이 병합되거나 닫힌 후, Copilot 코딩 에이전트은(는) 활성 개발 작업에 더 집중하기 위해 새로운 언급이나 댓글에 응답하지 않습니다.

Copilot이(가) 에이전트 세션 로그에 따라 중단된 것 같습니다.

잠시 동안 Copilot이(가) 중단된 것처럼 보이다가 다시 작동할 수 있습니다.

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

Copilot이(가) 설명에 응답하는 동안 중단된 경우 동일한 댓글을 끌어오기 요청에 다시 추가해 보세요.

내 GitHub Actions 워크플로가 Copilot이 푸시할 때 실행되고 있지 않습니다.

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

GitHub Actions 워크플로 실행을 허용하려면 끌어오기 요청의 병합 상자에서 워크플로 승인 및 실행 단추를 클릭하세요. GitHub Copilot에서 만든 끌어오기 요청 검토을(를) 참조하세요.

CI 검사를 통과하지 못하는 변경 내용을 Copilot이(가) 푸시하고 있습니다.

이슈 작업을 하는 동안 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)