Guia do Devin Desktop para administradores do Enterprise
Objetivo Este guia ajuda administradores de plataforma / experiência do desenvolvedor no Enterprise a planejar, implementar e operar o Devin Desktop para organizações com grandes equipes corporativas. Ele é intencionalmente prescritivo e inclui links para guias detalhados de “como fazer” sobre cada tópico. Use-o tanto como um guia para leitura completa quanto como uma checklist durante a integração.
- Público e pré-requisitos
- Checklist de início rápido
- Confirme as configurações da organização
- Configure o SSO (Okta, Microsoft Entra ID, Google; consulte a documentação de SAML para outras opções)
- Ative o SCIM e mapeie grupos do IdP → Teams do Devin Desktop
- Defina o modelo de função e permissão (privilégio mínimo)
- Configure o Portal de Administração: visualização de Teams e controles de segurança
- Distribua clientes/extensões do Devin Desktop aos usuários finais
- Visualize dashboards de análises e tokens de acesso da API
Use esta lista como seu acompanhamento de implantação do “Dia 0”.
- Conceitos centrais do Devin Desktop
- Equipe – coleções simples de membros; sem equipes aninhadas. As equipes (também chamadas de Grupos) orientam a atribuição de funções e o agrupamento para análises, permitindo definir o escopo das permissões e visualizar métricas de uso por grupo.
- Funções e permissões – RBAC predefinido; os administradores são os principais responsáveis pelo gerenciamento de equipes, pelas configurações de recursos do Devin Desktop e por análises. As funções nativas geralmente cobrem essas necessidades, mas criar uma função personalizada com a permissão analytics-view permite que gerentes e líderes de equipe vejam métricas de suas próprias equipes. (documentação do RBAC)
- Portal de Administração – UI centralizada para gerenciamento de usuários e equipes, uso de créditos, configuração de SSO, controles de recursos (pesquisa na web, MCP, Deploys), dashboards de análises/exportação de relatórios, chaves de serviço para uso da API e controles de funções e permissões.
- Agentes e workspaces – a IDE do Devin Desktop e os plugins do JetBrains são agênticos
3.1 Visão geral do Portal de Administração
O Portal de Administração oferece gerenciamento centralizado de todos os recursos Enterprise do Devin Desktop por meio de uma interface web intuitiva. Os principais recursos incluem:Gerenciamento de usuários e equipes
- Adicionar, remover e gerenciar usuários em toda a organização
- Configurar equipes com as funções atribuídas corretamente
- Monitoramento do status e da atividade dos usuários
Autenticação e segurança
- Configure a integração com SSO dos principais provedores de identidade
- Configure o provisionamento SCIM para o gerenciamento automatizado do ciclo de vida dos usuários
- Gerencie o controle de acesso baseado em função (RBAC)
- Crie e gerencie chaves de serviço para automações de API com permissões por escopo
Controles de recursos
Importante: Esses controles de recursos afetam o comportamento de toda a sua organização e só podem ser modificados por administradores. Novos recursos importantes com implicações de privacidade de dados são lançados no estado “desativado” por padrão, para garantir que você tenha controle sobre quando e como eles são ativados.As configurações da equipe permitem ativar, desativar ou restringir recursos do Devin Desktop para todos os membros: modelos disponíveis e o modelo padrão, execução automática no terminal e permissões de comandos, sandboxing, servidores MCP e registros, pesquisa na web, extensões e o marketplace de extensões, compartilhamento de conversas, Devin e muito mais. Gerencie essas configurações no app do Devin em Settings → Enterprise → Devin Desktop ou no painel legado do Windsurf em windsurf.com/team/settings. Consulte a referência de controles de administrador do Devin Desktop para ver cada configuração da equipe, o que ela faz e quais planos a incluem, além das políticas de dispositivo MDM e dos arquivos em nível de sistema que você pode implantar em conjunto. As configurações que armazenam dados adicionais ou telemetria estão sinalizadas nessa página. O Admin Portal também gerencia estas integrações: Revisões de PR (integração com o GitHub)
- Instale o Devin Desktop na organização do GitHub da sua equipe
- Ative a automação de revisão de PR e a edição de descrições
- Saiba mais sobre Windsurf PR Reviews
- Recomendamos o Devin Review como nossa experiência nova e aprimorada de revisão de código. Saiba mais.
- Organize conhecimento de fontes do Google Drive para suas Teams de desenvolvimento
- Importe e organize documentação e recursos internos
- Saiba mais sobre a Base de conhecimento
- Gerenciamento de Identidade e Acesso
Recomendação: Use SSO + SCIM sempre que possível para provisionamento automatizado, desprovisionamento e gerenciamento de grupos.
4.1 Single Sign-On (SSO)
Consulte o Guia de configuração de SSO e SCIM para ver a configuração passo a passo para Okta, Microsoft Entra ID, Google e SAML genérico.
4.2 Provisionamento SCIM
- Por que – gerenciamento automatizado do ciclo de vida dos usuários e da associação a Teams em escala
- Capacidades
- Criar / desativar usuários automaticamente
- Criar Teams automaticamente (ou gerenciá-las manualmente)
- Os usuários podem pertencer a múltiplas Teams
- Criação personalizada de Teams via API do SCIM (documentação)
- Estratégias de mapeamento
- 1 grupo do IdP → 1 Teams do Devin Desktop (simples, mais comum)
- Prefixos de grupos funcionais vs. baseados em projeto (por exemplo,
proj-foo-devs)
- Pontos a decidir
- Quais grupos excluir (por exemplo, estagiários, terceirizados)
- Regras de renomeação quando os nomes dos grupos do IdP mudarem
- Cuidado: o SCIM deve continuar sendo sua fonte de verdade — misturar SCIM com atualizações manuais / via API pode gerar divergências. Use a API principalmente para adicionar grupos complementares.
- Gerenciamento de usuários e equipes em escala
- Equipe plana → projete a taxonomia de equipes com cuidado (não há aninhamento para compensar)
- Os usuários podem pertencer a múltiplos grupos. Os grupos são usados para visualizar análises
- Atualmente, o SCIM não oferece suporte à atribuição de funções aos usuários. O SCIM oferece suporte apenas à atribuição de usuários a Grupos
- Análises e acesso à API
6.1 Análises nativas
As análises mostram a porcentagem do código escrita pelo Devin Desktop, ajudando a quantificar o impacto—visualize seus dashboards em análises da equipe.
6.2 APIs
- Gere chaves de serviço em Configurações da equipe → Chaves de serviço. Defina o escopo das chaves com o privilégio mínimo necessário.
- Para relatórios mais avançados, consulte a Referência da API de análises.
- Para gerenciamento de equipes, consulte a API do SCIM – Teams personalizadas.
- Considerações operacionais
- Páginas de status – monitore o status do serviço em tempo real: Devin Desktop, Anthropic, OpenAI
- Canais de suporte – windsurf.com/support
- Preparando os usuários finais para o sucesso
- Oriente os usuários finais a consultar o guia de instalação do Devin Desktop para instalar a extensão adequada ou o cliente para desktop.
- Publique uma página interna “Primeiros passos com o Devin Desktop” (com link para a documentação oficial)
- Realize sessões de onboarding ao vivo / grave demos curtas
- Selecione templates de projetos iniciais e prompts de exemplo
- Colete feedback por meio de uma pesquisa após 2 semanas; ajuste conforme necessário