Consola
La superficie con sesión iniciada: para qué sirve cada página, quién puede cambiar qué y qué dice una implementación sin consola alojada en lugar de enlazar a una ruta que daría un 404.
Para qué sirve cada página de la consola
| Página | Ruta | Propósito |
|---|---|---|
| Panel | /app | Saldo, gasto de hoy, totales de llamadas, trazas recientes y la residencia predeterminada de la organización. |
| Modelos | /app/models | Endpoints candidatos divididos en invocables, bloqueados por la política vigente y solo catálogo; una fila bloqueada incluye el motivo del propio enrutador. |
| Claves de API | /app/keys | Crear una clave con sus ámbitos, copiar el secreto una vez y revocar claves. |
| Playground | /app/playground | Enviar un prompt a través del enrutador real; la consola llama a la API del lado del servidor, así la clave nunca llega al navegador. |
| Trazas | /app/traces | Metadatos por llamada: modelo, región, motivo de la ruta, latencia y coste, con la retención vigente mostrada junto a la lista. |
| Uso | /app/usage | Llamadas, tokens y gasto por día y por modelo. |
| Políticas | /app/policies | Residencia, listas de permitidos/denegados de proveedores y modelos, límites de precio y el valor de retención que almacena una política. |
| Ajustes | /app/settings | Nombre de la organización, residencia predeterminada, retención predeterminada y el idioma de la consola. |
| Residencia | /app/settings/residency | Qué endpoints admite la política en cuestión y cuáles excluyó el enrutador, con el razonamiento del enrutador. |
| Exportaciones | /app/exports | Descargar traces.json, usage.json, policies.json, la plantilla de DPA y el paquete de auditoría NDJSON. |
| Perfil | /app/profile | Tu propia cuenta: nombre, idioma, correo electrónico, contraseña, verificación, sesiones y eliminación de cuenta. |
| Facturación | /app/billing | Saldo, gasto de este mes y plan. Añadir crédito es un formulario que aparece solo cuando la implementación lo habilita. |
| Equipo | /app/team | Miembros y roles, e invitaciones; el enlace de invitación se muestra para poder copiarlo a mano. |
Quién puede cambiar qué
La consola aplica dos conjuntos de roles. Propietario y administrador gobiernan; desarrollador puede escribir; visor es de solo lectura.
- Gobernar (propietario, administrador): políticas, equipo, ajustes, crédito, revocación de claves y emisión de una clave con el ámbito platform_write.
- Escritura (desarrollador): crear claves de inferencia y gastar crédito de la organización a través del Playground, pero no gobernar.
- Solo lectura (visor): se pueden leer páginas y trazas; se rechaza el Playground.
- Las descargas masivas de la organización (traces.json, usage.json, policies.json, audit.ndjson) necesitan un rol de escritura; me.json es la exportación de la propia cuenta del solicitante y está abierta a todos los miembros.
Tu propia cuenta
Estas acciones solo escriben filas identificadas por el id de usuario de la sesión, así que ningún campo del formulario puede dirigirlas a otra persona.
- Nombre visible e idioma de la consola.
- Dirección de correo electrónico: cambiarla requiere la contraseña actual, y la nueva dirección empieza sin verificar, porque la prueba anterior pertenecía a la dirección anterior.
- Contraseña: al menos 12 caracteres, el mínimo en packages/shared/src/limits.mjs; cambiarla cierra todas las demás sesiones e invalida los enlaces de restablecimiento pendientes.
- Verificación de correo electrónico: una solicitud necesita un transporte de correo configurado; sin uno, la página indica que esta implementación no puede procesarla.
- La lista de sesiones iniciadas, cada una revocable, más un control que cierra la sesión de todos los demás navegadores y mantiene esta; la sesión actual no se puede revocar desde la lista.
- Eliminación de cuenta: se rechaza mientras seas el único propietario de una organización que todavía tiene otros miembros o un saldo de crédito distinto de cero, y el rechazo nombra la organización.
La consola es una implementación
La consola es un hecho de la implementación, no una página pública. Su URL base proviene de PUBLIC_CONSOLE_URL, y el renderizador nunca la adivina.
consoleHref(’/signup’) es la forma del enlace: devuelve el origen de la consola más la ruta, o null cuando no hay ninguna consola configurada.
Los pagos con tarjeta necesitan el indicador stripe_enabled de la implementación. La página de seguridad registra que el gestor de créditos acepta un importe enviado sin verificar un pago, y que el indicador debe permanecer desactivado hasta que eso se corrija y se pruebe.