Integrando o agente de nuvem do Copilot ao Jira

A GitHub Copilot integração no Jira permite que você invoque Copilot cloud agent sem sair do workspace do Jira. No próprio Jira, você pode iniciar sessões cloud agent e abrir pull requests, com base no contexto do título, da descrição, dos rótulos, dos comentários e de quaisquer campos personalizados do item de trabalho no Atlassian, como critérios de aceitação.

Pré-requisitos

• Você deve ter uma conta GitHub com acesso ao Copilot por meio de um plano pago Copilot.
• Você deve ter uma conta do Jira Cloud, o Jira deve ser um aplicativo habilitado para IA e o Rovo deve ser ativado para sua organização. Consulte Ativar IA para aplicativos na documentação do Atlassian.
• A instalação e a autenticação devem ser concluídas para Jira e GitHub.

Installation

Para instalar o GitHub Copilot aplicativo para Jira e autorizá-lo para sua GitHub organização ou conta corporativa, você precisa:

• Permissão de administrador para seu site do Jira.
• Permissões de proprietário ou GitHub gerenciador de aplicativos para sua GitHub organização.

Essa integração depende de um aplicativo Atlassian Forge e de um GitHub aplicativo. Ambos são necessários para a integração. Depois de instalado com êxito, os usuários autorizados do workspace do Jira com acesso de gravação a um GitHub repositório poderão disparar o agente a partir do Jira.

Instalando o aplicativo do Jira para GitHub Copilot

1. Navegue até a GitHub Copilot no Atlassian Marketplace.

2. Clique em Obtê-lo agora.

3. Selecione o site atlassiano no qual você deseja instalar o GitHub aplicativo.

4. Clique em Examinar para verificar os detalhes da instalação e clique em Obter agora.

   Depois que GitHub Copilot for Jira estiver instalado na sua instância do Jira, você precisará autorizar o aplicativo a acessar sua organização e seus repositórios do GitHub.

5. Clique em Configurar na mensagem de confirmação no Jira após a instalação.

   • Se você não for redirecionado automaticamente, vá para a GitHub Copilotpágina de instalação do Jira no GitHub Marketplace. Clique em Instalar.

6. Se você ainda não tiver feito login em GitHub, clique em Fazer login em GitHub, destacado, e siga as instruções para fazer login na sua conta GitHub e autorizar o aplicativo.

   • Se sua organização ou empresa usar o SSO (logon único), talvez seja necessário iniciar uma sessão SAML ativa para sua organização e executar uma etapa de autorização adicional.

7. Clique em Instalar aplicativo para conceder ao aplicativo permissão para acessar informações em sua conta GitHub.

8. Escolha a organização e os repositórios aos quais o aplicativo tem acesso. Suas GitHub organizações estão habilitadas por padrão para o workspace do Jira. Opcionalmente, na página Instalar GitHub Copilot para Jira , desmarque a organização e os repositórios aos quais você não deseja que o aplicativo tenha acesso.

9. Clique em Instalar.

10. Quando a instalação for concluída, você verá uma lista de organizações conectadas na GitHub Copilot página de configuração do aplicativo Jira no Jira.

Instalando o aplicativo do Jira para GitHub Copilot

1. Navegue até a página de instalação para o Jira (GHEC com Residência de Dados)GitHub Copilot no Atlassian Marketplace.

2. À direita do nome do aplicativo, clique e insira SUBDOMAIN.ghe.com na caixa de texto. Substitua SUBDOMAIN pelo subdomínio da sua empresa.GHE.com

3. Clique em Salvar configuração.

4. Clique em Obtê-lo agora.

5. Selecione o site atlassiano no qual você deseja instalar o GitHub aplicativo.

6. Clique em Examinar para verificar os detalhes da instalação e clique em Obter agora.

   Depois que GitHub Copilot for Jira estiver instalado na sua instância do Jira, você precisará autorizar o aplicativo a acessar sua organização e seus repositórios do GitHub.

7. Clique em Configurar na mensagem de confirmação no Jira após a instalação.

   • Se você não for redirecionado automaticamente, localize o GitHub Copilot aplicativo para Jira na lista de aplicativos disponíveis para sua empresa em SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira. Clique em Instalar.

8. Se você ainda não tiver feito login em GitHub, clique em Fazer login em GitHub, destacado, e siga as instruções para fazer login na sua conta GitHub e autorizar o aplicativo.

   • Se sua organização ou empresa usar o SSO, talvez seja necessário iniciar uma sessão SAML ativa para sua organização e executar uma etapa de autorização adicional.

