# Usando o agente de nuvem Copilot do Raycast

Inicie e acompanhe sessões Copilot cloud agent a partir do inicializador do Raycast.

[Raycast](https://www.raycast.com/) é um inicializador extensível para Windows e macOS. Com a extensão GitHub Copilot para Raycast, você pode iniciar e acompanhar tarefas Copilot cloud agent e ver logs de sessão ao vivo onde quer que esteja no seu computador.

## Pré-requisitos

1. Instale o Raycast do [site do Raycast](https://www.raycast.com).
2. Instale a GitHub Copilot extensão do Raycast clicando no botão **Instalar Extensão** na [página da extensão](https://www.raycast.com/github/github-copilot).

## Iniciando uma sessão

1. Abra o Raycast, pesquise "Copilot", localize o comando **Criar Tarefa** e pressione <kbd>Enter</kbd>.

2. Clique em **Entrar com GitHub** e conclua o fluxo de autenticação. O Raycast será aberto novamente.

3. Digite um prompt que descreva o que você deseja Copilot fazer.

   Por exemplo, `Implement a user friendly message for common errors.`

4. Selecione o repositório no qual você deseja Copilot trabalhar.

5. Opcionalmente, selecione um branch base para o pull request de Copilot.
   Copilot criará uma nova ramificação com base nesse branch e, em seguida, enviará por push as alterações para uma solicitação de pull direcionada a esse branch.

6. Opcionalmente, selecione um custom agent com comportamento especializado e ferramentas no menu suspenso. Para saber mais, confira [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).

7. Opcionalmente, você pode usar o menu suspenso para selecionar o modelo que Copilot irá utilizar. Se o modelo selecionado der suporte ao raciocínio configurável, você também poderá usar o menu suspenso para selecionar o nível de raciocínio. Para obter mais informações, consulte [Alterando o modelo de IA para GitHub Copilot agente de nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).

8. Pressione <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows) para iniciar a tarefa.

Copilot iniciará uma nova sessão.
Copilot trabalhará na tarefa e enviará por push as alterações à solicitação de pull e, em seguida, adicionará você como revisor quando terminar, disparando uma notificação.

> \[!NOTE]
>
> Se você não conseguir selecionar um repositório específico ao iniciar uma tarefa, a organização que possui o repositório poderá ter habilitado OAuth app restrições de acesso. Para saber como solicitar aprovação para o "GitHub Copilot para Raycast", OAuth appconsulte [Solicitar aprovação da organização para aplicativos OAuth](/pt/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).

## Atribuindo um problema no Raycast

1. Abra o Raycast, pesquise "Copilot", encontre o comando **Atribuir Problemas a Copilot** e pressione <kbd>Enter</kbd>.

2. Clique em **Entrar com GitHub** e conclua o fluxo de autenticação. O Raycast será aberto novamente.

3. Selecione o repositório no qual você deseja Copilot trabalhar.

4. Selecione o problema ao qual você deseja atribuir Copilot.

5. Opcionalmente, selecione um branch base para o pull request de Copilot.
   Copilot criará uma nova ramificação com base nesse branch e, em seguida, enviará por push as alterações para uma solicitação de pull direcionada a esse branch.

6. Opcionalmente, selecione um custom agent com comportamento especializado e ferramentas no menu suspenso. Para saber mais, confira [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).

7. Opcionalmente, você pode usar o menu suspenso para selecionar o modelo que Copilot irá utilizar. Se o modelo selecionado der suporte ao raciocínio configurável, você também poderá usar o menu suspenso para selecionar o nível de raciocínio. Para obter mais informações, consulte [Alterando o modelo de IA para GitHub Copilot agente de nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).

8. Opcionalmente, forneça instruções adicionais. Elas serão passadas para Copilot junto com o conteúdo do seu problema.

9. Pressione <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows) para atribuir o problema.

Copilot iniciará uma nova sessão.
Copilot trabalhará na tarefa e enviará por push as alterações à solicitação de pull e, em seguida, adicionará você como revisor quando terminar, disparando uma notificação.

> \[!NOTE]
>
> Se você não conseguir selecionar um repositório específico ao iniciar uma tarefa, a organização que possui o repositório poderá ter habilitado OAuth app restrições de acesso. Para saber como solicitar aprovação para o "GitHub Copilot para Raycast", OAuth appconsulte [Solicitar aprovação da organização para aplicativos OAuth](/pt/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).

## Acompanhando suas sessões

1. Abra o Raycast, pesquise "Copilot", localize o comando **Exibir Tarefas** e pressione <kbd>Enter</kbd>.
2. Clique em **Entrar com GitHub** e conclua o fluxo de autenticação. O Raycast será aberto novamente.
3. Você verá uma lista de suas tarefas. Selecione uma tarefa e use os seguintes atalhos de teclado:
   * Para ver os logs de sessão ao vivo, pressione <kbd>Enter</kbd>. Os logs são atualizados em tempo real, para que você possa monitorar Copiloto progresso sem sair do Raycast.
   * Para abrir os logs de sessão no navegador, pressione <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows).
   * Para abrir a solicitação de pull vinculada, pressione <kbd>Command</kbd>+<kbd>P</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>P</kbd> (Windows).

> \[!NOTE]
> Se você não conseguir ver algumas tarefas no Raycast, a organização que possui o repositório poderá ter habilitado OAuth app restrições de acesso. Para saber como solicitar aprovação para o "GitHub Copilot for Raycast", OAuth appconsulte [Solicitar aprovação da organização para aplicativos OAuth](/pt/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).

## Leitura adicional

* [Gerenciar sessões de agente](/pt/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)
* [Práticas recomendadas para usar GitHub Copilot para trabalhar em tarefas](/pt/copilot/tutorials/cloud-agent/get-the-best-results)