Ajustes
La página de Ajustes tiene dos secciones. Conexiones configura los dos servicios upstream de los que depende AI Studio — ambos exponen acciones de verificación antes de guardar, por lo que una URL mal configurada se detecta de inmediato en lugar de en tiempo de ejecución. Roles y Permisos controla quién puede usar Studio y qué puede hacer en él.
Agent Runtime
El Agent Runtime es el destino de despliegue para cada agente publicado. AI Studio escribe sus definiciones de agentes, registros de habilidades y configuraciones de fuentes de datos en este runtime, y el runtime atiende el tráfico de los usuarios finales.
- Runtime URL — URL base de la instancia de Beak AI Runtime (p. ej.
https://demo-runtime-dev.beakops.com). La etiqueta de origen debajo del campo muestra si el valor provino de la base de datos o de un valor predeterminado de variable de entorno. - API Key — Opcional. Requerida cuando el runtime está configurado para autenticar las escrituras de Studio.
- Test Connection — Sondea el endpoint de salud del runtime con la URL y la clave configuradas.
Haga clic en Guardar para conservar los cambios. Los cambios surten efecto de inmediato para cualquier nueva publicación.
AI Gateway
El AI Gateway es la fuente de disponibilidad de modelos LLM. El gateway es donde se registran los modelos, se delimitan los proyectos y se gestiona el enrutamiento; AI Studio consume la lista de modelos del gateway para completar el selector de Modelo en el editor de agentes.
- Gateway URL — URL interna o pública del Beak AI Gateway (p. ej.
http://beak-aigateway-manager.beak-ai-v6.svc:5000). - Project Name — Opcional. Filtra la lista de modelos a un proyecto de gateway específico. Déjelo en blanco para exponer todos los modelos que lista el gateway.
- Virtual Key — Opcional. Requerida cuando el gateway aplica autenticación por clave virtual en el endpoint de lista de modelos.
- Validate & Preview Models — Llama al gateway con los filtros configurados y devuelve la lista de modelos que AI Studio mostraría a los constructores. Úselo antes de guardar para confirmar que los constructores verán los proveedores esperados.
Roles y Permisos
La segunda sección de la página controla quién puede usar AI Studio y qué puede hacer. Abarca cuatro aspectos:
- Roles — Conjuntos de permisos con nombre. Los roles del sistema son proporcionados por la plataforma y son de solo lectura; se pueden crear roles personalizados cuando un rol del sistema otorga más permisos de los que una persona necesita.
- Usuarios — Las personas en el tenant y los roles de Studio que cada una posee. La identidad en sí reside en Beak IAM — una persona aparece aquí una vez que existe como usuario de la plataforma, por lo que lo que se gestiona en esta página es su acceso, no su cuenta.
- Editor de roles — Donde se establecen los permisos de un rol, incluido el selector de alcance de agentes descrito a continuación.
- Auditoría — Un registro de los cambios de autorización recientes, para que un cambio en el acceso de alguien pueda rastrearse hasta quién lo realizó.
Delimitar un rol a agentes específicos
Esta es la parte específica de Studio. Un rol puede otorgarse sobre agentes particulares en lugar de sobre todos los agentes del espacio de trabajo, mediante una selección múltiple de los agentes en este tenant.
Esto permite que un equipo construya y publique sus propios agentes sin darles derechos de edición sobre los de todos los demás — el requisito habitual cuando más de un equipo comparte un espacio de trabajo de Studio.
Nota: Un rol sin alcance de agentes se aplica a todos los agentes. El alcance es una restricción, por lo que agregar un alcance a un rol existente reduce lo que sus titulares pueden acceder — verifique quién tiene un rol antes de delimitarlo.
Mejores Prácticas
- Después de cada cambio de entorno (dev → qa → prod), valide ambas conexiones antes de publicar cualquier agente. Una URL de runtime incorrecta escribe silenciosamente en el entorno equivocado.
- Use Validate & Preview Models después de cualquier cambio en el AI Gateway. Los constructores solo verán lo que el gateway expone — un modelo faltante en el selector es casi siempre un problema de Ajustes.
- Mantenga la API key del runtime en un almacén de secretos con alcance de espacio de trabajo. Rótela cuando cambie la composición del equipo.
- Delimite los roles de constructores a los agentes que posee un equipo una vez que el espacio de trabajo es compartido. Es mucho más fácil ampliar un alcance posteriormente que explicar una edición accidental al agente de otro equipo.
- Prefiera un rol personalizado delimitado a un rol del sistema amplio cuando alguien necesita una capacidad específica y restringida — el registro de auditoría es más fácil de interpretar posteriormente.