# Usando aplicativos de agente

Inicie um agente desenvolvido por um parceiro a partir de uma issue, de um comentário em uma solicitação de pull request ou da interface dos Agentes em GitHub.

> \[!NOTE] Agent apps are currently in prévia pública and subject to change.

## Introdução

Aplicativos de agente permite delegar tarefas a agentes desenvolvidos por parceiros a partir do GitHub. Para obter uma visão geral, consulte [Sobre aplicativos de agente](/pt/copilot/concepts/agents/agent-apps).

Antes que você possa usar um aplicativo agent, o GitHub App deve ser instalado na conta ou organização que possui o repositório, e os recursos do agente devem ser habilitados para o aplicativo. Se o repositório pertencer a uma organização que pertence a uma empresa, a política "Aplicativos de agente" Copilot também deverá ser habilitada nas configurações da empresa.

## Autorizando um aplicativo de agente

A primeira vez que você usar um aplicativo agent, GitHub solicitará que você autorize o aplicativo por meio de um fluxo OAuth. Siga as instruções para autorizar o aplicativo antes de o agente ser executado. Para obter mais informações, consulte [Autorizando aplicativos GitHub](/pt/apps/using-github-apps/authorizing-github-apps).

## Iniciar um agente pela interface do usuário do Agentes

1. Abra o painel ou a guia de agentes:

   * No repositório, abra a **aba <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg> Agentes**.
   * ```
               **Navegue até a página de agentes**: acesse [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text). Você também pode chegar aqui abrindo o painel de agentes e clicando em **Exibir tudo**.
     ```
   * **Abra o painel de agentes**: clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg> na barra de navegação no canto superior direito de GitHub.
2. Na caixa de prompt, selecione o aplicativo agent que você deseja usar.
3. Digite um prompt descrevendo sua solicitação e inicie a tarefa.

## Iniciando um agente com base em um problema

Você pode atribuir um aplicativo agent a um problema da mesma maneira que atribui agente de nuvem Copilot.

1. Navegue até o problema em que você deseja que o agente trabalhe.
2. Na barra lateral, em "Responsáveis", atribua o aplicativo agent ao problema.

O agente inicia o trabalho sobre o problema e relata seu progresso.

## Iniciando um agente a partir de um comentário em um pull request

Você pode pedir a um(a) aplicativo agent que faça alterações ou execute outras tarefas ao mencioná-lo em um comentário na pull request.

1. Navegue até a solicitação de pull na qual você deseja que o agente trabalhe.
2. Adicione um comentário que mencione o agente e descreva o que você deseja que ele faça, por exemplo `@AGENT-NAME add a feature flag for the new checkout flow`. Escolha o agente no seletor de preenchimento automático.

O agente responde ao seu comentário e trabalha nas alterações solicitadas.

## Usando aplicativos de agente em GitHub Mobile

Você pode iniciar aplicativos de agente a partir dos mesmos pontos de entrada em GitHub Mobile. Para obter mais informações sobre como usar agentes no celular, consulte [Using Copilot cloud agent on GitHub Mobile](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-mobile).

## Faturamento

Aplicativos de agente são alimentados por agente de nuvem Copilot. Quando você usa um aplicativo agent, o uso de IA é cobrado em sua Copilot assinatura e as sessões consomem AI credits da mesma maneira que agente de nuvem Copilot. Consulte [Cobrança do GitHub Copilot](/pt/billing/concepts/product-billing/github-copilot-billing).