9. Clique em Instalar aplicativo para conceder ao aplicativo permissão para acessar informações em sua conta GitHub.

10. Escolha a organização e os repositórios aos quais o aplicativo tem acesso. Suas GitHub organizações estão habilitadas por padrão para o workspace do Jira. Opcionalmente, na página Instalar GitHub Copilot para Jira , desmarque a organização e os repositórios aos quais você não deseja que o aplicativo tenha acesso.

11. Clique em Instalar.

12. Quando a instalação for concluída, você verá uma lista de organizações conectadas na GitHub Copilot página de configuração do aplicativo Jira no Jira.

Usando o GitHub Copilot aplicativo no Jira

O Copilot aplicativo deve ser habilitado para uma GitHub organização da qual você é membro, antes de começar a usá-lo.

Na primeira vez que você usar Copilot cloud agent no Jira, será necessário conectá-lo à sua GitHub conta.

Somente usuários com acesso de gravação a um repositório podem ativar Copilot cloud agent para que funcione nesse repositório.

Você pode disparar Copilot cloud agent de várias maneiras:

• AtribuirGitHub Copilot a um item de trabalho usando o campo Responsável.
• Mencionar@GitHub Copilot em um comentário sobre um item de trabalho.
• Use uma automação do Jira. Em suas regras de automação Jira, selecione a ação Usar GitHub Copilot e configure seu fluxo para usar um gatilho personalizado com base em eventos Jira, como quando um item de trabalho é criado ou transicionado ou um rótulo é aplicado. Para obter mais informações, consulte Trabalhar com agentes de IA no Jira na documentação do Atlassian.

Exemplo: Disparando Copilot cloud agent de um item de trabalho do Jira

1. No Jira, abra ou crie um item de trabalho que contenha requisitos claros aos quais você deseja delegar Copilot cloud agent.

2. Para especificar um repositório no qual você deseja Copilot trabalhar, mencione-o na descrição do item de trabalho ou em um comentário.

3. Atribua GitHub Copilot ao item de trabalho ou mencione @GitHub Copilot em um comentário. Por exemplo:

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

4. Se você não tiver conectado anteriormente o aplicativo com o Jira à sua conta GitHub, siga os prompts para autorizar o aplicativo para GitHub e Atlassian.

5. Depois de Copilot cloud agent começar a trabalhar na solicitação de pull, um comentário será exibido no painel de chat em Jira. O usuário que iniciou a sessão do agente pode exibir o progresso lá.

6. Você pode dar continuidade com instruções adicionais para Copilot:

   • Use o botão Continuar no Chat sob o cabeçalho Agentes para conversar diretamente com Copilot e fazer atualizações no pull request atual.
   • Mencione @GitHub Copilot em um comentário sobre o item de trabalho para ter atualizações feitas em uma nova solicitação de pull.

Visualizando a atividade do agente no Jira

Enquanto cloud agent transmite o fluxo de atividades em tempo real para o painel de chat do Jira, para que você possa acompanhar o que o agente está fazendo sem sair do seu item de trabalho. O fluxo de atividades inclui um link para a sessão do agente associado em GitHub.

Direcionando Copilot a partir do Jira após a sessão

Quando Copilot cloud agent tiver concluído uma sessão, por exemplo, quando uma solicitação de pull estiver pronta para revisão, você poderá direcionar Copilot para continuar o trabalho:

• No painel de chat em Jira, selecione o link para a sessão do agente associado em GitHub. Isso abre o painel de agentes em GitHub, onde você pode revisar a sessão e enviar instruções de acompanhamento para atualizar a pull request existente.
• Adicione uma menção de acompanhamento @GitHub Copilot ou comentário sobre o item de trabalho do Jira. Isso inicia uma nova sessão e abre uma nova solicitação de pull em vez de atualizar a existente.

Personalizando Copilot cloud agent no Jira

Você pode personalizar como Copilot cloud agent funciona em seu workspace Jira especificando modelos, agentes e instruções personalizadas.

Especificando um modelo

Especifique um modelo quando quiser que uma tarefa seja executada em um modelo específico, em vez do padrão. Por exemplo, você pode escolher um modelo mais leve para alterações rotineiras e com escopo bem definido. Para alterar o modelo usado por Copilot cloud agent para uma tarefa específica, inclua o nome do modelo em suas instruções para Copilot, consulte Alterando o modelo de IA para GitHub Copilot agente de nuvem.

