Jira와 Copilot 클라우드 에이전트 통합

GitHub Copilot Jira의 통합을 통해 Jira 작업 영역을 종료하지 않고도 호출 Copilot 클라우드 에이전트 할 수 있습니다. Jira 내에서 작업 항목 제목, 설명, 레이블, 주석 및 수락 조건과 같은 Atlassian 사용자 지정 필드의 컨텍스트를 사용하여 세션을 시작하고 클라우드 에이전트 끌어오기 요청을 열 수 있습니다.

사전 요구 사항

• 유료 GitHub 플랜을 통해 Copilot에 액세스할 수 있는 Copilot 계정이 있어야 합니다.
• Jira Cloud 계정이 있어야 하고, Jira는 AI 지원 앱이어야 하며, 조직에 대해 Rovo를 활성화해야 합니다. Atlassian 설명서에서 앱에 대한 AI 활성화 를 참조하세요.
• Jira 및 .에 대한 설치 및 GitHub인증을 모두 완료해야 합니다.

설치

Jira 앱에 GitHub Copilot을 설치하기 위해 GitHub 조직 또는 엔터프라이즈 계정에 대해 권한을 부여하려면 다음이 필요합니다.

• Jira 사이트에 대한 관리자 권한입니다.
• GitHub 소유자 권한 또는 GitHub 앱 관리자 권한이 귀하의 조직에 필요합니다.

이 통합은 Atlassian Forge 애플리케이션과 GitHub 애플리케이션에 의존합니다. 둘 다 통합에 필요합니다. 성공적으로 설치되면 리포지토리에 쓰기 권한이 있는 Jira 작업 영역의 권한 있는 사용자가 Jira에서 에이전트를 트리거할 수 있습니다.

GitHub Copilot용 Jira 앱에 GitHub.com 설치

1. Atlassian Marketplace의 GitHub Copilot for Jira 설치 페이지 로 이동합니다.

2. 지금 가져오기를 클릭합니다.

3. 애플리케이션을 설치 GitHub 하려는 Atlassian 사이트를 선택합니다.

4. 검토를 클릭하여 설치 세부 정보를 확인한 다음 지금 가져오기를 클릭합니다.

GitHub Copilot for Jira가 Jira 사이트에 설치되면 앱이 GitHub 조직 및 리포지토리에 액세스할 수 있도록 권한을 부여해야 합니다.

1. 설치 후 Jira의 확인 메시지에서 구성 을 클릭합니다.
   • 자동으로 리디렉션되지 않으면 GitHub Marketplace에서 GitHub Copilot for Jira 설치 페이지로 이동하세요. 설치를 클릭합니다.
2. 아직 GitHub에 로그인되어 있지 않은 경우, 강조 표시된 GitHub에 로그인을 클릭하고 안내에 따라 GitHub 계정에 로그인한 후 애플리케이션에 권한을 부여하세요.
   • 조직 또는 엔터프라이즈에서 SSO(Single Sign-On)를 사용하는 경우 조직에 대한 활성 SAML 세션을 시작하고 추가 권한 부여 단계를 수행해야 할 수 있습니다.
3. 앱 설치를 클릭하여 앱에 GitHub 계정의 정보에 액세스할 수 있는 권한을 부여합니다.
4. 앱에 액세스할 수 있는 조직 및 리포지토리를 선택합니다. 귀하의 GitHub 조직은 Jira 작업 영역에서 기본적으로 활성화됩니다. 필요에 따라 Jira용 설치 GitHub Copilot 페이지에서 애플리케이션에 액세스하지 않으려는 조직 및 리포지토리의 _선택을 취소_합니다.
5. 설치를 클릭합니다.
6. 설치가 완료되면 Jira의 for Jira 앱 구성 페이지에 연결된 조직의 GitHub Copilot 목록이 표시됩니다.

GitHub Copilot용 Jira 앱에 GHE.com 설치

1. Atlassian Marketplace에서 GitHub Copilot Jira(GHEC, Data Residency 포함) 설치 페이지로 이동합니다.

