{"meta":{"title":"Sobre agentes personalizados","intro":"Custom agents aprimore Copilot com assistência adaptada às suas necessidades.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/concepts","title":"Conceitos"},{"href":"/pt/copilot/concepts/agents","title":"Agentes"},{"href":"/pt/copilot/concepts/agents/cloud-agent","title":"Cloud agent"},{"href":"/pt/copilot/concepts/agents/cloud-agent/about-custom-agents","title":"Agentes personalizados"}],"documentType":"article"},"body":"# Sobre agentes personalizados\n\nCustom agents aprimore Copilot com assistência adaptada às suas necessidades.\n\n## Sobre o custom agents\n\nCustom 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.\n\nVocê 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.\n\nO agent profile define o comportamento de custom agent. Quando você atribui o agente a uma tarefa ou problema, ele instancia o custom agent.\n\n## Formato Agent profile\n\nAgent profiles são arquivos markdown com frontmatter YAML. Em sua forma mais simples, eles incluem:\n\n* **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.\n* **Descrição**: explica a finalidade e os recursos do agente.\n* **Prompt**: instruções personalizadas que definem o comportamento e a experiência do agente.\n* **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.\n\nAgent profiles também pode incluir configurações de servidor MCP usando a `mcp-servers` propriedade.\n\n### Exemplo agent profile\n\nEste exemplo é básico agent profile com nome, descrição e prompt configurados.\n\n```text\n---\nname: readme-creator\ndescription: Agent specializing in creating and improving README files\n---\n\nYou 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.\n\nFocus on the following instructions:\n- Create and update README.md files with clear project descriptions\n- Structure README sections logically: overview, installation, usage, contributing\n- Write scannable content with proper headings and formatting\n- Add appropriate badges, links, and navigation elements\n- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository\n- Make links descriptive and add alt text to images\n```\n\n## Onde você pode configurar custom agents\n\nVocê pode definir agent profiles em níveis diferentes:\n\n* **Nível do repositório**: crie `.github/agents/CUSTOM-AGENT-NAME.md` em seu repositório para agentes específicos do projeto.\n* **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.\n* **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.\n\nPara 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).\n\n## Onde você pode usar custom agents\n\n> \\[!NOTE]\n> Custom agents estão em prévia pública para IDEs JetBrains, Eclipse e Xcode e estão sujeitos a alterações.\n\nDepois de criar custom agents, eles ficam disponíveis para:\n\n* **Copilot cloud agent em GitHub.com**: a guia e o painel de agentes, atribuição de problemas e solicitações pull\n* **Copilot cloud agent em IDEs**: Visual Studio Code, IDEs da JetBrains, Eclipse e Xcode\n* **GitHub Copilot CLI**\n\nVocê 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.\n\nPara 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).\n\n## Próximas Etapas \n\nPara criar seu próprio custom agents, confira:\n\n* [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)\n* [Criando e usando agentes personalizados para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)\n* [Guia de personalização rápida do Copilot](/pt/copilot/reference/customization-cheat-sheet)"}