# Integrando o agente de nuvem do Copilot ao Jira Você pode usar a GitHub integração no Jira para fornecer contexto e abrir solicitações de pull, tudo de dentro do workspace do Jira. > \[!NOTE] > GitHub Copilot usa IA. Verifique se há erros. Consulte [Cartão de aplicativo: GitHub Copilot Agents](/pt/enterprise-cloud@latest/copilot/responsible-use/agents). 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](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) 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](https://github.com/apps/github-copilot-for-jira?ref_product=copilot\&ref_type=engagement\&ref_style=text) 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](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot\&ref_type=engagement\&ref_style=text) 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: * **Atribuir**GitHub 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](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/) na documentação do Atlassian. > \[!NOTE] > Quando você atribui Copilot a um item de trabalho Jira, o contexto que o agente captura de Jira será adicionado à solicitação de pull e **visível para todos** se o repositório for público. ### 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: ```text @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. > \[!TIP] > Se você não tiver recebido a confirmação do acionamento de Copilot cloud agent após 1 minuto, atualize a página de item de trabalho do Jira. ### 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](/pt/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). ### 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](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents). ### 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](/pt/enterprise-cloud@latest/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises). ## 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. > \[!NOTE] > Se uma nova organização protegida por SSO for adicionada ao aplicativo após a instalação inicial, os usuários precisarão iniciar uma sessão SAML ativa para a organização em GitHub, a fim de fazer com que Copilot cloud agent funcione nos repositórios da nova organização a partir do Jira. Para obter mais informações, consulte [Sobre a autenticação com o logon único](/pt/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso). 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](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) 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](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item). ### 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](/pt/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso). 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](https://github.com/settings/organizations) 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 [](https://githubstatus.com) para quaisquer incidentes ativos. * Verifique a [página de status do Atlassian](https://status.atlassian.com) 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](/pt/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps). ## Leitura adicional * [Sobre o agente de nuvem do GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/about-cloud-agent) * [Gerenciando o acesso ao agente de nuvem GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/access-management) * [Configurar servidores MCP para seu repositório](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian) * [Colaborar em itens de trabalho com agentes de IA](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/) na documentação do Atlassian