Proveedores de IA y política de modelos

Configuración y ajustes

Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.

1. Abra apps/web/.env.local para el servidor web local y apps/web/src/agent-runtime.ts para la selección del proveedor; .env.example es la lista de nombres de configuraciones admitidas.

2. Conserve AI_PROVIDER=fake para que funcione la interfaz local a menos que tenga su propia cuenta de proveedor y desee probar la generación real; nunca coloque claves de proveedor en una configuración NEXT_PUBLIC_ o EXPO_PUBLIC_.

3. Inicie la aplicación web desde la raíz del repositorio con corepack pnpm --filter @supastack/web dev. Esperado: las pantallas locales se pueden explorar sin configurar un proveedor pago; La generación real requiere un proveedor de servidor válido y opciones de modelo habilitadas en el catálogo de bases de datos.

El AI_PROVIDER=fake predeterminado permite trabajo local determinista. La configuración de proveedores reales pertenece al entorno del servidor. Las claves de proveedor enumeradas en .env.example incluyen OpenAI, Anthropic y un endpoint compatible con OpenAI.

AI_MODEL_POLICY contiene listas ordenadas de ID de modelo para los alias cheap, fast y smart. Una lista de alias vacía deshabilita esa opción. Los ID de modelo deben corresponder a entradas habilitadas del catálogo de la base de datos con precios inmutables efectivos.

AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'

Comandos para copiar

Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.

corepack pnpm --filter @supastack/web dev

Flujo de implementación

Configura el catálogo y la política del espacio de trabajo antes de aceptar tareas de producción. El navegador recibe los alias habilitados, mientras que la coincidencia de capacidades, la selección del modelo, las comprobaciones de derechos y la aplicación del presupuesto permanecen en el servidor.

Mantén las credenciales fuera de las variables NEXT_PUBLIC_ y EXPO_PUBLIC_. Para el modo de traer tu propia clave, utiliza el sobre cifrado existente y el límite de descifrado del servidor; nunca devuelvas a la interfaz una clave de proveedor guardada.

Verificación y solución de problemas

Si la aplicación informa que no hay ningún modelo de IA disponible, verifique el AI_PROVIDER del servidor, los modelos y precios habilitados en el catálogo de administración y la política de alias barato/rápido/inteligente. Si un proveedor real devuelve un error de autenticación, verifique su clave en apps/web/.env.local y reinicie el servidor. Una clave con el prefijo NEXT_PUBLIC_ sería visible para los navegadores y debe eliminarse.

Verifica los alias deshabilitados, las capacidades ausentes, el derecho inactivo y los presupuestos agotados. Usa una ejecución de prueba autorizada por separado para comprobar proveedores reales. Si no hay ningún alias disponible, inspecciona la política del servidor y la configuración del catálogo en vez de mostrar un selector de modelos sin restricciones.