2. 앱 이름 오른쪽에 있는 버튼을 클릭하고 텍스트 상자에 SUBDOMAIN.ghe.com을 입력합니다. SUBDOMAIN을 엔터프라이즈의 하위 도메인 GHE.com으로 대체합니다.

3. 구성 저장을 클릭합니다.

4. 지금 가져오기를 클릭합니다.

5. 애플리케이션을 설치 GitHub 하려는 Atlassian 사이트를 선택합니다.

6. 검토를 클릭하여 설치 세부 정보를 확인한 다음 지금 가져오기를 클릭합니다.

   Jira 사이트에 GitHub Copilot for Jira가 설치되면 앱이 GitHub 조직 및 리포지토리에 액세스할 수 있도록 권한을 부여해야 합니다.

7. 설치 후 Jira의 확인 메시지에서 구성 을 클릭합니다.

   • 자동으로 리디렉션되지 않는 경우, 엔터프라이즈에서 사용할 수 있는 앱 목록에서 GitHub Copilot for Jira 앱을 찾으십시오. SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira 설치를 클릭합니다.

8. GitHub에 아직 로그인하지 않은 경우 강조 표시된 GitHub에 로그인을 클릭하고 안내에 따라 GitHub 계정에 로그인한 다음 애플리케이션에 권한을 부여하세요.

   • 조��� 또는 엔터프라이즈에서 SSO를 사용하는 경우 조직에 대한 활성 SAML 세션을 시작하고 추가 권한 부여 단계를 수행해야 할 수 있습니다.

9. 앱 설치를 클릭하여 앱에 GitHub 계정의 정보에 액세스할 수 있는 권한을 부여합니다.

10. 앱에 액세스할 수 있는 조직 및 리포지토리를 선택합니다. 귀하의 GitHub 조직은 Jira 작업 영역에서 기본으로 활성화되어 있습니다. 필요에 따라 Jira용 설치 GitHub Copilot 페이지에서 애플리케이션에 액세스하지 않으려는 조직 및 리포지토리의 _선택을 취소_합니다.

11. 설치를 클릭합니다.

12. 설치가 완료되면 Jira의 for Jira 앱 구성 페이지에 연결된 조직의 GitHub Copilot 목록이 표시됩니다.

Jira에서 GitHub Copilot 앱 사용

Copilot 앱은 사용하기 전에 구성원인 GitHub 조직에서 활성화되어야 합니다.

Jira에서 Copilot 클라우드 에이전트을 처음 사용할 때, Copilot 클라우드 에이전트을 계정에 연결해야 합니다.

리포지토리에 대한 쓰기 권한이 있는 사용자만 해당 리포지토리에서 작동하도록 트리거 Copilot 클라우드 에이전트 할 수 있습니다.

Copilot 클라우드 에이전트를 트리거하는 방법은 여러 가지가 있습니다.

• 할당GitHub Copilot 배정자 필드를 사용하여 작업 항목에 할당하십시오.
• 작업 항목의 주석에서 언급@GitHub Copilot하세요.
• Jira 자동화를 사용합니다. Jira 자동화 규칙에서 작업 사용을 GitHub Copilot 선택하고 작업 항목이 만들어지거나 전환되거나 레이블이 적용되는 경우와 같은 Jira 이벤트에 따라 사용자 지정 트리거를 사용하도록 흐름을 구성합니다. 자세한 내용은 Atlassian 설명서의 Jira에서 AI 에이전트로 작업 하세요.

예: Jira 작업 항목에서 Copilot 클라우드 에이전트 트리거

1. Jira에서 명확한 요구 사항이 포함된 작업 항목을 열거나 생성하여 Copilot 클라우드 에이전트에게 위임할 수 있습니다.

2. 작업하려는 Copilot 리포지토리를 지정하려면 작업 항목 설명 또는 주석에 언급합니다.

3. 작업 항목에 GitHub Copilot를 할당하거나 댓글에서 @GitHub Copilot을 언급합니다. 다음은 그 예입니다.

   @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
   

