Skip to main content
O Local Hands (acesso à máquina local) permite que uma sessão em nuvem do Devin execute comandos e trabalhe com arquivos no seu próprio computador. Use-o quando a tarefa depender de algo que só existe na sua máquina: um checkout local com alterações não comitadas, um dispositivo na sua rede, uma ferramenta que exige a sua VPN ou logs de um build local. O seu computador não substitui a VM da sessão. O Devin continua com a VM dele e ganha um segundo conjunto de ferramentas, executadas na sua máquina. As duas máquinas têm arquivos, diretórios de trabalho e ambientes separados; o Devin só transfere dados entre elas por meio de chamadas de ferramenta aprovadas por você, como uma cópia de arquivo.
O Local Hands está sendo liberado gradualmente. Se a configuração Local Hands não aparecer para você, o recurso ainda não está disponível para a sua organização.
Local Hands é o nome do recurso; o cartão de acesso e os toasts se referem a ele como local machine access. No cabeçalho da sessão, uma máquina conectada aparece como Local Hands. O Local Hands não é o mesmo que o Devin Connect, que dá ao Devin acesso a redes privadas.

​
Como funciona

1

O Devin solicita acesso

Quando uma tarefa precisa da sua máquina, o Devin publica um cartão Local machine access requested na sessão. O cartão informa o motivo e o horário em que a requisição expira. No Devin Desktop, ele exibe um botão Approve; no navegador, exibe um comando devin connect com um código de pareamento. Você também pode pedir isso diretamente, por exemplo: “execute os testes na minha máquina local”.
2

Você conecta sua máquina

Aprove a requisição na máquina que você quer que o Devin use: clique em Approve no Devin Desktop ou execute devin connect em um terminal. Consulte Conectar sua máquina.
3

O Devin usa as ferramentas locais

As ferramentas locais do Devin ficam disponíveis e o cabeçalho exibe o indicador Local Hands. Você aprova cada chamada de ferramenta, a menos que ative o bypass.
4

A conexão é encerrada

A conexão é encerrada quando você revoga o acesso, interrompe o devin connect ou fecha a janela do Devin Desktop que aprovou a requisição, ou quando a sessão termina. Com isso, as ferramentas locais deixam de ficar disponíveis.

​
Requisitos

  • Uma sessão em nuvem da qual você seja o proprietário. O Devin envia o código de pareamento para a conta do proprietário da sessão, então outras pessoas que visualizem a sessão não conseguem conectar a própria máquina. Sessões sem um usuário para aprovar o acesso, como sessões agendadas, automações e sessões de API executadas por um usuário de serviço, não podem solicitar uma máquina.
  • O Devin CLI ou o Devin Desktop instalado na máquina que você vai conectar, com login feito na mesma conta do Devin proprietária da sessão. No CLI, execute devin auth login.
  • A configuração Local Hands ativada para sua organização. Consulte Disponibilidade.

​
Conecte sua máquina

A forma mais simples é pelo Devin Desktop: abra a sessão nele e clique em Approve. Se você trabalha pelo navegador, copie o comando devin connect exibido no cartão e execute-o em um terminal na máquina que deseja conectar. Cada requisição é de uso único e expira 10 minutos depois de ser criada pelo Devin. Uma nova requisição substitui a anterior, e o código de pareamento antigo deixa de funcionar.
Abra a sessão no Devin Desktop. O cartão exibe Approve e Decline. Clique em Approve para conectar a máquina em que o Devin Desktop está sendo executado. Você não precisa de código de pareamento nem de terminal. Se preferir a CLI, clique em Use the terminal instead para exibir o comando.
Se a requisição tiver expirado, clique em Connect this machine no cartão do Devin Desktop ou em Request a new code no navegador.

​
Privacidade da sessão

Quando você conecta uma máquina a uma sessão da qual é proprietário, o Devin torna a sessão privada: somente você pode enviar mensagens a ela. Isso impede que outras pessoas da sua organização conduzam uma sessão capaz de executar comandos no seu computador. Para não alterar a privacidade da sessão, passe --public:

