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 /it/docs/modules/ai.md (or send Accept: text/markdown).
AI e job in background
Da una richiesta autorizzata a un risultato durevole.
Prova l'intelligenza artificiale falsa, quindi scegli un vero fornitore
Per il primo risultato, segui l'attività /dashboard del tutorial Web: avvia il flusso locale, accoda un prompt, eseguilo e visualizza il risultato. AI_PROVIDER=fake restituisce una risposta dimostrativa ripetibile senza inviare dati a un modello esterno o utilizzare una chiave API a pagamento.
Per la generazione reale, configura prima gli account persistenti, scegli un provider AI e segui la configurazione AI di seguito. Aggiungi un modello e il relativo prezzo al catalogo del database, scegli i modelli consentiti per ciascun alias e concedi allo spazio di lavoro l'accesso richiesto. Un alias come fast è una scelta amichevole mostrata all'utente; non è esso stesso l'ID modello di un provider esterno.
Anche uno sfondo AI task necessita del servizio lavori configurato. Se non viene visualizzata alcuna scelta del modello, controlla il catalogo e la policy di alias prima di riprovare. Se l'accesso viene negato, controlla i diritti dell'area di lavoro attiva. Conserva tutte le chiavi API del provider nella configurazione del server Web, non nel browser, nell'app mobile o nella finestra del desktop.
Segui il ciclo di vita dell'attività
L'API delle attività di produzione valida il workspace autenticato e il permesso prima di persistere un'attività e dispatchare il workflow ai.generate di Trigger.dev. Il router applica i requisiti di capacità e la policy dei modelli configurata.
POST /api/ai/tasks
→ authenticated workspace + entitlement
→ durable task record
→ Trigger.dev ai.generate
→ model routing + generation
→ usage record + result
→ transactional completion deliveryConfigura alias e budget
L'utente sceglie un alias abilitato: cheap, fast o smart. Il server controlla gli ID dei modelli sottostanti, le credenziali dei provider, la policy del workspace e l'applicazione dei budget. Il supporto cifrato delle chiavi proprie deve preservare la stessa frontiera server.
Mantieni esplicita la semantica del workflow
JobRunner promette solo enqueue, status e cancel. La semantica di workflow di Trigger.dev è esplicita, incluso il comportamento di esecuzione durevole. Non dedurre retry né garanzie di scheduling dal contratto generico.
Il percorso di submission di produzione usa idempotenza e ripristino dell'attività salvata per gestire il dispatch ambiguo. Il completamento della generazione è separato dalla consegna dell'email di completamento.