4. 이전에 Jira의 GitHub 애플리케이션을 GitHub 계정에 연결하지 않은 경우 프롬프트에 따라 애플리케이션과 Atlassian 모두 GitHub 에 대한 권한을 부여합니다.

5. Copilot 클라우드 에이전트 끌어오기 요청 작업을 시작하면 Jira의 채팅 패널에 메모가 표시됩니다. 에이전트 세션을 시작한 사용자는 진행률을 볼 수 있습니다.

6. Copilot에 대해 추가 지침을 이어서 제공할 수 있습니다.

   • Agents heading 아래의 채팅에서 계속 버튼을 사용하여 Copilot와 직접 채팅하고 현재 풀 리퀘스트를 업데이트하세요.
   • 작업 항목의 댓글에서 @GitHub Copilot을(를) 언급하면 새 끌어오기 요청에서 업데이트가 이루어집니다.

Jira에서 에이전트 활동 보기

작업하는 동안 클라우드 에이전트 활동 스트림은 Jira의 채팅 패널에 라이브로 저장되므로 작업 항목을 종료하지 않고도 에이전트가 수행하는 작업을 따를 수 있습니다. 활동 스트림에는 연결된 에이전트 세션에 대한 GitHub링크가 포함됩니다.

세션 후 Jira에서 Copilot로 이동

Copilot 클라우드 에이전트 세션을 완료한 경우(예: 끌어오기 요청을 검토할 준비가 된 경우) 작업을 계속하도록 지시 Copilot 할 수 있습니다.

• Jira의 채팅 패널에서 연결된 에이전트 세션에 대한 GitHub링크를 선택합니다. 그러면 에이전트 패널 GitHub이 열립니다. 여기서 세션을 검토하고 후속 지침을 보내 기존 끌어오기 요청을 업데이트할 수 있습니다.
• Jira 작업 항목에 대한 후속 @GitHub Copilot 멘션 또는 주석을 추가합니다. 그러면 새 세션이 시작되고 기존 세션을 업데이트하는 대신 새 끌어오기 요청이 열립니다.

Copilot 클라우드 에이전트 Jira에서 사용자 지정

모델, 에이전트 및 사용자 지정 지침을 지정하여 Jira 작업 영역에서 작동 방식을 Copilot 클라우드 에이전트 사용자 지정할 수 있습니다.

모델 지정

기본값이 아닌 특정 모델에서 작업을 실행하려는 경우 모델을 지정합니다. 예를 들어 범위가 잘 지정된 루틴 변경에 대해 더 가벼운 모델을 선택할 수 있습니다. 특정 작업에 사용되는 Copilot 클라우드 에이전트 모델을 변경하려면 지침에 모델 이름을 포함합니다. Copilot을 참조하세요.

사용자 지정 에이전트 지정

특정 워크플로 또는 리포지토리에 맞게 사용자 지정 클라우드 에이전트에이전트를 지정합니다. Jira 티켓에서 직접 리포지토리에서 GitHub 사용자 지정 에이전트를 지정할 수 있습니다. 자세한 내용은 에 대한 사용자 지정 에이전트 만들기 Copilot 클라우드 에이전트을(를) 참조하세요.

사용자 지정 지침 사용

사용자 지정 지침을 사용하여 대상 리포지토리와 같은 모든 세션에 적용되는 기본값을 설정하므로 Copilot 일시 중지하고 세션 중간에 입력을 요청할 필요가 없습니다. 트리거될 때마다 Copilot 클라우드 에이전트 적용되는 Jira 작업 영역 수준에서 사용자 지정 지침을 정의할 수 있습니다.

사용 비용

Copilot 클라우드 에이전트은 GitHub Actions분 및 AI credits을 사용합니다.

자세한 내용은 조직 및 기업에 대한 사용량 기반 청구을(를) 참조하세요.

GitHub Copilot for Jira 앱에 조직 추가 또는 제거

Jira 관리자 및 GitHub 조직 소유자는 통합을 위해 조직을 사용하거나 사용하지 않도록 설정할 수 있습니다.

조직의 GitHub Copilot for Jira 앱에 대한 액세스 권한을 변경하려면:

1. Jira에서 작업 영역의 설정 페이지로 이동합니다.
2. 애플리케이션 설정 페이지로 GitHub Copilot 앱으로 이동하십시오.
3. 필요에 따라 추가 GitHub 조직 연결을 클릭하여 새 조직을 목록에 추가합니다.
4. 나열된 조직 중 하나 이상에 대해 Copilot 앱을 사용 또는 사용 안 함으로 설정합니다.

Troubleshooting

문제가 발생하면 다음 해결 방법을 시도해 보세요.

Copilot 클라우드 에이전트를 볼 수 없으며 이를 Jira 작업 항목에 할당할 수 없습니다.

Jira에서 조직에 대한 Atlassian 관리 설정이 다음과 같이 설정되어 있는지 확인합니다.

1. Jira는 AI 지원 앱입니다. Atlassian 설명서의 앱에 대한 AI 활성화 를 참조하세요.

Copilot 클라우드 에이전트를 볼 수는 있지만 Jira 작업 항목에는 할당할 수 없습니다.

GitHub의 개인 계정이 Jira 앱용 GitHub Copilot과 연결되었는지 확인하세요.

1. Jira에서 개인 계정의 설정 페이지로 이동합니다.
2. 일반 설정에서 Jira 앱을 선택합니다GitHub Copilot.
3. 아직 로그인 GitHub하지 않은 경우 프롬프트에 따라 로그인하고 애플리케이션에 권한을 부여합니다.

GitHub Copilot와 채팅할 때 로그인하라는 메시지가 표시됩니다.

Jira 앱의 GitHub Copilot에 로그인하려면 Copilot 클라우드 에이전트은(는) 볼 수 있지만 Jira 작업 항목에 할당할 수는 없습니다에 있는 위 단계를 따르세요.

작업 영역의 다른 사용자는 Copilot 클라우드 에이전트을(를) Jira 작업 항목에 할당할 수 있지만, 귀하는 할당할 수 없습니다.

Copilot 클라우드 에이전트이(가) Jira에서 귀하의 조직 리소스를 보거나 작업할 수 없고, 귀하의 조직이 GitHub에서 SSO를 사용하는 경우, GitHub 계정에 대해 GitHub Copilot for Jira 앱을 다시 승인해야 할 수 있습니다. 자세한 내용은 Single Sign-On을 사용한 인증에 대하여을(를) 참조하세요.

이 문제를 해결하려면 다음 단계에 따라 조직에 대한 새 활성 SSO 세션을 시작합니다.

1. GitHub에서 조직 설정으로 이동합니다.
2. "Single Sign-On"에서 인증해야 하는 조직을 찾고 로그아웃을 클릭한 다음 로그인합니다.
   • 엔터프라이즈에서 조직의 SSO를 관리하는 경우 엔터프라이즈의 한 조직에 로그인하면 엔터프라이즈의 모든 조직에 대한 SSO 세션으로 작동합니다.
3. Jira로 돌아가서 작업 중인 페이지를 새로 고칩니다.
4. Jira에서 Copilot 클라우드 에이전트와 함께 다시 작업해 보세요.

GitHub Copilot 응답하지 않음

• GitHub의 상태 페이지에서 발생 중인 인시던트를 확인하십시오.
• 활성 인시던트가 있는지 Atlassian 상태 페이지를 확인합니다.
• Copilot 클라우드 에이전트의 이슈에 Copilot를 할당할 수 있는지 테스트하여 GitHub가 리포지토리에 액세스 권한이 있는지 확인하십시오.
• for Jira 애플리케이션이 GitHub Copilot 리포지토리에 액세스할 수 있는지 확인합니다. 설치된 GitHub 앱 검토 및 수정을(를) 참조하세요.

추가 읽기

• GitHub Copilot 클라우드 에이전트 정보
• GitHub Copilot 클라우드 에이전트에 대한 액세스 관리
• 리포지토리에 대한 MCP 서버 구성
• Atlassian 설명서에서 AI 에이전트를 사용하여 작업 항목 공동 작업