Partilhar um agente com um cliente

Partilhar um agente com um cliente significa dar a uma pessoa externa uma sala onde esta pode fazer perguntas ao agente do projeto, acompanhar o seu trabalho e receber entregáveis, enquanto o agente, o código e as suas credenciais permanecem na sua máquina. Bem feito, é apenas de leitura por predefinição, limitado no tempo e revogável com um clique. Mal feito, é uma partilha de credenciais de acesso.

Esta é a configuração que recomendamos para agências, freelancers e qualquer pessoa cujo cliente queira “ver como as coisas estão a correr” com mais frequência do que uma reunião semanal permite.

A estrutura

Um cliente, uma sala, um agente, um diretório.

• Um diretório. ~/clients/acme contém apenas o projeto desse cliente. O agente fixado nele não consegue ver ~/clients/beta, a pasta da sua empresa ou as suas chaves.
• Um agente, com o nome do cliente para que ninguém se confunda: acme.
• Uma sala, com o cliente e você. As suas outras salas são invisíveis para eles.
• Modo plan para o agente, para que as perguntas sejam respondidas e nada mude no disco a menos que decida o contrário.

O cliente vê a sala; a sala vê um diretório; tudo o resto na máquina fica fora de alcance.

O que o cliente pode fazer

• Fazer perguntas: “o que mudou esta semana”, “porque é que a exportação demora um minuto”, “mostra-me os design tokens atuais”.
• Acompanhar o trabalho do agente na timeline: quais os ficheiros que leu, quais os comandos que executou, o final do output.
• Receber artefactos: um resumo, um diagrama, um ficheiro exportado, uma imagem de pré-visualização.
• Anexar coisas: uma captura de ecrã de um bug, uma folha de cálculo com alterações de texto.

O que o cliente não pode fazer

• Alterar código, em modo plan. Se mudar o agente para acceptEdits durante uma fase, as edições deles continuam a não poder fazer push, apagar, gastar ou aceder a credenciais sem a sua aprovação.
• Ver ficheiros. O daemon faz upload dos eventos da timeline, não da working tree. Veja o que o daemon envia.
• Ver outras salas, outros clientes ou os seus próprios agentes.
• Aprovar as suas próprias ações perigosas. Essas são encaminhadas para si.

Limitação temporal

Dê ao cliente uma autorização contínua durante a duração do projeto e coloque um lembrete na data de término. Revogar a autorização, removê-lo da sala ou parar o daemon tem efeito imediato em cada caso; os pedidos em fila feitos por ele são cancelados e tudo o que estiver em execução termina e permanece no histórico. Os próprios links de convite podem ter um prazo de expiração e um número máximo de utilizações.

Entregáveis e aprovações

Um cliente que peça ao agente para “fazer push da correção” depara-se com push to a shared branch e o processo pausa à sua espera. Esse é o comportamento correto: é você quem decide quando um entregável é lançado. Faça Approve, rejeite ou responda “continue read-only” e lance-o você mesmo mais tarde. A nota que anexar faz parte do registo.

O que substitui

Checklist

1. Crie ~/clients/<name> e faça o checkout do projeto para lá.
2. Crie um agente fixado nele, em modo plan, com o nome do cliente.
3. Crie uma sala; adicione o agente; convide o cliente com um link com prazo de expiração.
4. Faça Approve ao primeiro pedido deles; depois conceda “always allow” durante a duração do projeto se quiser que deixem de ter de esperar por si.
5. Instale o daemon como um serviço para que a sala funcione quando não estiver na secretária.
6. No final do projeto: faça Revoke da autorização e remova o membro. O histórico fica guardado para si.

Perguntas frequentes

O cliente precisa de uma conta? Basta iniciar sessão com um código por email ou via Google para aceitar o convite. Sem qualquer instalação.

Dois clientes podem partilhar o mesmo agente? Não o faça. Um diretório por cliente mantém a barreira física, não apenas lógica.

Quanto é que isto me custa? Os pedidos utilizam a sua subscrição. O consumo por pessoa é registado, pelo que pode ver o custo das perguntas do cliente e faturar em conformidade, se desejar.

O cliente consegue ver os meus prompts para o agente? Apenas o que acontece na sala dele. O seu próprio trabalho com a mesma codebase deve ficar numa sala diferente, com um agente diferente.

棒Dê uma sala ao projeto e deixe o cliente perguntar. Comece aqui.