Droid
Esta guía cubre la autenticación, configuración y uso de Droid, un agente de codificación de IA desarrollado por Factory, en un entorno de sandbox.
Documentación oficial: Droid
Inicio rápido
Crea un sandbox y ejecuta Droid para un directorio de proyecto:
$ sbx run droid ~/mi-proyecto
El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:
$ cd ~/mi-proyecto
$ sbx run droid
Autenticación
Droid requiere una cuenta de Factory. Ambos métodos de autenticación te autentican directamente en el servicio de Factory; a diferencia de otros agentes en los que proporcionas una clave del proveedor de modelos, Factory gestiona el acceso al modelo a través de tu cuenta de Factory.
Clave de API: Almacena tu clave de API de Factory utilizando secretos guardados:
$ sbx secret set -g droid
Alternativamente, exporta la variable de entorno FACTORY_API_KEY en tu shell antes de ejecutar el sandbox. Consulta Credenciales para obtener más detalles sobre ambos métodos.
OAuth: Si no se configura ninguna clave de API, Droid te pedirá que te autentiques de forma interactiva en la primera ejecución. El proxy gestiona el flujo de OAuth, por lo que las credenciales no se almacenan dentro del sandbox.
Configuración
Los sandboxes no heredan la configuración a nivel de usuario de tu host. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta ¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario? para conocer las soluciones alternativas.
El sandbox ejecuta Droid sin avisos de aprobación por defecto. Pasa opciones adicionales de la CLI de droid después de --:
$ sbx run droid --name <nombre-sandbox> -- <opciones-de-droid>
Imagen base
Plantilla: docker/sandbox-templates:droid-docker
Preconfigurado para ejecutarse sin avisos de aprobación. El estado de autenticación persiste a lo largo de los reinicios del sandbox.
Consulta Personalización para preinstalar herramientas o personalizar este entorno.