DigitalOcean Cuttlefish: um guia para revisar pedidos de aprovação de agentes de IA no celular
O DigitalOcean Cuttlefish é um app móvel para aprovar ou negar chamadas de ferramentas do Managed Agents quando você está longe da sua mesa. Veja como ler um pedido de aprovação, como escolher uma resposta com um guia Aprovar, Negar, Reorientar, Pausar ou Parar, e como conduzir um piloto que conta o tempo que as pessoas gastam revisando pedidos, não apenas a conta de computação.
Agentes de IA de programação e de operações não esperam um momento conveniente para travar. O pedido de permissão aparece quando você está em uma reunião ou no meio do trajeto para o trabalho. O blog de lançamento da DigitalOcean diz que o Cuttlefish permite ver o comando completo, o caminho do arquivo ou o diff de uma chamada de ferramenta e desbloquear seu agente de onde você estiver, para sessões executadas no Managed Agents.
Este guia trata principalmente de como ler pedidos de aprovação com atenção e escolher uma resposta com um roteiro simples. Ele termina com um desenho de piloto que mede mais do que a conta do servidor.
O objetivo não é aprovar mais rápido. Sugerimos buscar decisões bem fundamentadas onde quer que você esteja e reconhecer quando é melhor deixar um pedido para uma revisão no computador.
O que é o Cuttlefish e onde ele se encaixa no Managed Agents
O Cuttlefish é um cliente de supervisão. O comunicado à imprensa da DigitalOcean descreve o Managed Agents e o Box Mount como serviços em prévia que não têm suporte para cargas de trabalho de produção.
Ele não está preso a um único framework de agentes. O changelog da DigitalOcean diz que ele funciona com qualquer agente que você execute no Managed Agents, incluindo Claude Code, Codex CLI, OpenCode, OpenHands, Hermes, LangGraph e CrewAI. Uma equipe que já padronizou um deles não precisa trocar de ferramenta para ter supervisão pelo celular.
Do lado dos modelos, o Managed Agents encaminha chamadas para mais de 75 modelos abertos e proprietários, ou para o seu próprio provedor se você configurar o ambiente com o endpoint e a chave dele, segundo a documentação de arquitetura. O Cuttlefish fica por cima de tudo isso. Todo pedido de aprovação chega ao mesmo lugar, independentemente de qual modelo ou framework gerou a chamada de ferramenta.
A DigitalOcean apresenta o produto a partir de uma mudança na forma como as pessoas trabalham com agentes. Seu comunicado de lançamento diz que o trabalho com agentes transforma cada desenvolvedor em supervisor, e que a supervisão não deveria ter de esperar alguém voltar para a mesa. É uma descrição justa do problema. Também é um motivo para cautela, porque quem aprova tudo por reflexo não está de fato supervisionando.
Antes de começar: requisitos e limites da prévia
O que você precisa
O Byteiota informa que o Cuttlefish exige iOS 26.5 ou posterior e uma conta DigitalOcean com acesso ao Managed Agents. Trata-se de um relato de terceiros, então confira os requisitos atuais no guia oficial de uso da DigitalOcean antes de distribuir o app.
O Byteiota também informa que nenhuma versão para Android foi anunciada.
O que prévia significa na prática
A DigitalOcean é direta sobre isso. Seu comunicado afirma que os serviços em prévia são fornecidos no estado em que se encontram, não têm suporte para cargas de trabalho de produção e podem mudar, nunca se tornar disponíveis de forma geral ou ser descontinuados. Isso vale para o Managed Agents e o Box Mount. Restrinja-os a testes, ferramentas internas e trabalho fora de produção.
A DigitalOcean não anunciou preço para o app Cuttlefish. Um texto na DEV Community faz a mesma observação: nenhum preço do app foi publicado. Até que a DigitalOcean publique seus próprios números, não faça orçamento com base em preços do app citados em outros lugares.
Checklist de configuração
- [ ] Confirme o acesso ao Managed Agents na sua conta DigitalOcean.
- [ ] Verifique se o iPhone de cada aprovador atende ao requisito de sistema operacional do guia oficial.
- [ ] Decida quais sessões podem ser supervisionadas pelo celular e quais sempre passam por revisão no computador.
- [ ] Defina quem pode aprovar pelo celular e quem cobre os colegas que não têm iPhone.
- [ ] Mantenha o piloto em repositórios, dados e contas fora de produção.
- [ ] Compartilhe o guia oficial de uso para que os aprovadores vejam como o app se comporta atualmente.
Passo a passo: como ler um pedido de aprovação antes de tocar na tela
Passo 1: abra o pedido completo, não apenas a notificação
O blog de lançamento diz que o Cuttlefish mostra o comando completo, o caminho do arquivo ou o diff de cada chamada de ferramenta, em vez de um resumo. Aproveite isso. Uma notificação avisa que algo precisa de atenção. Ela não dá informação suficiente para decidir.
Passo 2: verifique se há sinalização de alto risco
Pedidos classificados como de alto risco exigem Face ID ou sua senha para serem aprovados. O Byteiota lista exemplos de chamadas sinalizadas automaticamente: exclusões recursivas, force pushes, comandos sudo e scripts baixados da internet e enviados por pipe direto para um shell. Uma sinalização significa ir com calma. A ausência de sinalização não significa que a ação é segura.
Passo 3: leia diffs sempre na mesma ordem
Passar os olhos rapidamente por um diff em uma tela pequena é exatamente como a linha importante passa despercebida. Use a mesma sequência todas as vezes:
- Qual arquivo ele altera, e esse arquivo está dentro do escopo da tarefa?
- O que está sendo removido? Danos acidentais costumam se esconder nas remoções.
- O que está sendo adicionado, e isso corresponde ao que você pediu ao agente?
Se o diff for longo demais para ler inteiro no celular, você já tem sua resposta. Ele fica para o computador.
Passo 4: leia comandos da esquerda para a direita
Divida um comando de shell em partes e aja sobre cada sinal de alerta assim que o encontrar:
- O binário. Qual programa é executado: rm, git, curl, sudo? Se for sudo, ou um programa de que a tarefa nunca precisou, pause e descubra por que o agente quer usá-lo.
- As flags. Alguma opção recursiva ou de força amplia o efeito? Em um caminho inesperado, isso é motivo para pausar.
- O caminho de destino. É o diretório ou repositório que você esperava? Se estiver fora do escopo da tarefa, negue e depois reoriente o agente para o local certo.
- Pipes e redirecionamentos. Qualquer coisa enviada por pipe a partir do curl ou de um download semelhante para um shell deve ser negada. Um redirecionamento que sobrescreve um arquivo que você não esperava significa negar ou reorientar.
Se você não conseguir classificar cada parte do comando com confiança, trate isso também como sinal de alerta e pause.
Passo 5: saiba o que a solicitação biométrica realmente faz
O Face ID ou a senha confirmam que é você quem está aprovando. Eles não dizem nada sobre se a ação está correta. Tome você mesmo a decisão de segurança e só depois se autentique.
O guia Aprovar, Negar, Reorientar, Pausar ou Parar
Este roteiro é o guia de decisão próprio da Optijara, não uma orientação da DigitalOcean. Ele parte do princípio de que os aprovadores conseguem ver o pedido completo, que o Cuttlefish exibe. Sugerimos consultar o guia oficial de uso para ver quais desses controles a sua versão do app oferece e usar o console para tudo o que o app não cobre.
| Decisão | Use quando | Exemplo | Por quê |
|---|---|---|---|
| Aprovar | A ação corresponde à tarefa, tem como alvo o caminho ou repositório esperado, e você consegue explicar o diff ou comando inteiro em uma frase | Uma edição pontual no arquivo citado no ticket | A execução continua com baixo risco |
| Negar | A ação está fora do escopo, altera caminhos inesperados ou você não consegue ler tudo no celular | Uma alteração em um arquivo de configuração que a tarefa nunca mencionou | Negar uma chamada custa menos do que desfazer uma ação |
| Reorientar | O objetivo está certo, mas o método está errado | Branch errado, uma exclusão ampla em vez de uma edição pontual, ou uma etapa de teste pulada | Corrige a abordagem sem perder o trabalho feito até ali |
| Pausar (no app ou no console) | Você precisa de um notebook, de um colega ou de mais contexto | Um diff longo em vários arquivos | O estado da máquina é mantido e as cobranças de computação param |
| Parar (no app ou no console) | A execução se desviou da tarefa, continua repetindo tentativas que falharam ou mexeu em dados que você não pretendia que fossem alterados | Várias novas tentativas da mesma abordagem que falha | Encerra a sessão antes que o desvio vire dano |
Tome cuidado redobrado com o Box Mount
O blog de lançamento observa que o agente pode editar e excluir arquivos na pasta sincronizada, e que as exclusões são sincronizadas de volta com o Box. Portanto, uma exclusão que você aprova no celular não fica restrita a um sandbox. Ela chega aos arquivos compartilhados da empresa. O padrão sensato é negar ou pausar qualquer exclusão em uma pasta sincronizada, a menos que a tarefa a exija explicitamente.
Uma regra prática simples
Se você gostaria que um segundo revisor olhasse com calma no computador, pause em vez de aprovar pelo celular. A aprovação pelo celular combina com decisões claras e delimitadas. O HostingJournalist resume bem esse equilíbrio: levar a decisão para o celular pode encurtar uma fila, mas também pode facilitar que um processo de aprovação mal desenhado seja feito às pressas.
O que acontece depois que você bloqueia o celular
Bloquear o celular ou perder o sinal encerra uma execução? Não. Segundo o comunicado da DigitalOcean, as sessões rodam em MicroVMs da DigitalOcean que persistem independentemente de qualquer dispositivo. Seu celular é um controle remoto, e o agente vive em outro lugar.
Cada sessão recebe seu próprio sandbox. A documentação de arquitetura o descreve como uma microVM leve, com isolamento imposto pelo hypervisor e não por namespaces de contêiner, um design pensado para manter as sessões separadas umas das outras.
Esse design também influencia o custo. A cobrança acompanha o uso ativo de CPU, então o tempo que um agente passa esperando sua aprovação custa muito pouco. Segundo a DigitalOcean, pausar mantém o estado completo da máquina e interrompe as cobranças de computação. Antes de presumir que uma sessão pausada é gratuita, verifique se o armazenamento ou outras cobranças continuam correndo.
Quanto à velocidade, o post sobre a arquitetura de MicroVM da DigitalOcean informa que, no caminho de template pré-aquecido, uma MicroVM vai de uma solicitação de execução até servir tráfego em menos de 200 ms no p50, em testes internos. O Byteiota publica um número separado para a retomada a partir do estado pausado, e as ressalvas abaixo explicam por que o tratamos como não verificado.
Se você está comparando esse modelo de persistência com alternativas, nosso checklist de seleção de runtime para agentes de IA duráveis mostra o que comparar.
Na prática, uma execução bloqueada à espera de aprovação simplesmente fica parada. O custo de computação não é o risco real. O risco real é os pedidos se acumularem enquanto a pessoa certa está ocupada e depois serem liberados às pressas.
Como conduzir um piloto de supervisão pelo celular que mede as coisas certas
Como esperar custa pouco em computação, um piloto pode parecer barato na fatura enquanto consome silenciosamente o tempo das pessoas. O HostingJournalist alerta que um piloto que conta apenas as cobranças de infraestrutura pode parecer barato e, ao mesmo tempo, interromper repetidamente as pessoas que deveria liberar. O HostingDiscussion diz isso de forma mais direta: o tempo de uma pessoa é outra conta a pagar, e pilotos que contam apenas as cobranças de servidor podem parecer baratos enquanto interrompem os funcionários o dia todo.
O que medir
O HostingJournalist recomenda acompanhar o tempo de conclusão, as intervenções por tarefa e os minutos gastos revisando exceções, e depois comparar esses números com o custo e a taxa de erro do processo atual. Um registro simples poderia ser assim:
| Métrica | Como coletar | O que ela revela |
|---|---|---|
| Tempo de conclusão por tarefa | Do início ao fim da sessão | Se os agentes realmente aceleram o fluxo de trabalho |
| Intervenções por tarefa | Contagem de aprovações, negações, reorientações, pausas e paradas | Quanta atenção humana cada tarefa exige |
| Minutos revisando exceções | Autorrelato do aprovador, ou registros de horário das aprovações se os logs de sessão os incluírem (confirme isso antes de o piloto começar) | O custo humano que a fatura deixa de fora |
| Custo de computação | Faturamento da DigitalOcean | O lado de infraestrutura do caso de negócio |
| Linha de base | Custo e taxa de erro do processo atual | Se o fluxo com agentes realmente se sai melhor |
Como estruturar o piloto
- Escolha um fluxo de trabalho de baixo risco e fora de produção, como alterações rotineiras em um repositório interno.
- Escreva as regras de aprovação antes de começar: o que pode ser aprovado pelo celular e o que sempre precisa do computador.
- Defina os aprovadores pelo celular e quem cobre as pessoas sem iPhone.
- Registre cada negação, reorientação, pausa e parada com um motivo de uma linha.
- Revise o registro semanalmente. Procure pedidos que você poderia eliminar restringindo o escopo ou as permissões do agente, incluindo credenciais. Um proxy de credenciais que mantém as chaves de API fora dos agentes de IA limita o que qualquer chamada aprovada consegue alcançar. Marque também os pedidos que devem sempre ir para revisão no computador.
Erros comuns ao aprovar ações de agentes pelo celular
- Aprovar a partir da notificação. Abra o comando ou o diff completo todas as vezes.
- Tratar o Face ID como verificação de segurança. Ele confirma a identidade e nada mais.
- Esquecer a sincronização do Box Mount. Exclusões na pasta sincronizada voltam para o Box.
- Contar apenas as cobranças de servidor. O tempo perdido com interrupções faz parte do caso de negócio.
- Deixar usuários de Android sem alternativa. Planeje cobertura para colegas que não podem usar o app.
Ressalvas e questões em aberto
Status de prévia. Esta é a maior questão em aberto. Não construa processos críticos com base em como os serviços se comportam hoje.
Contagens de ferramentas conflitantes. O blog de lançamento cita 20.000+ ferramentas, enquanto a documentação de arquitetura diz que mais de 16.000 ferramentas ficam por trás do Action Gateway. Trate ambos os números como aproximados e confirme que as integrações específicas de que você precisa existem, em vez de confiar em qualquer um dos números de destaque.
Números de terceiros. O Byteiota informa uma retomada em 305 ms a partir do estado pausado, mas não encontramos esse número nos materiais da própria DigitalOcean, então trate-o como não verificado. O requisito de iOS 26.5 também vem do Byteiota, portanto confirme-o na documentação da DigitalOcean antes de contar com ele.
Preços. Nenhum preço foi anunciado para o app Cuttlefish. A cobrança do Managed Agents acompanha o uso ativo de CPU.
Classificação automática de risco. As sinalizações de alto risco são aplicadas automaticamente. Um pedido sem sinalização ainda pode causar danos no seu contexto, e uma edição no arquivo de configuração errado é o exemplo óbvio. Suas próprias regras de revisão continuam valendo.
Controle por sessão. Sugerimos não tratar nenhum controle sobre uma única sessão como plano de resposta a incidentes. Incidentes que envolvem vários agentes também precisam de um runbook de incidentes multiagente que cubra o que os controles de uma única sessão não alcançam.
Pontos principais
- 1O Cuttlefish adiciona supervisão pelo celular a qualquer framework de agentes que você já execute no Managed Agents, para que você desbloqueie sessões longe da sua mesa sem trocar de ferramenta.
- 2Cada pedido de chamada de ferramenta mostra o comando completo, o caminho do arquivo ou o diff. Leia sempre o conteúdo bruto, não a notificação.
- 3O Face ID ou a senha em pedidos de alto risco apenas confirmam quem está aprovando. Eles não dizem nada sobre se a ação é segura.
- 4As sessões rodam em MicroVMs independentes do dispositivo, então bloquear o celular não encerra uma execução, e pausar mantém o estado da máquina enquanto interrompe as cobranças de computação.
- 5Se você gostaria de um segundo revisor no computador, pause em vez de aprovar, e trate com cuidado as exclusões no Box Mount, porque elas são sincronizadas de volta com o Box.
- 6Os pilotos devem acompanhar o tempo de conclusão, as intervenções por tarefa e os minutos de revisão junto com o custo de computação.
- 7O Managed Agents é um serviço em prévia sem suporte para produção, o preço do app não foi publicado e o Byteiota informa que nenhuma versão para Android foi anunciada.
Conclusão
O Cuttlefish resolve um problema real, mas restrito: execuções de agentes que travam porque a única pessoa capaz de desbloqueá-las está longe da mesa. E ele faz isso bem. Você vê o comando completo, o caminho do arquivo ou o diff em vez de um resumo, e os pedidos que ele classifica como de alto risco exigem Face ID ou senha. As sessões persistem em microVMs e esperar custa pouca computação, então não há motivo para apressar uma aprovação só para manter uma execução viva.
O que o app não faz é melhorar suas decisões. Isso vem das regras de aprovação que você escreve, dos hábitos que seus aprovadores desenvolvem e de uma contagem honesta do tempo que as pessoas perdem com interrupções. Comece com um fluxo de trabalho de baixo risco e fora de produção, registre por escrito o que pode ser aprovado pelo celular, registre cada intervenção e revise o registro semanalmente para restringir o escopo do agente onde os pedidos forem rotineiros. O status de prévia, a ausência de versão para Android e os números de terceiros não verificados são limites reais, então continue consultando a documentação oficial à medida que o serviço muda.
Se um segundo olhar sobre suas regras de aprovação ou o desenho do seu piloto ajudar, a Optijara terá prazer em trabalhar nisso com a sua equipe.
Perguntas frequentes
O que é o DigitalOcean Cuttlefish?
O Cuttlefish é o app móvel da DigitalOcean para supervisionar sessões do Managed Agents. Ele mostra o comando completo, o caminho do arquivo ou o diff de cada chamada de ferramenta, em vez de um resumo, para que você possa aprová-la ou negá-la e desbloquear seu agente de onde estiver. A DigitalOcean descreve o Managed Agents e o Box Mount como serviços em prévia que não têm suporte para cargas de trabalho de produção.
Uma sessão do Managed Agents para se eu bloquear meu iPhone ou perder o sinal?
Não. A DigitalOcean diz que as sessões rodam em MicroVMs que persistem independentemente de qualquer dispositivo, então a execução continua ou aguarda sua aprovação, não importa o que o seu celular esteja fazendo. Cada sessão roda em sua própria microVM, com isolamento imposto pelo hypervisor.
Quais frameworks de agentes funcionam com o Cuttlefish?
Segundo o changelog da DigitalOcean, o Cuttlefish funciona com qualquer agente que você execute no Managed Agents, incluindo Claude Code, Codex CLI, OpenCode, OpenHands, Hermes, LangGraph e CrewAI.
Quais ações exigem Face ID ou senha para serem aprovadas?
Os pedidos classificados como de alto risco. O Byteiota dá exemplos de chamadas sinalizadas automaticamente: exclusões recursivas, force pushes, comandos sudo e scripts baixados da internet e enviados por pipe para um shell. A classificação é automática, então um pedido sem sinalização ainda pode ser prejudicial e ainda merece uma leitura cuidadosa.
Quando devo pausar em vez de aprovar pelo celular?
Pause quando você gostaria que um segundo revisor olhasse o pedido no computador, por exemplo um diff longo em vários arquivos ou qualquer coisa que você não consiga ler inteira na tela. Pausar mantém o estado completo da máquina e interrompe as cobranças de computação, então não há motivo de computação para ter pressa, embora você deva verificar se o armazenamento ou outras cobranças continuam. Verifique se a sua versão do app oferece a opção de pausar e use o console se não oferecer. Tenha cautela especial com exclusões em uma pasta do Box Mount, porque as exclusões são sincronizadas de volta com o Box.
Existe uma versão do Cuttlefish para Android, e quanto ele custa?
O Byteiota informa que nenhuma versão para Android foi anunciada, então planeje outro caminho de supervisão para colegas que usam Android. A DigitalOcean não publicou o preço do app Cuttlefish em si. A cobrança do Managed Agents acompanha o uso ativo de CPU, então um agente esperando aprovação consome pouca computação.
Posso usar o Cuttlefish e o Managed Agents para cargas de trabalho de produção?
A DigitalOcean diz que seus serviços em prévia são fornecidos no estado em que se encontram, não têm suporte para cargas de trabalho de produção e podem mudar, nunca se tornar disponíveis de forma geral ou ser descontinuados. Mantenha os pilotos em trabalho fora de produção e acompanhe o tempo de conclusão, as intervenções por tarefa e os minutos de revisão junto com o custo de computação.
Fontes
- https://www.digitalocean.com/blog/introducing-cuttlefish
- https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/how-to/use-cuttlefish-ios-app/
- https://investors.digitalocean.com/news/news-details/2026/DigitalOcean-Launches-Cuttlefish-to-Supervise-AI-Agents-From-Anywhere-With-Box-as-Launch-Partner/default.aspx
- https://ideas.digitalocean.com/changelog/introducing-cuttlefish-build-agents-from-anywhere
- https://docs.digitalocean.com/products/managed-agents/
- https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/concepts/architecture/
- https://www.digitalocean.com/blog/microvm-architecture
- https://hostingjournalist.com/news/cloud-firm-digitalocean-launches-iphone-app-to-approve-ai-agent-actions
- https://hostingdiscussion.com/news/digitaloceans-new-iphone-app-lets-you-approve-an-ai-agents-next-move/
- https://byteiota.com/digitalocean-cuttlefish-supervise-ai-agents-iphone/
- https://dev.to/paullovelace/digitalocean-cuttlefish-puts-your-ai-agents-in-your-pocket-4g4l
Escrito por
Hamza DiazHamza Diaz é o fundador da Optijara, onde cria agentes de IA práticos, sistemas de automação e fluxos de trabalho do Copilot para empresas de serviços. Ele escreve sobre operações de IA, estratégia de agentes e implementação no mundo real para equipes que querem sistemas úteis em vez de exagero.
