# Invocando agentes personalizados

Use agentes personalizados, habilidades e servidores MCP no Copilot CLI para expandir seus recursos.

## Utilize custom agents

A custom agent é uma versão especializada de Copilot.
Custom agents ajudar Copilot a lidar com workflows exclusivos, convenções específicas de codificação e casos de uso especializados.

Copilot CLI inclui um grupo padrão custom agents para tarefas comuns:

<table>
  <thead>
    <tr>
      <th style="width:20%">Agente</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Explorar</td>
      <td>Executa uma análise rápida da base de código, permitindo que você faça perguntas sobre seu código sem adicionar ao contexto principal.</td>
    </tr>
    <tr>
      <td>Tarefa</td>
      <td>Executa comandos como testes e compilações, fornecendo breves resumos em caso de sucesso e saída completa em caso de falha.</td>
    </tr>
    <tr>
      <td>Uso geral</td>
      <td>Lida com tarefas complexas e de várias etapas que exigem o conjunto de ferramentas completo e o raciocínio de alta qualidade, em execução em um contexto separado para manter sua conversa principal claramente focada.</td>
    </tr>
    <tr>
      <td>Revisão de código</td>
      <td>Revê as mudanças com o foco em destacar apenas problemas genuínos, minimizando o ruído.</td>
    </tr>
  </tbody>
</table>

O modelo de IA que está sendo usado pela CLI pode optar por delegar uma tarefa a um processo de subagente subsidiário, que opera usando um custom agent com experiência específica, se julgar que isso resultaria em uma conclusão mais eficaz do trabalho. O modelo pode igualmente escolher lidar com o trabalho diretamente no agente principal.

Você pode definir sua própria custom agents usando arquivos Markdown, chamados agent profiles, que especificam qual experiência o agente deve ter, quais ferramentas ele pode usar e quaisquer instruções específicas sobre como ele deve responder.

Você pode definir custom agents no nível de usuário, repositório, organização ou empresa:

| Tipo                                                             | Localização                                                                                                                                                                                                                                                                                                                     | Scope                                   |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Nível do usuário custom agent                                    | diretório local `~/.copilot/agents`                                                                                                                                                                                                                                                                                             | Todos os projetos                       |
| Nível do repositório custom agent                                |                                                                                                                                                                                                                                                                                                                                 |                                         |
| `.github/agents` diretório em seus repositórios locais e remotos | Projeto atual                                                                                                                                                                                                                                                                                                                   |                                         |
| Nível da organização custom agent                                | O diretório `/agents` no repositório `.github` ou `.github-private` da organização                                                                                                                                                                                                                                              | Todos os projetos dentro da organização |
| Nível empresarial custom agent                                   | O diretório `/agents` no repositório `.github-private` de uma organização designada em configurações corporativas. Para obter mais informações, consulte [Preparando-se para usar agentes personalizados em sua empresa](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). | Todos os projetos na conta corporativa  |

No caso de conflitos de nomenclatura (em que os agentes compartilham o mesmo nome de arquivo), um agente no nível do usuário substitui um agente no nível do repositório, um agente no nível do repositório substitui um agente no nível da organização e um agente no nível da organização substitui um agente de nível empresarial.

Custom agents pode ser usado de três maneiras:

* Usando o comando de barra na interface interativa da CLI para selecionar na lista de custom agents disponíveis:

  ```shell
  /agent
  ```

* Chamando o custom agent diretamente em um prompt:

  ```shell
  Use the refactoring agent to refactor this code block
  ```

Copilot inferirá automaticamente o agente que você deseja usar.

* Especificando a opção custom agent de linha de comando que você deseja usar. Por exemplo:

  ```shell
  copilot --agent=refactor-agent --prompt "Refactor this code block"
  ```

Para obter mais informações, consulte [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).

## Utilizar habilidades

Você pode criar habilidades para aprimorar a capacidade de Copilot executar tarefas especializadas com instruções, scripts e recursos.

Para obter mais informações, consulte [Adicionando habilidades de agente para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-skills).

## Adicionar um servidor MCP

Copilot CLI vem com o GitHub servidor MCP já configurado. Esse servidor MCP permite que você interaja com recursos em GitHub.com— por exemplo, permitindo mesclar solicitações de pull da CLI.

Para estender a funcionalidade disponível para você em Copilot CLI, você pode adicionar mais servidores MCP:

1. Use o seguinte comando de barra:

   ```shell
   /mcp add
   ```

2. Preencha os detalhes do servidor de MCP que você deseja adicionar, usando a tecla <kbd>Tab</kbd> para mover-se entre os campos.

3. Pressione <kbd>Ctrl</kbd>+<kbd>S</kbd> para salvar os detalhes.

Os detalhes dos servidores de MCP configurados são armazenados no arquivo `mcp-config.json`, que está localizado, por padrão, no diretório `~/.copilot`. Esse local pode ser alterado definindo a variável de ambiente `COPILOT_HOME`. Para obter informações sobre a estrutura JSON de uma definição de servidor, consulte [Configurar servidores MCP para seu repositório](/pt/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).

Para obter informações mais detalhadas sobre como adicionar e gerenciar servidores Copilot CLIMCP, consulte [Adicionando servidores MCP para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).

## Próximas Etapas 

Para saber como orientar e refinar o comportamento do agente durante a execução da tarefa para manter o trabalho no controle, consulte [Direcionando agentes no GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents).