Credenciales de IA del Sistema

Credenciales de IA del Sistema es la página a nivel del sistema para gestionar claves API globales de proveedores de IA. Las credenciales añadidas aquí tienen alcance de plataforma (no de un tenant individual) y sirven como proveedores de respaldo cuando un tenant no tiene credenciales de IA propias y su política de IA permite el respaldo a claves del sistema. Los administradores del sistema usan esta página para agregar, probar, habilitar, deshabilitar y eliminar credenciales de proveedores como Anthropic, OpenAI, Google, Mistral, Cohere, Meta y xAI.

Esta página es diferente de la página de credenciales de IA a nivel de tenant en Configuración → IA → Credenciales de IA — esas credenciales tienen alcance de un único tenant. Las credenciales gestionadas aquí son para toda la plataforma y afectan a todos los tenants simultáneamente.

Acceso a la Página

• Ruta: /system-ai-credentials
• Ruta de Menú: Configuración → Sistema → Credenciales de IA
• Audiencia principal: Solo administradores del sistema. Se accede mediante el inicio de sesión de administrador del sistema en system.portal.net — no el portal del tenant.

Qué puedes hacer aquí

• Ver todas las credenciales de proveedores de IA del sistema configuradas, mostradas como tarjetas con el nombre del proveedor, estado habilitado, clave API enmascarada y número de prioridad.
• Agregar una credencial para un nuevo proveedor y configurar su clave API, prioridad y estado habilitado.
• Editar una credencial existente para actualizar su clave API, prioridad o estado habilitado. El proveedor no se puede cambiar después de la creación.
• Probar una credencial para verificar que la clave API es válida y que el proveedor es accesible.
• Eliminar una credencial para removerla permanentemente de la plataforma.
• Habilitar o deshabilitar credenciales individuales sin eliminarlas — las credenciales deshabilitadas se ignoran durante la resolución de respaldo.

Tareas comunes

1. Abrir Configuración → Sistema → Credenciales de IA en system.portal.net.
2. Hacer clic en Agregar Credencial para abrir el diálogo de creación.
3. Seleccionar el proveedor de IA e ingresar la clave API. Establecer la prioridad (números menores se prueban primero) y confirmar que el interruptor Habilitado esté activado.
4. Hacer clic en Agregar para guardar la credencial.
5. Hacer clic en el botón Probar en la nueva tarjeta para verificar que la clave funciona. Una notificación de éxito confirma que la credencial es válida.
6. Si una credencial necesita suspenderse temporalmente, hacer clic en Editar y desactivar Habilitado, luego guardar.

Notas

• La clave API nunca se muestra completa después de guardar. La lista muestra una versión enmascarada (p. ej., sk-...xxxx) para identificación. Para reemplazar una clave, abrir el diálogo de edición e ingresar la nueva clave — dejar el campo en blanco para mantener la clave actual sin cambios.
• La Prioridad determina qué proveedor se selecciona primero durante la resolución de respaldo. Los números menores tienen mayor prioridad. Si dos credenciales comparten la misma prioridad, el orden de selección no está definido.
• Solo se permite una credencial por proveedor a nivel del sistema. El selector de proveedor está deshabilitado en modo de edición.
• Eliminar una credencial del sistema que esté sirviendo activamente como proveedor de respaldo para tenants causará que las solicitudes de IA de esos tenants fallen hasta que se agregue un reemplazo o los tenants configuren sus propias credenciales.
• Tratar estas credenciales como secretos de alto valor. Proporcionan acceso de IA para toda la plataforma. Almacenar las claves originales en una bóveda de secretos aprobada y no compartirlas fuera de canales seguros.

Crear una Credencial de IA del Sistema

Hacer clic en Agregar Credencial en el encabezado de la página. Se abre un diálogo con campos para el proveedor, clave API, prioridad y estado habilitado.

Campos

Campo	Obligatorio	Tipo	Descripción	Predeterminado	Validación
Proveedor	Sí	Selección	Proveedor de IA: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Mistral AI, Cohere, Meta (Llama), xAI (Grok)	Anthropic (Claude)	Una credencial por proveedor; no se puede cambiar después de la creación
Clave API	Sí	Contraseña	Clave API del proveedor — almacenada cifrada; se muestra solo como valor enmascarado después de guardar	—	Obligatoria al crear; dejar en blanco al editar para conservar la clave existente
Prioridad	No	Número	Orden de selección del proveedor durante el respaldo — los números menores se seleccionan primero	0	0–999
Habilitado	No	Interruptor	Si esta credencial está activa y disponible para uso de respaldo	Activado	—

Pasos:

1. Hacer clic en Agregar Credencial en la parte superior derecha de la página.
2. Seleccionar el Proveedor del menú desplegable.
3. Ingresar la Clave API para ese proveedor.
4. Establecer la Prioridad si hay múltiples proveedores y se desea un orden explícito.
5. Confirmar que Habilitado esté activado.
6. Hacer clic en Agregar. La nueva tarjeta de credencial aparece en la cuadrícula.
7. Hacer clic en Probar en la tarjeta para verificar que la clave es válida.

Editar una Credencial de IA del Sistema

Hacer clic en el botón Editar (icono de lápiz) en una tarjeta de credencial. Se abre el mismo diálogo prellenado con los valores actuales.

Mismos campos que al Crear. El campo Proveedor es de solo lectura después de la creación y no se puede cambiar. Dejar el campo Clave API en blanco para conservar la clave existente; ingresar un nuevo valor para reemplazarla.

Eliminar una Credencial de IA del Sistema

Hacer clic en el botón Eliminar (icono de papelera) en la tarjeta de credencial. Aparece un diálogo de confirmación antes de que se elimine la credencial.

1. Hacer clic en el botón Eliminar en la tarjeta objetivo.
2. El diálogo de confirmación muestra el nombre del proveedor y advierte que la eliminación es permanente.
3. Hacer clic en Eliminar para confirmar — la tarjeta se elimina de la cuadrícula y la credencial se borra permanentemente de la plataforma.

Nota: Eliminar una credencial que actualmente sirve como proveedor de respaldo para uno o más tenants interrumpirá las funciones de IA de esos tenants hasta que se configure un reemplazo.

Páginas Relacionadas

• Credenciales de IA — gestión de credenciales de IA a nivel de tenant (diferente de esta página a nivel del sistema)
• Precios de Modelos de IA — tarifas de precio por modelo usadas para calcular cargos de uso de IA
• Gestión de Tenants — revisar políticas de IA individuales de tenants y si se permite el respaldo a credenciales del sistema