Pular para o conteúdo principal
O Devin Local oferece várias maneiras de personalizar o funcionamento do agente nos seus projetos. Use esta tabela para escolher a opção mais adequada: Como o Devin Local compartilha a infraestrutura de agente com o Devin CLI, todas as personalizações usam o formato e a descoberta do Devin CLI, e uma personalização criada para um funciona no outro. Para reutilizar as regras do projeto e os fluxos de trabalho de outro agente tanto no Desktop quanto na nuvem, comece pelo prompt de migração.

Customize

A página Customize na janela agentes tem as abas Plugins, Habilidades, MCPs, Hooks, Regras e Subagentes. Cada aba mostra o que o agente carregou, além do que seu repositório, sua organização e sua conta oferecem. Para abri-la, clique em Customize na barra lateral do agente.

Regras

Regras são instruções persistentes que definem como o agente se comporta no seu projeto. Elas são injetadas no contexto do agente no início de cada sessão, o que garante um comportamento consistente em toda a sua equipe. Entre os usos mais comuns das regras estão padrões de código, diretrizes de arquitetura, bibliotecas preferenciais, convenções de testes e restrições específicas do projeto.

AGENTS.md

A maneira mais simples de adicionar regras é criar um arquivo AGENTS.md na raiz do seu projeto. Ele usa Markdown simples, sem frontmatter:
AGENTS.md, AGENTS.local.md (para regras pessoais que você mantém fora do controle de versão) e AGENT.md são todos lidos como regras sempre ativas. O agente os lê na raiz do espaço de trabalho e em cada diretório entre a raiz do espaço de trabalho e o diretório em que está trabalhando. Assim, um AGENTS.md em um subdiretório fornece orientações específicas para aquele diretório.

Arquivos de regras

