# Sobre agentes personalizados

Custom agents aprimore Copilot com assistência adaptada às suas necessidades.

## Sobre o custom agents

Custom agents são versões especializadas do Copilot agente que você pode adaptar aos seus fluxos de trabalho exclusivos, convenções de codificação e casos de uso. Eles agem como colegas personalizados que seguem seus padrões, usam as ferramentas certas e implementam práticas específicas da equipe. Você define esses agentes uma vez em vez de fornecer repetidamente as mesmas instruções e contexto.

Você define custom agents usando arquivos Markdown chamados agent profiles. Esses arquivos especificam prompts, ferramentas e servidores MCP. Isso permite codificar suas convenções, estruturas e resultados desejados diretamente em Copilot.

O agent profile define o comportamento de custom agent. Quando você atribui o agente a uma tarefa ou problema, ele instancia o custom agent.

## Formato Agent profile

Agent profiles são arquivos markdown com frontmatter YAML. Em sua forma mais simples, eles incluem:

* **Nome** (opcional): um nome de exibição para o custom agent. Caso omitido, o nome do arquivo do agente será usado como seu identificador e nome de exibição padrão.
* **Descrição**: explica a finalidade e os recursos do agente.
* **Prompt**: instruções personalizadas que definem o comportamento e a experiência do agente.
* **Ferramentas** (opcional): ferramentas específicas que o agente pode acessar. Por padrão, os agentes podem acessar todas as ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidor MCP.

Agent profiles também pode incluir configurações de servidor MCP usando a `mcp-servers` propriedade.

### Exemplo agent profile

Este exemplo é básico agent profile com nome, descrição e prompt configurados.

```text
---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
```

## Onde você pode configurar custom agents

Você pode definir agent profiles em níveis diferentes:

* **Nível do repositório**: crie `.github/agents/CUSTOM-AGENT-NAME.md` em seu repositório para agentes específicos do projeto.
* **Nível da organização**: crie `/agents/CUSTOM-AGENT-NAME.md` no repositório `.github` ou `.github-private` da organização para maior disponibilidade dentro da organização.
* **No nível empresarial**: crie `/agents/CUSTOM-AGENT-NAME.md` no repositório `.github-private` de uma organização que um proprietário da empresa designou nas configurações da empresa para ficar disponível em todos os repositórios da empresa.

Para obter mais informações, consulte [Preparando-se para usar agentes personalizados em sua organização](/pt/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents) e [Preparando-se para usar agentes personalizados em sua empresa](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).

## Onde você pode usar custom agents

> \[!NOTE]
> Custom agents estão em prévia pública para IDEs JetBrains, Eclipse e Xcode e estão sujeitos a alterações.

Depois de criar custom agents, eles ficam disponíveis para:

* **Copilot cloud agent em GitHub.com**: a guia e o painel de agentes, atribuição de problemas e solicitações pull
* **Copilot cloud agent em IDEs**: Visual Studio Code, IDEs da JetBrains, Eclipse e Xcode
* **GitHub Copilot CLI**

Você pode usar agent profiles diretamente em Visual Studio Code, IDEs da JetBrains, Eclipse e Xcode. Algumas propriedades podem funcionar de forma diferente ou ser ignoradas entre ambientes.

Para obter mais informações sobre como usar custom agents em Visual Studio Code, consulte [Custom agents em VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents).

## Próximas Etapas 

Para criar seu próprio custom agents, confira:

* [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)
* [Criando e usando agentes personalizados para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)
* [Guia de personalização rápida do Copilot](/pt/copilot/reference/customization-cheat-sheet)