Provider AI e policy dei modelli

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"]}'

Comandi 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 dev

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