---
title: Modelos y proveedores
description: "Cómo se declara el catálogo de modelos, se conecta un proveedor y se decide qué modelo resuelve cada parte de la plataforma. Qué ve un administrador de organización y qué queda reservado a la administración de plataforma."
allan.topic: how-to
allan.service: platform-ui
allan.date: 08/04/2026
allan.ruta: /admin/models
allan.fuente: [app/admin/models/page.tsx, app/admin/models/components.tsx, app/admin/models/forms.tsx]
allan.audiencia: [admin]
allan.aplica_a: administración de plataforma, administradores de la organización
allan.terminos: [agente, organizacion, enjambre, forge, encargo, credito-de-trabajo]
---

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

- [Mi consumo](../area-de-trabajo/mi-consumo.md)