Conectar Microsoft Foundry (Azure AI Foundry)
Theus habla el protocolo OpenAI-compatible, así que puedes traer tu propia clave (BYOK) de Microsoft Foundry declarando tres datos: endpoint, API key y nombre del despliegue (modelo).
Antes de empezar
Necesitas tres datos de tu recurso de Microsoft Foundry:
- Endpoint: la URL base OpenAI-compatible de tu recurso.
- API key: una de las claves de acceso del recurso.
- Despliegue (deployment): el nombre con el que publicaste tu modelo. En Theus ese nombre se usa como el id de modelo.
/chat/completions con autenticación por API key funciona. Foundry se conecta como un endpoint personalizado.Opción A — Asistente interactivo
Ejecuta el gestor de proveedores dentro de Theus con el comando slash:
/providers- Elige Añadir proveedor.
- Selecciona Endpoint personalizado (el asistente pedirá base URL, id de modelo y API key opcional).
- Base URL: pega el endpoint OpenAI-compatible de tu recurso Foundry.
- Modelo: escribe el nombre de tu despliegue.
- Pegar API key: pega la clave del recurso (Enter en blanco para omitir y usar una variable de entorno).
- En la pantalla siguiente pulsa Probar conexión para hacer una llamada real de validación al endpoint y luego Guardar.
providers.json con permisos 0600 (solo tú lo lees). Cada guardado hace merge: puedes añadir varios proveedores sin sobrescribir los anteriores.Opción B — Variables de entorno
Si prefieres no persistir nada en disco, define el proveedor por defecto con variables de entorno. Theus las prioriza sobre providers.json:
export THEUS_BASE_URL="https://TU-RECURSO.services.ai.azure.com/..."
export THEUS_API_KEY="TU_API_KEY_DE_FOUNDRY"
export THEUS_MODEL="nombre-de-tu-despliegue"| Variable | Para qué sirve |
|---|---|
THEUS_BASE_URL | Endpoint base OpenAI-compatible. Alias: THEUS_OPENAI_BASE_URL. |
THEUS_API_KEY | Clave de acceso del recurso. Alias de compatibilidad: OPENAI_API_KEY. |
THEUS_MODEL | Nombre del despliegue a usar. Alias: THEUS_OPENAI_MODEL. |
THEUS_PROVIDER_ID | Etiqueta opcional para identificar el proveedor (por defecto env). |
Cómo lo usa Theus
Al enviar un mensaje, Theus construye la petición contra <endpoint>/chat/completions con streaming SSE y autenticación por API key, exactamente como cualquier proveedor OpenAI-compatible. El id de modelo que declaraste (tu despliegue) viaja como el campo model de la petición.
/chat/completions). Copia el endpoint tal cual lo entrega el portal de tu recurso Foundry; no le agregues manualmente la ruta /chat/completions.Verificar la conexión
Además del botón Probar conexión del asistente, puedes reabrir el gestor en cualquier momento con /providers, elegir Editar sobre el proveedor de Foundry y ajustar endpoint, modelo o key. Desde ahí también puedes Eliminar el proveedor o fijar preferencias de routing (costo, calidad o latencia).