Especificando um agente personalizado

Especifique um agente personalizado para personalizar cloud agento comportamento de um determinado fluxo de trabalho ou repositório. Você pode especificar um agente personalizado do repositório GitHub diretamente no tíquete do Jira. Para obter mais informações, consulte Criando agentes personalizados para Copilot cloud agent.

Como usar instruções personalizadas

Use instruções personalizadas para definir padrões que se aplicam a cada sessão, como o repositório de destino, portanto Copilot , não precisa pausar e solicitar entrada no meio da sessão. Você pode definir instruções personalizadas no nível do espaço de trabalho do Jira que se aplicam sempre que o Copilot cloud agent é acionado.

Custos de uso

Copilot cloud agent usa GitHub Actions minutos e AI credits.

Para obter mais informações, consulte Cobrança baseada em uso para organizações e empresas.

Adicionar ou remover uma organização no aplicativo GitHub Copilot para Jira

Um administrador do Jira e GitHub o proprietário da organização podem habilitar ou desabilitar as organizações para a integração.

Para alterar o acesso ao aplicativo GitHub Copilot para Jira de uma organização:

1. No Jira, vá para a página de configurações do workspace.
2. Vá para a página de configuração de aplicativos do GitHub Copilot aplicativo.
3. Opcionalmente, clique em Conectar Mais GitHub Organizações para adicionar novas organizações à lista.
4. Habilite ou desabilite o Copilot aplicativo para uma ou mais das organizações listadas.

Solução de problemas

Se você tiver problemas, experimente as soluções a seguir.

Você não pode ver o Copilot cloud agent e não é possível atribuí-lo a um item de trabalho do Jira.

No Jira, verifique se as configurações da Administração Atlassian para sua organização estão definidas da seguinte maneira.

1. O Jira é um aplicativo habilitado para IA, consulte Ativar IA para aplicativos na documentação do Atlassian.

Você pode ver, Copilot cloud agent mas não é possível atribuí-lo a um item de trabalho do Jira

Verifique se você conectou sua conta GitHub pessoal ao GitHub Copilot aplicativo do Jira.

1. No Jira, vá para a página de configurações da sua conta pessoal.
2. Em as suas configurações gerais, selecione o GitHub Copilot aplicativo do Jira.
3. Se você ainda não estiver conectado com GitHub, siga as instruções para entrar e dar permissão ao aplicativo.

Ao conversar com GitHub Copilot, você será solicitado a entrar

Para fazer login no GitHub Copilot do Jira, siga as etapas acima em Você pode ver o Copilot cloud agent, mas não é possível atribuí-lo a um item de trabalho do Jira.

Outros usuários em seu workspace podem atribuir Copilot cloud agent a um item de trabalho Jira, mas você não pode

Se Copilot cloud agent não conseguir ver nem trabalhar com os recursos da sua organização no Jira e sua organização usar SSO no GitHub, talvez seja necessário reautorizar o aplicativo GitHub Copilot para Jira na sua conta GitHub. Para obter mais informações, consulte Sobre a autenticação com o logon único.

Para resolver esse problema, siga estas etapas para iniciar uma nova sessão de SSO ativa para sua organização:

1. Vá para as configurações da sua organização em GitHub.
2. Em "Login único", encontre a organização em que você precisa se autenticar e clique em Sair e, em seguida, em Entrar.
   • Se sua empresa gerencia o SSO para sua organização, entrar em uma organização na empresa funciona como uma sessão de SSO para todas as organizações da empresa.
3. Retorne ao Jira e atualize a página em que você está trabalhando.
4. Tente trabalhar novamente com Copilot cloud agent no Jira.

GitHub Copilot não está respondendo

• Verifique a GitHub do para quaisquer incidentes ativos.
• Verifique a página de status do Atlassian em busca de incidentes ativos.
• Verifique se Copilot cloud agent tem acesso ao repositório testando se você pode atribuir Copilot a uma questão em GitHub.
• Verifique se o aplicativo para Jira GitHub Copilot tem acesso ao repositório. Consulte Revisão e modificação de aplicativos GitHub instalados.

Leitura adicional

• Sobre o agente de nuvem do GitHub Copilot
• Gerenciando o acesso ao agente de nuvem GitHub Copilot
• Configurar servidores MCP para seu repositório
• Colaborar em itens de trabalho com agentes de IA na documentação do Atlassian