

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Q Developer for GitHub 문제 해결
<a name="github-troubleshooting"></a>

Amazon Q Developer for GitHub를 사용할 때 발생하는 일반적인 문제를 해결하려면 다음 섹션을 참조하세요.

## Amazon Q Developer가 브랜치 보호 규칙을 사용하여 리포지토리에서 풀 요청을 생성하지 않음
<a name="github-troubleshooting-branch-protection"></a>

**문제**: Amazon Q Developer가 브랜치 보호 규칙이 있는 내 GitHub 리포지토리에서 풀 요청을 생성할 수 없습니다.

**솔루션**: 브랜치 보호 규칙은 Amazon Q Developer가 풀 요청을 생성하기 위해 브랜치를 생성하지 못하도록 합니다. 브랜치 보호 규칙이 있는 리포지토리에서 Amazon Q Developer for GitHub를 사용하려면 허용 목록에 Amazon Q Developer 앱을 추가해야 합니다.

**허용 목록에 Amazon Q Developer 앱을 추가하려면**

1. 필요한 경우 GitHub 자격 증명을 사용하여 [https://github.com/](https://github.com/) 계정에 로그인합니다.

1. GitHub 조직으로 이동한 다음 Amazon Q Developer for GitHub 앱 목록을 허용할 리포지토리로 이동합니다.

1. **설정**을 선택한 다음 탐색 창에서 **브랜치**를 선택합니다.

1. **브랜치 보호 규칙**에서 **편집**을 선택하여 브랜치 보호 규칙을 수정합니다.

1. **일치하는 브랜치를 생성하는 푸시 제한**을 선택하고 Amazon Q Developer for GitHub 앱을 검색합니다.

1. **변경 사항 저장**을 선택하여 Amazon Q Developer가 Amazon Q Developer 레이블 관련 문제에 대한 풀 요청을 생성하도록 허용합니다.

GitHub에서 브랜치 보호 규칙을 수정하는 방법에 대한 자세한 내용은 [브랜치 보호 규칙 생성](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule)을 참조하세요.

## Amazon Q Developer 레이블이 GitHub 문제에서 누락됨
<a name="github-troubleshooting-labels"></a>

**문제**: **Amazon Q 개발 에이전트** 레이블이 GitHub 표시되지 않습니다.

**해결** 방법: GitHub 앱용 Amazon Q Developer를 설치할 때 레이블이 자동으로 생성되지 않거나 의도하지 않게 삭제된 경우에서 수동으로 생성할 수 있습니다GitHub. 레이블을 **Amazon Q Developer 레이블로 인식하고 처리하려면 레이블의 이름을 Amazon Q 개발 에이전트**로 지정해야 합니다. 자세한 내용은 *GitHub 설명서*의 [레이블 생성](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)을 참조하세요.

## Amazon Q Developer가 GitHub 문제에 대한 코드를 생성하지 않음
<a name="github-troubleshooting-generate-code"></a>

**문제**: GitHub 문제를 생성하고 Amazon Q Developer를 호출하여 작업을 수행했지만 기술적 문제와 관련하여 다음과 같은 일련의 메시지를 수신합니다.

1. ⏳ 이 문제에 대한 코드 생성을 진행 중입니다. 작업 완료 후 이 문제에 댓글을 추가하여 업데이트하고 풀 요청을 열겠습니다.

1. ⚠️ 기술적 문제가 있습니다. 문제를 해결하지 못했습니다. 다시 시도하겠습니다. 다소 시간이 걸릴 수 있습니다.

1. ⚠️ 기술적 문제가 있습니다. 문제를 해결하지 못했습니다. 다시 시도하겠습니다. 다소 시간이 걸릴 수 있습니다.

1. 🔴 기술적 문제가 있습니다. 문제를 해결하지 못했습니다.

   이 문제를 다른 사용자에게 재할당하는 것을 고려하세요. 이 방법은 생성형 AI 기능 사용 할당량을 넘지 않는 데 도움이 될 것입니다.

**해결** 방법: Amazon Q Developer가 문제를 처리하고 이에 대한 코드를 생성할 수 없는 경우 새 문제를 생성하고 **Amazon Q 개발 에이전트** 레이블을 새 문제에 적용합니다. 문제 생성 및 Amazon Q Developer 에이전트 레이블 적용에 대한 자세한 내용은 섹션을 참조하세요[GitHub에서 Amazon Q Developer로 기능 개발 및 반복](github-feature-development.md).