> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 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.

[Prova la dimostrazione dell'intelligenza artificiale senza credenziali](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

[Configura la generazione dell'IA reale](https://supastack.dev/it/docs/modules/ai-configuration.md)

[Aggiungi modelli e prezzi consentiti](https://supastack.dev/it/docs/web/setup-ai.md)

[Configura esecuzione attività in background](https://supastack.dev/it/docs/modules/jobs.md)


## 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 delivery
```


## Configura 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.


Per continuare la configurazione, leggi [Configura i job in background](https://supastack.dev/it/docs/web/setup-jobs.md).


## Successivo

[Provider AI e policy dei modelli](https://supastack.dev/it/docs/modules/ai-configuration.md)