Documentación
Guía de procedimientos / Modelos y proveedores

Modelos y proveedores

Guía de procedimientos·08/04/2026·Tiempo de lectura: 4 minutos·platform-ui

Se aplica a: administración de plataforma, administradores de la organización

Modelos y proveedores declara qué modelos de inteligencia artificial existen, de qué proveedor salen y quién puede usarlos. Aquí se guarda configuración —conexión del proveedor y catálogo de modelos—; el motor la consulta al ejecutar, pero las llamadas no pasan por esta pantalla.

Qué hace

Una sola carga alimenta toda la pantalla y Actualizar la repite entera. A la administración de plataforma le añade una franja con cuatro cifras: proveedores activos, modelos activos, cuántas de las tres categorías públicas (Razonamiento, Rápido, Imágenes y visión) tienen defecto y si el motor agéntico responde. La cuarta categoría, embeddings, existe en el catálogo pero no participa de la cascada.

Las cinco pestañas

Catálogo pone los proveedores a la izquierda y el detalle del seleccionado a la derecha, con sus modelos en una tabla. Desde ahí se verifica, se edita, se activa o desactiva y se elimina el proveedor. Verificar consulta la ruta de listado de modelos del proveedor, bajo la base URL declarada, y guarda el resultado, por eso la salud sobrevive a una recarga; devuelve además los identificadores que el proveedor dice tener, y los que faltan en el catálogo son botones que abren el alta con el upstream_model_id ya escrito.

Resolución muestra el orden en que se elige modelo: petición explícita, preferencia del usuario, organización y, en último lugar, plataforma. Debajo se fija el defecto de cada categoría y qué usa cada consumidor interno: los roles de razonamiento y rápido del motor, los trabajadores del enjambre, Agent Forge, los insights de administración, las sugerencias de chat y la redacción de encargos. Cada uno sigue una categoría o queda fijado a un modelo, y la fila dice cuál resuelve ahora mismo.

Planes reparte modelos por suscripción, y es opt-in: un modelo sin marcar en ningún plan queda disponible para todos; marcarlo es lo que lo reserva.

Mi organización es la única pestaña que ve un administrador de organización. Lista los modelos que trae el plan, con un interruptor por modelo, y fija sus valores por defecto, indicando si están definidos ahí o heredados de la plataforma.

Diagnóstico contrasta lo que dicen el motor, el Registry y el catálogo. Avisa de los modelos activos sin tarifa en créditos, que impide facturar bien su consumo. Lo que enseña del motor es su modo degradado, no la resolución en vivo.

Estados y su significado

Estado del proveedor Qué ocurrió
Verificado La última comprobación fue correcta.
Con error Falló; el detalle muestra el mensaje.
Sin verificar Nunca se ha comprobado la conexión.
Desactivado No se resolverá, aunque sus modelos estén activos.

Un modelo activo cuyo proveedor está desactivado lleva un aviso: la cascada lo salta. Al borrar un modelo, los agentes que lo tuvieran elegido caen al siguiente nivel.

Importante

La clave de API se cifra al guardarse y no vuelve a mostrarse. Dejar el campo vacío no la borra: conserva la que hubiera, y para retirarla existe Quitar clave. Las cabeceras adicionales sí se guardan en claro.

Advertencia

Eliminar un proveedor borra también todos sus modelos y no se puede deshacer. El diálogo avisa si alguno era el defecto de una categoría: esa categoría deja de resolver.

Quién puede hacer qué

La administración de plataforma ve las cinco pestañas. Un administrador de organización ve solo Mi organización, y como es la única, la barra de pestañas ni se dibuja. Cualquier otra persona se encuentra un muro: un aviso que pide seleccionar una organización, incluso si ya hay una seleccionada. El reparto es cosmético; quien autoriza cada cambio es el Registry.

Pasos siguientes

¿Le ha resultado útil esta página?

Enviar comentarios

Este artículo se publica desde allan-docs. El mismo texto se sirve a los agentes a través del servidor MCP.