Condividere un agente con un cliente

Condividere un agente con un cliente significa dare a una persona esterna una stanza in cui poter fare domande all'agente di progetto, osservarlo mentre lavora e ricevere deliverable, mentre l'agente, il codice e le tue credenziali restano sulla tua macchina. Fatto bene, è in sola lettura per impostazione predefinita, limitato nel tempo e revocabile con un clic. Fatto male, è un login condiviso.

Questa è la configurazione che consigliamo ad agenzie, freelance e a chiunque abbia un cliente che vuole “vedere a che punto siamo” più spesso di quanto consenta una call settimanale.

The shape

Un cliente, una stanza, un agente, una directory.

• Una directory. ~/clients/acme contiene solo il progetto di quel cliente. L'agente associato ad essa non può vedere ~/clients/beta, la cartella della tua azienda o le tue chiavi.
• Un agente, chiamato con il nome del cliente per non confondersi: acme.
• Una stanza, con te e il cliente. Le tue altre stanze sono per lui invisibili.
• Modalità plan per l'agente, in modo da rispondere alle domande senza modificare nulla su disco, a meno che non sia tu a deciderlo.

Il cliente vede la stanza; la stanza vede una directory; tutto il resto sulla macchina è inaccessibile.

Cosa può fare il cliente

• Fare domande: “cosa è cambiato questa settimana”, “perché l'export richiede un minuto”, “mostrami i design token attuali”.
• Guardare l'agente al lavoro nella timeline: quali file ha letto, quali comandi ha eseguito, la parte finale dell'output.
• Ricevere artefatti: un riepilogo, un diagramma, un file esportato, un'immagine di anteprima.
• Allegare elementi: lo screenshot di un bug, un foglio di calcolo con modifiche ai testi.

Cosa non può fare il cliente

• Modificare il codice, in modalità plan. Se imposti l'agente su acceptEdits per una fase di lavoro, le sue modifiche non possono comunque eseguire push, cancellare, spendere o toccare le credenziali senza la tua approvazione.
• Vedere i file. Il daemon carica gli eventi della timeline, non il working tree. Consulta cosa carica il daemon.
• Vedere altre stanze, altri clienti o i tuoi agenti personali.
• Approvare le proprie azioni pericolose. Vengono invece inoltrate a te.

Limiti temporali

Assegna al cliente un'autorizzazione permanente per tutta la durata del progetto e imposta un promemoria per la data di fine. Revocare l'autorizzazione, rimuoverlo dalla stanza o arrestare il daemon ha effetto immediato in ciascun caso: le richieste in coda provenienti da lui vengono annullate e tutto ciò che è in esecuzione termina e rimane nella cronologia. Gli stessi link di invito possono avere una scadenza e un numero massimo di utilizzi.

Deliverable e approvazioni

Se un cliente chiede all'agente di “fare il push del fix”, l'operazione incontra il vincolo di push to a shared branch e si mette in attesa per te. È il comportamento corretto: sei tu a decidere quando un deliverable viene rilasciato. Puoi approvarlo, rifiutarlo o rispondere “continua in sola lettura” e rilasciarlo tu stesso in seguito. La nota che alleghi entra a far parte dello storico.

Cosa sostituisce

Checklist

1. Crea ~/clients/<name> ed esegui lì il checkout del progetto.
2. Crea un agente associato a quel percorso, in modalità plan, dandogli il nome del cliente.
3. Crea una stanza; aggiungi l'agente; invita il cliente con un link con scadenza.
4. Approva la sua prima richiesta; poi concedi “always allow” per la durata del progetto se non vuoi che debba attenderti ogni volta.
5. Installa il daemon come servizio in modo che la stanza funzioni anche quando sei lontano dalla scrivania.
6. Al termine del progetto: revoca l'autorizzazione e rimuovi il membro. La cronologia resta a tua disposizione.

Domande frequenti

Il cliente ha bisogno di un account? Accede con un codice via email o tramite Google per accettare l'invito. Nessuna installazione richiesta.

Due clienti possono condividere un unico agente? Meglio di no. Una directory per ogni cliente mantiene il confine a livello fisico, non solo logico.

Quanto mi costa? Le richieste utilizzano il tuo abbonamento. I consumi per singola persona vengono registrati, quindi puoi verificare il costo delle domande del cliente ed eventualmente fatturarlo.

Il cliente può vedere i miei prompt per l'agente? Solo ciò che avviene nella sua stanza. Il tuo lavoro sulla stessa codebase deve risiedere in una stanza diversa con un agente diverso.

Assegna una stanza al progetto e lascia che sia il cliente a chiedere. Inizia qui.