Para ter mais controle, coloque uma regra por arquivo em .devin/rules/*.md. Cada arquivo pode definir quando se aplica com o campo trigger no frontmatter:
.devin/global_rules.md é um único arquivo sempre ativo. Coloque os mesmos arquivos no seu diretório pessoal (~/.devin/rules/*.md, ~/.devin/global_rules.md) para aplicá-los a todos os projetos. Os arquivos legados .windsurf/rules/*.md, .windsurf/global_rules.md e .windsurfrules são importados por padrão. Os arquivos de regras em .devin/rules/ e em .windsurf/rules/ são todos carregados; quando existem os dois arquivos global_rules.md, apenas .devin/global_rules.md é carregado. Consulte regras e AGENTS.md para ver a lista completa de arquivos, as configurações de importação e as regras de outras ferramentas.

Práticas recomendadas

  • Mantenha as regras curtas e específicas. As regras fazem parte do contexto de toda sessão, portanto consomem tokens a cada mensagem.
  • Prefira uma skill para tudo o que o agente só precisa ocasionalmente e use uma regra para indicar ao agente quais habilidades ele deve usar em cenários específicos.
  • Formate as regras com marcadores, listas numeradas e títulos em Markdown. Esses formatos são mais fáceis de seguir do que um parágrafo longo.
  • Evite regras genéricas como “escreva um bom código”.

Habilidades

As tarefas de engenharia mais difíceis costumam exigir mais do que bons prompts. Elas podem depender de scripts de referência, templates, checklists e outros arquivos de suporte. As habilidades permitem que você reúna tudo isso em pastas que o agente pode invocar. As habilidades usam exposição progressiva: por padrão, apenas o name e a description da skill são exibidos ao modelo. O conteúdo completo do SKILL.md e os arquivos de suporte só são carregados quando o agente decide invocar a skill ou quando você a invoca. Assim, sua janela de contexto continua enxuta, mesmo com muitas habilidades definidas.

Como criar uma skill

Crie um diretório com um arquivo SKILL.md cujo frontmatter YAML defina o nome e a descrição da skill:
  • name: Identificador único da skill (letras minúsculas, números e hifens). É usado para invocá-la.
  • description: Breve explicação exibida ao modelo para ajudá-lo a decidir quando invocar a skill. Seja específico sobre o que a skill faz e quando usá-la.
Coloque os arquivos de suporte na pasta da skill, junto com o SKILL.md. Eles ficam disponíveis para o agente quando a skill é invocada:

Como invocar habilidades

Quando sua requisição corresponder à descrição de uma skill, o agente invoca essa skill automaticamente e segue as instruções dela. Você também pode invocar uma skill pelo nome com /skill-name para garantir que ela seja usada.

Escopos de skill

Consulte a documentação de habilidades do Devin CLI para saber mais sobre gatilhos de skill, permissões e habilidades de terceiros, e Como criar habilidades para orientações sobre como escrevê-las.

Plugins

Plugins são pacotes instaláveis que adicionam habilidades, regras, hooks, servidores MCP e subagentes ao agente. Instale um plugin a partir de um repositório do GitHub, de uma URL do git, de uma subpasta de um repositório ou de uma pasta local; as habilidades dele ficam disponíveis como comandos /<plugin>:<skill>. Consulte plugins para saber mais sobre o formato de plugin, os comandos devin plugins e a governança.
Aqui, Plugins se refere aos plugins do agente Devin. Eles não têm relação com os Plugins do Windsurf, que levam o Devin ao JetBrains, ao VS Code e a outros editores, nem com as extensões do editor que você instala no Devin Desktop: ambos estendem a IDE, e não o agente.

Servidores MCP

O MCP (Model Context Protocol) é um protocolo que permite ao agente usar ferramentas de serviços externos, como GitHub, bancos de dados e rastreadores de problemas. Consulte a documentação oficial do MCP para mais informações.

Instalação de servidores MCP

Abra a página Customize na janela agentes e clique em MCPs. Escolha o escopo no seletor Install MCPs for, na parte superior — por exemplo, This computer.
  • This computer lista os servidores que seu agente local carrega para as pastas abertas na janela. Você pode ativar ou desativar um servidor, abrir o arquivo de configuração dele ou atualizar a lista.
  • Available lista os servidores dos seus registros MCP. Clique em Install em um servidor para adicioná-lo.
Os administradores do Enterprise gerenciam os registros nas configurações da equipe, em MCP & ACP. A aba Registro MCP tem um controle que, além da lista de permissões de MCP, permite servidores que correspondam a uma entrada do registro. Ela também tem uma configuração Registry (Configure) para as URLs dos registros. Quando há vários registros configurados, o Devin Desktop usa a união de todos eles. Registros personalizados devem seguir o schema oficial de Registro MCP.

Configuração

Os servidores MCP são configurados em arquivos de configuração na sua máquina local. O local do arquivo depende do escopo: O Devin Local oferece suporte aos transportes stdio, Streamable HTTP e SSE, além de OAuth para cada um deles.

Permissões

Por padrão, o agente pede aprovação antes de chamar qualquer ferramenta MCP. Consulte Permissões de MCP para saber como permitir uma ferramenta ou um servidor e como os administradores podem permitir integrações confiáveis por padrão.

Reautenticação

Quando as credenciais OAuth armazenadas de um servidor expiram, o servidor passa a exibir o estado Needs authentication. Esse estado aparece na lista This computer, no cartão Available e na página de detalhes do servidor. Clique em Authenticate para limpar as credenciais armazenadas e executar novamente o fluxo de autorização no navegador.

Hooks

Os hooks executam lógica personalizada em eventos do ciclo de vida do agente, por exemplo, antes de uma chamada de ferramenta. Cada hook é um comando de shell ou um prompt para um LLM. Use hooks para impor políticas, adicionar contexto, registrar ações, modificar permissões ou se integrar a sistemas externos. Os hooks são configurados em .devin/hooks.v1.json, no seu projeto ou no nível do usuário. Por exemplo, este hook executa um script antes de cada comando de shell e pode bloquear o comando:
Os Hooks não são carregados nem executados enquanto um workspace estiver aberto no Modo Restrito. Consulte hooks para ver os eventos de hook, o formato de configuração, os códigos de saída e exemplos.