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/web/setup-ai.md (or send Accept: text/markdown).
Configura l'AI
Modelli reali dietro gli alias cheap / fast / smart — le chiavi restano sul server.
Installazione e configurazione
Prima di qualsiasi passaggio, leggere Prima di iniziare e Nozioni di base sui terminali. Queste istruzioni presuppongono che tu abbia aperto l'intero supastack monorepo in VS Code; la sua radice package.json contrassegna la radice del repository. Nei comandi pnpm, un pacchetto dell'area di lavoro è un'app o una cartella di codice condiviso; nel prodotto, uno spazio di lavoro è il contenitore dei dati di un team e il limite di sicurezza. corepack pnpm --filter ... seleziona un pacchetto dal monorepo mentre i comandi vengono eseguiti dalla sua radice. Se hai aperto solo una cartella mobile o desktop sincronizzata, non contiene il backend Web, la configurazione di Docker o gli script root: esegui il backend da questo monorepo o da un server ospitato raggiungibile e utilizza gli script della cartella della piattaforma. Una variabile di ambiente è un'impostazione denominata memorizzata in un file .env locale o nel dashboard dell'hosting; riavvia l'app pertinente dopo averla modificata e mantieni i segreti del server fuori dai valori NEXT_PUBLIC_ e EXPO_PUBLIC_.
1. Aprire apps/web/.env.local per il server Web locale e apps/web/src/agent-runtime.ts per la selezione del provider; .env.example è l'elenco dei nomi delle impostazioni supportate.
2. Mantieni AI_PROVIDER=fake per il funzionamento dell'interfaccia locale a meno che tu non abbia il tuo account provider e desideri testare la generazione reale; non inserire mai le chiavi del provider in un'impostazione NEXT_PUBLIC_ o EXPO_PUBLIC_.
3. Avviare l'app Web dalla root del repository con corepack pnpm --filter @supastack/web dev. Previsto: è possibile esplorare le schermate locali senza configurare un provider a pagamento; la generazione effettiva richiede un provider di server valido e scelte di modelli abilitate nel catalogo del database.
L'AI_PROVIDER=fake predefinito supporta il lavoro locale deterministico. La configurazione dei provider reali appartiene all'ambiente server. Le chiavi dei provider elencate in .env.example includono OpenAI, Anthropic e un endpoint compatibile con OpenAI.
AI_MODEL_POLICY contiene ID di modelli ordinati per gli alias cheap, fast e smart. Una lista di alias vuota disabilita quella scelta. Gli ID dei modelli devono corrispondere a righe di catalogo abilitate nel database con prezzi immutabili effettivi.
AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'
AGENT_FRAMEWORK=ai-sdk # ai-sdk | mastra | langgraph | openai-agentsComandi da copiare
Segui i commenti per vedere in quale cartella viene eseguito un comando. Se due terminali sono etichettati, apri due finestre di terminale e mantieni il primo comando in esecuzione mentre usi il secondo.
corepack pnpm --filter @supastack/web devFlusso di implementazione
Configura il catalogo e la policy del workspace prima di accettare attività di produzione. Il browser riceve gli alias abilitati, mentre corrispondenza di capacità, scelta del modello, controlli dei permessi e applicazione dei budget restano lato server.
Tieni le credenziali fuori dalle variabili NEXT_PUBLIC_ e EXPO_PUBLIC_. Per la modalità chiave propria, usa la busta cifrata esistente e la frontiera di decifratura lato server; non restituire mai una chiave di provider memorizzata all'interfaccia.
Verifica e risoluzione dei problemi
Se l'app segnala che non è disponibile alcun modello AI, controlla AI_PROVIDER del server, i modelli e i prezzi abilitati nel catalogo di amministrazione e la politica di alias economico/veloce/intelligente. Se un provider reale restituisce un errore di autenticazione, controlla la sua chiave in apps/web/.env.local e riavvia il server. Una chiave con prefisso NEXT_PUBLIC_ sarebbe visibile ai browser e deve essere rimossa.
Verifica alias disabilitati, capacità mancanti, permesso inattivo e budget esauriti. Usa un'esecuzione di smoke dei provider autorizzata separatamente per la generazione reale. Se nessun alias è disponibile, ispeziona la policy del server e la configurazione del catalogo invece di esporre un selettore di modello grezzo.