Proyectos y recursos

En Proyectos, Entornos, Modelos, Instancias y Vault puedes organizar recursos personales o de un grupo. Tu cuenta debe haber sido habilitada por un administrador.

Preparar una máquina y una cuenta

1. Registra tu VPS o PC en Entornos (VPS / PC). Guarda el token que aparece una sola vez y configura el agente en esa máquina. Actualmente requiere Linux (también WSL con systemd). Un VPS puede usar IP pública; un PC sin puertos entrantes necesita Cloudflare Tunnel configurado en su agente. Registrar el PC por sí solo no configura el túnel.
2. Cuando el nodo esté conectado, abre su ficha y crea una instalación T3. La instalación aparecerá en la consola mientras el agente la prepara.
3. Registra tu Cuenta IA CLI indicando el proveedor. Esto identifica la cuenta; todavía no inicia sesión.
4. Crea una Instancia, elige la máquina, la cuenta y la instalación. Claude y Codex permiten crear un perfil independiente. Para los demás proveedores, vincula un perfil ya configurado en T3.
5. Para un perfil Codex gestionado, abre su ficha y usa Autenticación de la cuenta: consulta el estado, inicia sesión y sigue el enlace del proveedor. Vuelve a consultar el estado para ver el resultado. Si solicita una URL de retorno, pégala en el formulario. Para Claude u otros perfiles, autentica la CLI en la máquina con el directorio correspondiente al perfil. Cada perfil conserva su autenticación en su máquina.

La operación de autenticación queda ligada a tu usuario durante 15 minutos. Si caduca, inicia otra. Cerrar sesión del perfil afecta a las personas que lo estén usando; no cierra tu sesión de la plataforma.

Trabajar en un proyecto transversal

Crea un proyecto personal o de grupo. En su ficha, vincula una instancia y elige crear un proyecto local o conectar uno existente. Puedes repetirlo en otras instancias.

Al vincular una instancia o guardar el contexto, la plataforma encola su publicación. Publicaciones de contexto permite comprobar que el nodo lo aplicó o reintentarlo desde el vínculo si falló. Abre un chat nuevo después de la publicación para que lea las instrucciones, memoria y decisiones compartidas.

En Chats del proyecto puedes consultar las conversaciones de las instalaciones autorizadas. Actualizar chats obtiene su lista; cada instalación muestra la fecha de la última copia disponible.

Los chats conservan conversaciones separadas. Los resultados no se incorporan automáticamente a la memoria: guarda allí las decisiones que quieras compartir. Los archivos del proyecto se sincronizan mediante tu repositorio Git; registrar su dirección no clona ni copia archivos por sí solo.

Compartir con un grupo

Crea un grupo y añade personas ya habilitadas. Puedes asignarle la propiedad de recursos nuevos o compartir recursos personales con él. Leer permite consultar; usar permite trabajar; gestionar permite modificar. Sólo el propietario o quien administra el grupo propietario puede conceder permisos a terceros.

El acceso a los recursos y el acceso a la instalación T3 se conceden por separado. En la instalación puedes gestionar quién entra. Compartir una instalación da acceso al conjunto de su trabajo: utiliza instalaciones separadas si necesitas separar proyectos privados.

Usar el vault

Guarda una entrada personal, de grupo o de proyecto. Para referenciar una entrada de otro propietario, éste debe autorizar al propietario de destino. La referencia sigue las rotaciones; al retirar la autorización deja de resolverse.

En una instancia gestionada puedes elegir entradas del vault y asignarles los nombres de variables que espera el servicio, como AWS_SECRET_ACCESS_KEY. Los valores no se incluyen en el contexto de los chats. Todos los proyectos de ese perfil podrán usarlos: elige un perfil dedicado cuando el acceso deba limitarse a un proyecto.

Para retirar una variable, selecciona Sin entrada / retirar variable y guarda. El agente aplica cambios y rotaciones al sincronizar. Los procesos que ya están en ejecución conservan sus variables anteriores hasta terminar. Revocar el acceso no recupera valores que un proceso ya haya leído.

Archivar un recurso impide seguir utilizándolo desde la plataforma y permite restaurarlo después. Sus archivos y credenciales locales se conservan.

Varios usuarios en la misma VPS o PC

En Plataforma → Usuarios y Keycloak → Asignar espacio privado, el administrador elige la persona y la máquina. Cada persona recibe su propia instalación, con chats, archivos y credenciales separados. El usuario la encuentra al entrar en su cuenta; no necesita acceso a los recursos privados del anfitrión. El acceso al equipo no concede acceso a las instalaciones de las demás personas.

La máquina debe anunciar aislamiento por usuarios Linux y estar conectada. Si indica «pendiente de habilitar aislamiento», no se puede asignar un espacio privado todavía. Las instalaciones anteriores sin aislamiento no se convierten automáticamente. Compartir una instalación concede acceso a su trabajo completo; compartir proyectos transversales permite mantener instalaciones separadas.