Integrando o agente do Copilot na nuvem com o Jira

A GitHub Copilot integração no Jira permite que você invoque agente de nuvem Copilot sem sair do workspace do Jira. No próprio Jira, você pode iniciar sessões agente de nuvem 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 gerenciador de aplicativos GitHub para sua organização GitHub.

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 repositório GitHub poderão disparar o agente a partir do Jira.

Instalar o GitHub Copilot para o aplicativo do Jira para GitHub.com

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.

Instalar o GitHub Copilot para o aplicativo do Jira para GHE.com

1. Navegue até a página de instalação GitHub Copilot para o Jira (GHEC com Residência de Dados) 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.

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

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 para o aplicativo do 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 estiver conectado ao 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.

Usar o aplicativo GitHub Copilot 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 agente de nuvem Copilot no Jira, será necessário conectá-lo à sua GitHub conta.

Somente usuários com acesso de gravação a um repositório podem acionar o agente de nuvem Copilot para trabalhar nesse repositório.

Você pode disparar agente de nuvem Copilot 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: disparar agente de nuvem Copilot 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 agente de nuvem Copilot.

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 GitHub no Jira à sua conta GitHub, siga os prompts para autorizar o aplicativo para GitHub e Atlassian.

5. Depois de agente de nuvem Copilot 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 agente de nuvem 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 agente de nuvem Copilot 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 agente de nuvem Copilot no Jira

Você pode personalizar como agente de nuvem Copilot 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 agente de nuvem Copilot 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 agente de nuvemo 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 agente de nuvem Copilot.

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 agente de nuvem Copilot é acionado.

Custos de uso

agente de nuvem Copilot 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 agente de nuvem Copilot 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, agente de nuvem Copilot 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 suas configurações gerais, selecione o GitHub Copilot para o 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 agente de nuvem Copilot, mas não é possível atribuí-lo a um item de trabalho do Jira.

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

Se agente de nuvem Copilot 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 agente de nuvem Copilot 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 agente de nuvem Copilot tem acesso ao repositório testando se você pode atribuir Copilot a uma questão em GitHub.
• Verifique se o GitHub Copilot para o aplicativo do Jira 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