# Usando o agente de nuvem do Copilot na CLI do GitHub

Iniciar e acompanhar sessões Copilot cloud agent a partir de GitHub CLI.

> \[!NOTE]
> O `agent-task` conjunto de comandos só está disponível na v2.80.0 ou posterior do GitHub CLI. Esse conjunto de comandos é um prévia pública e está sujeito a alterações.

## Iniciando uma sessão

Você pode iniciar uma nova Copilot cloud agent sessão com o `gh agent-task create` comando.

Ao executar o comando sem argumentos, você será solicitado a inserir um prompt.
Copilot cloud agent atua no prompt e abre um pull request no repositório atual.

Você pode usar opções de linha de comando para:

* Fornecer o prompt (`gh agent-task create "Example prompt"`)
* Escolher um branch base, em vez de usar o branch padrão do repositório (`--base`)
* Selecionar um repositório, em vez de direcionar para o repositório atual (`--repo`)
* Acompanhar o log de sessão em tempo real (`--follow`)

Para ver todas as opções disponíveis, execute `gh agent-task create --help`.

## Acompanhando suas sessões

Você pode ver uma lista de suas sessões de agente em execução e anteriores com o `gh agent-task list` comando. A saída mostrará uma lista de suas sessões recentes.

Para ver mais informações sobre uma sessão específica, use o comando `gh agent-task view`. Por exemplo, para exibir informações sobre a sessão associada à pull request nº 123 no repositório `monalisa/bookstore`, execute `gh agent-task view --repo monalisa/bookstore 123`.

Para exibir os logs de sessão, adicione a opção `--log`. Opcionalmente, use a opção `--follow` para transmitir logs ao vivo enquanto o agente trabalha.

Para ver todas as opções disponíveis, execute `gh agent-task list --help` ou `gh agent-task view --help`.

## 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)