Ir al contenido principal
Español— Elegir un idioma
Menú

Organizaciones y espacios de trabajo

Lección 2 de 14 Actualizado el 29 de julio de 2026 Avanzado
En esta página
  1. Estructuración de tu equipo en AI Studio
  2. El modelo Organización / Espacio de trabajo
  3. Gestión de roles y permisos
  4. Mejores prácticas organizativas
  5. Escenario concreto: configuración
  6. Puntos clave

Estructuración de tu equipo en AI Studio

Mientras trabajas solo, una única clave de API es suficiente. Los problemas comienzan en el momento en que tres desarrolladores comparten la misma cuenta: nadie sabe qué clave impulsa qué aplicación, la factura llega como un bloque indescifrable y, el día que alguien abandona el equipo, tienes que revocar todo. AI Studio resuelve esto con una arquitectura de dos niveles: Organizaciones y Espacios de trabajo. Comprender esta estructura es esencial para gestionar la facturación, los permisos y el aislamiento de recursos.

El modelo Organización / Espacio de trabajo

La Organización se sitúa en la cima de la jerarquía. Se crea automáticamente al registrarte y representa a tu entidad: empresa, equipo o departamento. Aquí es donde se consolida todo: la facturación, que agrega todos los costes; la selección del nivel de suscripción (Experiment, Scale o Enterprise); los límites de uso, es decir, las cuotas globales de tokens y solicitudes; y la asignación de miembros, incluidas las invitaciones y la gestión de puestos. Crear una nueva organización solo requiere un nombre y la aceptación de las condiciones de servicio, y nada impide que un único usuario pertenezca a varias organizaciones a la vez.

Los espacios de trabajo son subconjuntos dentro de una Organización, diseñados para segmentar el acceso y los costes por proyecto, equipo o entorno. Cada espacio de trabajo aísla sus claves de API, que otorgan acceso solo a sus propios recursos, y comparte modelos ajustados (fine-tuned) y conjuntos de datos de entrenamiento entre sus miembros. El consumo sigue siendo rastreable espacio por espacio, por lo que puedes decir con precisión cuánto cuesta el chatbot de soporte en comparación con el motor de búsqueda interno.

Gestión de roles y permisos

Tres roles coexisten a nivel de Organización, con ámbitos deliberadamente distintos.

RolFacturaciónMiembrosEspacios de trabajoClaves de API
PropietarioSíSíSíSí
AdministradorNoSíSíSí
MiembroNoNoLimitadoSí

Recuerda la fila del medio: un Administrador gestiona equipos y espacios de trabajo, pero nunca toca la facturación. Esto te permite delegar la administración técnica en un responsable de ML sin darle acceso a la tarjeta de crédito de la empresa.

Por lo tanto, crear un espacio de trabajo requiere permisos de Administrador. Desde la página de Administración de tu organización:

  1. Ve a la sección Espacios de trabajo
  2. Haz clic en Crear espacio de trabajo
  3. Asígnale un nombre descriptivo (por ejemplo: production, staging, research)
  4. Configura los permisos iniciales

Añadir un colaborador sigue una lógica similar:

  1. Ve a Administración > Miembros
  2. Haz clic en Invitar
  3. Introduce la dirección de correo electrónico del colaborador
  4. Asigna un rol (Administrador, Miembro)
  5. Selecciona los espacios de trabajo a los que tendrá acceso

Mejores prácticas organizativas

La primera regla es separar los entornos. Crea al menos dos espacios de trabajo, idealmente tres, para aislar lo que ocurre en desarrollo de lo que afecta a tus usuarios.

Organización "MaStartup"
├── Espacio de trabajo "development"    → claves de API de dev, cuotas reducidas
├── Espacio de trabajo "staging"        → pruebas de integración
└── Espacio de trabajo "production"     → claves de API de prod, cuotas altas

Esta separación evita que un bucle infinito escrito un viernes por la noche en desarrollo devore las cuotas de producción, y hace que el seguimiento de costes por entorno sea inmediatamente legible.

Lo siguiente es la rotación de claves. Dado que cada clave está vinculada a un espacio de trabajo, sustituirla sin interrumpir el servicio requiere un orden específico: genera la nueva clave en el espacio de trabajo correspondiente, despliégala en tu aplicación, verifica que las solicitudes se procesan correctamente con ella y, solo entonces, elimina la antigua. Invertir los dos últimos pasos garantiza una interrupción del servicio.

import os

# Buena práctica: clave de API mediante variable de entorno
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Una clave codificada directamente en el código fuente siempre acabará en un repositorio de Git, luego en el historial de ese repositorio, donde sobrevivirá a todos tus intentos de limpieza. Usa una variable de entorno desde la primera línea.

En las grandes organizaciones, la gobernanza también se beneficia de tener un espacio de trabajo por equipo funcional (ciencia de datos, backend, producto), más un espacio de trabajo dedicado al ajuste fino (fine-tuning) que centralice los conjuntos de datos en lugar de permitir que se dupliquen. Los nombres explícitos de los espacios de trabajo facilitan enormemente la elaboración de informes mensuales.

Escenario concreto: configuración

Tomemos el caso de una empresa de quince personas que adopta Mistral. El CTO crea la Organización y se suscribe al nivel Scale, luego abre tres espacios de trabajo: dev, staging y prod. Los desarrolladores reciben acceso de Miembro limitado al espacio de trabajo dev, mientras que el responsable de ML obtiene acceso de Administrador a los tres. Cada espacio de trabajo tiene sus propias claves de API, aisladas entre sí, de modo que una clave de desarrollo filtrada no compromete nada en producción.

El panel de administración, accesible en admin.mistral.ai, muestra entonces el consumo por espacio de trabajo. Esta es la tabla que el CTO abrirá a finales de mes para asignar costes por proyecto, sin tener que instrumentar nada en el código.

Puntos clave

  • La Organización es el nivel para la facturación y la gestión global
  • Los espacios de trabajo aíslan las claves de API, los modelos ajustados y los costes
  • Separa siempre desarrollo, staging y producción en espacios de trabajo distintos
  • Almacena las claves de API en variables de entorno, nunca en el código
  • El panel de administración te permite seguir el consumo por espacio de trabajo en tiempo real