Saltar al contenido
supastack
Explorar la documentación
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/modules/ai.md (or send Accept: text/markdown).

IA y trabajos en segundo plano

De una solicitud autorizada a un resultado duradero.

Pruebe una IA falsa y luego elija un proveedor real

Para obtener el primer resultado, siga la tarea /dashboard del tutorial web: inicie el flujo local, ponga en cola un mensaje, ejecútelo y vea el resultado. AI_PROVIDER=fake devuelve una respuesta de demostración repetible sin enviar datos a un modelo externo ni utilizar una clave API paga.

Para la generación real, primero configure cuentas persistentes, elija un proveedor de IA y siga la configuración de IA a continuación. Agregue un modelo y su precio al catálogo de la base de datos, elija los modelos permitidos para cada alias y otorgue al espacio de trabajo el acceso requerido. Un alias como rápido es una opción amigable que se muestra al usuario; no es en sí mismo el ID de modelo de un proveedor externo.

Un AI task en segundo plano también necesita el servicio de trabajos configurado. Si no se muestran opciones de modelo, inspeccione el catálogo y la política de alias antes de volver a intentarlo. Si se deniega el acceso, inspeccione los derechos del espacio de trabajo activo. Mantenga todas las claves del proveedor API en la configuración del servidor web, no en el navegador, la aplicación móvil o la ventana de escritorio.

Sigue el ciclo de vida de la tarea

La API de tareas de producción valida el espacio de trabajo autenticado y el derecho antes de guardar una tarea y despachar el flujo de Trigger.dev ai.generate. El enrutador aplica los requisitos de capacidad y la política de modelos configurada.

POST /api/ai/tasks
  → authenticated workspace + entitlement
  → durable task record
  → Trigger.dev ai.generate
  → model routing + generation
  → usage record + result
  → transactional completion delivery

Configura alias y presupuestos

El usuario elige un alias habilitado: cheap, fast o smart. El servidor controla los ID de los modelos subyacentes, las credenciales del proveedor, la política del espacio de trabajo y la aplicación del presupuesto. La compatibilidad cifrada para usar una clave propia debe conservar el mismo límite exclusivo del servidor.

Mantén explícita la semántica del flujo de trabajo

JobRunner solo garantiza encolado, estado y cancelación. La semántica del flujo de trabajo de Trigger.dev es explícita e incluye el comportamiento de ejecución duradera. No deduzcas reintentos ni garantías de programación a partir del contrato genérico.

La ruta de envío de producción usa idempotencia y la recuperación de tareas guardadas para gestionar despachos ambiguos. La generación finalizada es independiente de la entrega del correo de finalización.

Si quieres continuar la configuración, lee Configurar los jobs en segundo plano.

Preguntas frecuentes

14 preguntas

¿Qué es supastack?

supastack es una base modular para construir productos SaaS con IA. Reúne la infraestructura común para que puedas centrarte en las funciones propias de tu producto.

¿Soporta web y móvil?

Sí. supastack incluye apps Next.js y Expo como puntos de partida para experiencias web y móviles.

¿Qué autenticación incluye?

Better Auth cubre correo/contraseña, OTP e inicio social. Los espacios de trabajo personales se aprovisionan con la cuenta para que los registros permanezcan delimitados desde el primer día.

¿Cómo se soporta la IA?

supastack incluye IA multi-proveedor configurable, seguimiento de uso, presupuestos y soporte cifrado de claves propias (BYOK).

¿Cómo se gestionan las suscripciones?

Para productos construidos sobre el kit, la facturación Stripe, las suscripciones y los permisos forman la base del acceso de pago. Los secretos de proveedor permanecen en el servidor.

¿Dónde vive el código propio de mi producto?

Las funciones propias del producto permanecen en un codebase separado, mientras el producto configura e integra los módulos base de supastack.

¿Cómo funciona el precio de supastack?

El kit es una compra única con actualizaciones de por vida: Un framework a 249 $ (precio de lanzamiento temporal — 100 $ de descuento sobre el precio habitual de 349 $) o Todos los frameworks (Next.js, iOS, Android) a 499 $ (precio de lanzamiento temporal — 100 $ de descuento sobre el precio habitual de 599 $), más 75 $ por plaza de desarrollador adicional. Sin suscripción al kit. El pago en este sitio entrega tu clave de licencia por correo, con acceso al repositorio por invitación de GitHub.

¿Cómo delimitan los espacios de trabajo mis datos?

Los registros del usuario se delimitan por workspaceId. Identidad, permisos, uso de IA, eventos de facturación y entradas de auditoría permanecen dentro del límite del espacio personal.

¿Cómo funcionan los jobs en segundo plano?

Trigger.dev es el runtime de jobs explícito. El contrato JobRunner solo promete enqueue, status y cancel — la semántica de workflow sigue siendo específica y explícita de Trigger.dev.

¿En qué se diferencia el email de la divulgación?

El email transaccional cubre flujos de producto como avisos de finalización de tareas. La divulgación en frío y las campañas pertenecen al producto, fuera del módulo de email de este kit.

¿Cómo funcionan las compras móviles?

La app móvil incluye compras nativas y restauración con RevenueCat, con acceso verificado por tu servidor. Configura las cuentas de las tiendas y completa las pruebas en dispositivos antes de publicar. La facturación web es independiente.

¿Dónde residen las claves de los proveedores de IA?

Las credenciales BYOK están cifradas y permanecen en el servidor. Las claves se saneen en los logs; el uso y los presupuestos siguen visibles a nivel de espacio de trabajo.

¿Qué métodos de pago acepta el checkout?

El checkout alojado en Stripe acepta tarjetas y, una vez activadas las billeteras en la cuenta de Stripe, también puede ofrecer Alipay y WeChat Pay — muy útil para compradores en China. Las autorizaciones de billetera se confirman de forma asíncrona, por lo que la página de la licencia se actualiza en cuanto se liquida el pago.

¿Puedo obtener un reembolso?

Una vez que tienes acceso al repositorio, supastack es tuyo para siempre, por lo que no se puede reembolsar. Pero no te preocupes: obtienes el código fuente completo con actualizaciones de por vida para crear y lanzar productos ilimitados para ti o tus clientes. Solo no puedes revender el código ni redistribuir el repositorio como plantilla o starter kit.

ES
Tema