​
O que o Devin pode fazer na sua máquina

O Devin pode executar comandos de shell, ler e pesquisar arquivos, criar e editar arquivos e copiar arquivos entre a sua máquina e a VM da sessão. O Devin não controla a tela, o teclado nem o mouse da sua máquina. O Computer Use se aplica apenas à VM da sessão.

​
Aprovações

Por padrão, toda chamada de ferramenta local é pausada para pedir sua aprovação. A sessão exibe a ferramenta e seus argumentos com três opções:
  • Allow once: executa esta chamada.
  • Allow for this session: executa esta chamada e as chamadas seguintes da mesma ferramenta, sem prompt, até que a máquina se desconecte.
  • Deny: rejeita esta chamada. O Devin é informado da negação e pode tentar outra abordagem.
Suas regras de permissão do Devin CLI também se aplicam às chamadas de ferramenta locais. Uma regra allow executa a chamada correspondente sem prompt, uma regra deny a bloqueia e uma regra ask exibe um prompt toda vez. Isso inclui as regras que sua organização define em Configurações da equipe.

​
Ignorar permissões locais

Para deixar de receber prompts a cada chamada, clique em Bypass local permissions no cartão de acesso ou no menu Local Hands. A partir daí, as chamadas de ferramenta locais são executadas sem prompt até que a máquina se desconecte. As solicitações pendentes são aprovadas imediatamente. Para que todas as conexões já iniciem no modo Bypass, defina local_tools_bypass_permissions na configuração do Devin CLI. Quando você ativa ou desativa o Bypass pela sessão, a CLI atualiza essa configuração.
Com o Bypass ativado, o Devin pode executar comandos e alterar arquivos no seu computador sem pedir confirmação. Use-o apenas em sessões e tarefas de sua confiança.

​
Chamadas que sempre pedem aprovação

Regras nativas fazem com que algumas chamadas peçam aprovação todas as vezes, mesmo com o bypass ativado. Nem Allow for this session nem suas próprias regras allow conseguem aprová-las. Essas regras abrangem arquivos de credenciais e chaves privadas, escalonamento de privilégios, comandos destrutivos, interpretadores de shell, repositórios de segredos e gravações em perfis de shell e na configuração do Git. O cartão de aprovação informa por que a chamada exige aprovação explícita. Suas regras ask e as regras ask da sua organização funcionam da mesma forma.

​
Desconectar ou revogar o acesso

  • Revogar o acesso: clique em Revoke access no cartão de acesso ou no menu Local Hands. O Devin perde o acesso às ferramentas locais imediatamente.
  • Parar a CLI: pressione Ctrl+C no terminal em que o devin connect está em execução.
  • Fechar o Devin Desktop: a conexão é encerrada quando você fecha a janela do Devin Desktop que aprovou a requisição ou sai do Devin Desktop.
  • Encerrar a sessão: a conexão é encerrada quando a sessão termina.
O devin connect se reconecta automaticamente após uma breve queda de rede. Se a máquina continuar offline ou você interromper o comando, o indicador mostrará a máquina como desconectada. Para se conectar de novo, peça ao Devin que solicite o acesso novamente e use o novo código.

​
Disponibilidade

Os administradores da organização controlam este recurso pelo controle Local Hands em Settings > Devin. Esse controle vem ativado por padrão para organizações que não fazem parte de uma empresa e desativado por padrão para organizações vinculadas a uma empresa. O Local Hands não está disponível quando:
  • A sessão usa um perfil de segurança.
  • As implantações nativas estão desativadas para sua organização.
  • A sessão não tem um usuário para aprovar o acesso (sessões agendadas, automações e sessões de API de usuário de serviço).

​
Solução de problemas

Devin Cloud na CLI

Inicie e conduza sessões em nuvem pelo seu terminal

Permissões da CLI

Escreva regras allow, ask e deny para chamadas de ferramenta

Transferir para Devins na nuvem

Mova uma tarefa local para uma sessão em nuvem

Computer Use

Como o Devin usa o desktop da própria VM