Compartir un agente con un cliente

Compartir un agente con un cliente significa dar a una persona externa una sala donde pueda hacer preguntas al agente del proyecto, ver cómo trabaja y recibir entregables, mientras el agente, el código y tus credenciales permanecen en tu máquina. Si se hace bien, es de solo lectura por defecto, limitado en el tiempo y revocable con un solo clic. Si se hace mal, no es más que una cuenta compartida.

Esta es la configuración que recomendamos para agencias, freelancers y cualquiera cuyo cliente quiera «ver cómo va la cosa» más a menudo de lo que permite una reunión semanal.

La estructura

Un cliente, una sala, un agente, un directorio.

• Un directorio. ~/clients/acme contiene únicamente el proyecto de ese cliente. El agente vinculado a él no puede ver ~/clients/beta, la carpeta de tu empresa ni tus claves.
• Un agente, con el nombre del cliente para que nadie se confunda: acme.
• Una sala, con el cliente y tú. Tus otras salas son invisibles para él.
• Modo plan para el agente, de modo que responda a las preguntas y nada cambie en disco a menos que decidas lo contrario.

El cliente ve la sala; la sala ve un directorio; todo lo demás en la máquina queda fuera de su alcance.

Qué puede hacer el cliente

• Hacer preguntas: «qué ha cambiado esta semana», «por qué la exportación tarda un minuto», «muéstrame los design tokens actuales».
• Ver trabajar al agente en el timeline: qué archivos ha leído, qué comandos ha ejecutado y las últimas líneas de la salida.
• Recibir artefactos: un resumen, un diagrama, un archivo exportado, una imagen de vista previa.
• Adjuntar elementos: una captura de pantalla de un bug, una hoja de cálculo con cambios en los textos.

Qué no puede hacer el cliente

• Cambiar código, en modo plan. Si pasas el agente a acceptEdits durante una fase, sus cambios seguirán sin poder hacer push, borrar, gastar ni tocar credenciales sin tu aprobación.
• Ver archivos. El daemon sube eventos del timeline, no el árbol de trabajo. Consulta qué sube el daemon.
• Ver otras salas, otros clientes ni tus propios agentes.
• Aprobar sus propias acciones peligrosas. Esas se te redirigen a ti.

Límite temporal

Otorga al cliente una autorización permanente durante la duración del proyecto y ponte un recordatorio para la fecha de finalización. Revocar la autorización, eliminarlo de la sala o detener el daemon tiene efecto inmediato en cada caso; las solicitudes en cola que provengan de él se cancelan y todo lo que esté en ejecución concluye y permanece en el historial. Los propios enlaces de invitación pueden incluir una fecha de caducidad y un número máximo de usos.

Entregables y aprobaciones

Si un cliente pide al agente «subir el arreglo», este llega a hacer push a una rama compartida y se detiene a la espera de tu visto bueno. Es el comportamiento adecuado: tú decides cuándo se publica un entregable. Apruébalo, recházalo o responde «continuar en solo lectura» y publícalo tú mismo más adelante. La nota que adjuntes formará parte del registro.

Qué sustituye

Lista de comprobación

1. Crea ~/clients/<name> y haz el checkout del proyecto allí.
2. Crea un agente vinculado a él, en modo plan, con el nombre del cliente.
3. Crea una sala; añade el agente; invita al cliente con un enlace con fecha de caducidad.
4. Aprueba su primera solicitud; después autoriza «Allow always» durante el proyecto si quieres evitar que tenga que esperar por ti.
5. Instala el daemon como servicio para que la sala funcione cuando no estés frente al ordenador.
6. Al finalizar el proyecto: revoca la autorización y elimina al miembro. El historial se conservará para ti.

Preguntas frecuentes

¿Necesita una cuenta el cliente? Inicia sesión con un código enviado por correo o con Google para aceptar la invitación. No requiere instalación.

¿Pueden dos clientes compartir un mismo agente? No lo hagas. Un directorio por cliente mantiene un límite físico, no solo lógico.

¿Cuánto me cuesta? Las solicitudes se ejecutan con tu suscripción. El uso por persona queda registrado, de modo que puedes ver el coste de las preguntas del cliente y facturarlo según corresponda si así lo deseas.

¿Puede ver el cliente mis prompts al agente? Solo lo que ocurre en su sala. Tu propio trabajo con la misma base de código debe ir en una sala distinta con otro agente.

Dale una sala al proyecto y deja que el cliente pregunte. Empieza aquí.