Skip to main content
Plugins estão em beta fechada. Para solicitar acesso, entre em contato com support@cognition.ai. O comportamento e a configuração podem mudar em versões futuras.

​
O que são plugins?

Um plugin agrupa skills — e, opcionalmente, regras, hooks, servidores MCP e subagentes — para poder ser instalado e reutilizado como uma unidade. Consulte a referência de plugins para conhecer o formato de arquivo e o que um plugin pode incluir. Plugins gerenciados permitem que um admin instale plugins de forma centralizada, pelo web app do Devin, para que se apliquem a todos na org ou Enterprise — sem configuração por usuário. Isso cobre sessões em nuvem do Devin e usuários do Devin CLI conectados à conta (a configuração no nível de enterprise/account também se aplica ao CLI — consulte sessões em nuvem vs. o CLI). Quando um plugin é instalado, suas skills ficam automaticamente disponíveis para o Devin como comandos /<plugin>:<skill>. Esta página aborda o lado do web app dos plugins: manifestos gerenciados, escopos e importações.

​
Onde configurá-los

Acesse Configurações → Recursos → Plugins. A página tem duas abas:
  • Marketplace — navegue pelos plugins (o catálogo oficial do Devin e quaisquer plugins que sua org ou Enterprise tenha adicionado) e instale-os. Instalar um plugin o adiciona ao manifest do escopo escolhido como plugin obrigatório, então ele é instalado para todos nesse escopo.
  • Configuração — edite o manifest bruto do plugin em JSON e importe seu próprio plugin como uma pasta ou arquivo .zip (ou crie um no editor).
O acesso é controlado por permissões:
  • Admins da org (acesso às configurações da organização) gerenciam o manifest da org.
  • Admins do Enterprise (acesso às configurações do Enterprise) também gerenciam o manifest compartilhado do Enterprise.

​
O manifest

O manifest é um único documento JSON com três listas:
  • requiredPlugins — instalados para todos dentro do escopo (recursivamente, incluindo todos os plugins dos quais dependem).
  • optionalPlugins — uma lista de permissões que autoriza plugins sem instalá-los automaticamente; usada para abrir exceções para uma entrada proibida.
  • forbiddenPlugins — uma lista de bloqueio de identidades de plugin ou padrões glob.
O manifest é armazenado na íntegra; o agente valida a origem completa no momento da instalação. Consulte a referência de plugins para ver as formas de origem que cada entrada pode assumir e a semântica completa de dependências e governança.

​
Adicionando seus próprios plugins

Dependendo de onde o plugin está, adicione-o de uma destas formas:

​
Importando um pacote de plugin

Na aba Configuração, a seção Plugin importado permite importar um plugin como pasta ou arquivo .zip, ou criar um diretamente no editor. Ao salvá-lo, ele é adicionado ao manifest como um plugin obrigatório (instalando-o para todos no escopo); ao excluí-lo, a referência é removida. Esta é uma boa opção para um plugin que você não quer hospedar em um repositório Git (ou não pode).

​
Como usar um repo privado de skills

Aponte o manifest diretamente para o repo privado — em geral, você não precisa incorporá-lo ao seu snapshot de ambiente. Qualquer repo privado que o Devin já consiga acessar pela sua integração com o Git é instalado automaticamente. Use o formato de URL do git ou git-subdir para instalar um plugin a partir de uma subpasta de um repo compartilhado. (Os usuários da CLI cobertos pelo mesmo manifest fazem o fetch com suas próprias credenciais locais do git, então também precisarão de acesso ao repo.) Se o repo não puder ser acessado pela sua integração com o Git, importe-o como um pacote (acima) ou clone-o durante a configuração do ambiente e faça referência a ele com um caminho local.

​
Como as atualizações são distribuídas

  • Alterações no manifest (Configurações → Recursos → Plugins) passam a valer na próxima sessão.
  • Alterações no plugin — ao fazer merge na branch que o plugin acompanha, elas chegam automaticamente às novas sessões em algumas horas. Fixe o plugin em um SHA de commit para controlar as atualizações por conta própria; na CLI, devin plugins update atualiza imediatamente.
  • As sessões em execução mantêm o que carregaram no início — as atualizações nunca alteram uma sessão no meio da execução.

​
Escopo e herança

Os manifests gerenciados existem em até dois níveis:
  • Contas independentes têm um único manifest de conta que se aplica a todos.
  • Enterprises têm um manifest de enterprise compartilhado que é herdado por cada org subordinada, além de um manifest por org em um nível abaixo. A visualização do Marketplace mostra ambos, e os admins do Enterprise podem optar por instalar um plugin no escopo do Enterprise (aplica-se em toda parte) ou um admin da org pode instalá-lo apenas na própria org.
Esses manifests ficam no topo da hierarquia geral de plugins, acima da configuração de plugins nos níveis de repo e de usuário. Consulte herança e níveis para conhecer os outros níveis e as regras de autoridade.

​
Sessões em nuvem vs. a CLI

Tanto as sessões em nuvem do Devin quanto a Devin CLI aplicam o manifest de enterprise/account — os plugins obrigatórios são instalados, e as proibições também são impostas aos usuários da CLI que estiverem conectados à conta. O manifest de org se aplica apenas a sessões em nuvem. A CLI se autentica no nível da conta e não tem contexto de org, então exigências e proibições no nível da org não se aplicam aos usuários da CLI. Coloque no manifest de enterprise/account tudo o que você precisar aplicar na CLI (ou em nível da conta) e use o manifest de org para adições específicas da org nas sessões em nuvem.

​
Saiba mais

  • Skills — os procedimentos SKILL.md que os plugins incluem
  • Referência de plugins da CLI — formato de arquivo do plugin, criação e instalação por usuário
  • Playbooks — templates de prompt reutilizáveis associados a sessões