AI instellen

Setup en configuratie

Lees vóór elke stap Voordat u begint en Basisbeginselen van de terminal. Deze instructies gaan ervan uit dat je de volledige supastack monorepo in VS Code hebt geopend; zijn root package.json markeert de root van de repository. In pnpm-opdrachten is een werkruimtepakket een app of map met gedeelde code; in het product is een werkruimte de gegevenscontainer en de beveiligingsgrens van een team. corepack pnpm --filter ... selecteert één pakket uit de monorepo terwijl opdrachten vanuit de root worden uitgevoerd. Als u alleen een gesynchroniseerde mobiele map of desktopmap hebt geopend, bevat deze niet de webbackend, Docker-installatie of rootscripts: voer de backend uit vanaf deze monorepo of een bereikbare gehoste server en gebruik de eigen scripts van de platformmap. Een omgevingsvariabele is een benoemde instelling die is opgeslagen in een lokaal .env-bestand of op uw hostingdashboard; start de relevante app opnieuw nadat u deze hebt gewijzigd en houd servergeheimen buiten de NEXT_PUBLIC_- en EXPO_PUBLIC_-waarden.

1. Open apps/web/.env.local voor de lokale webserver en apps/web/src/agent-runtime.ts voor providerselectie; .env.example is de lijst met ondersteunde instellingsnamen.

2. Bewaar AI_PROVIDER=fake voor lokaal interfacewerk, tenzij u uw eigen provideraccount heeft en de echte generatie wilt testen; Plaats providersleutels nooit in een NEXT_PUBLIC_- of EXPO_PUBLIC_-instelling.

3. Start de webapp vanuit de root van de repository met corepack pnpm --filter @supastack/web dev. Verwacht: lokale schermen kunnen worden verkend zonder een betaalde provider te configureren; Voor daadwerkelijke generatie zijn een geldige serverprovider en ingeschakelde modelkeuzes in de databasecatalogus vereist.

De default AI_PROVIDER=fake ondersteunt lokaal deterministisch werk. Echte providerconfiguratie hoort in de serveromgeving. De providerkeys in .env.example omvatten OpenAI, Anthropic en een OpenAI-compatibel endpoint.

AI_MODEL_POLICY bevat geordende model-ID's voor de aliasen cheap, fast en smart. Een lege aliaslijst schakelt die keuze uit. Model-ID's moeten overeenkomen met ingeschakelde databasecatalogusentries met effectieve immutable prijzen.

AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'
AGENT_FRAMEWORK=ai-sdk    # ai-sdk | mastra | langgraph | openai-agents

Commando's om te kopiëren

Volg de opmerkingen om te zien in welke map een opdracht wordt uitgevoerd. Als twee terminals zijn gelabeld, opent u twee terminalvensters en laat u de eerste opdracht draaien terwijl u de tweede gebruikt.

corepack pnpm --filter @supastack/web dev

Implementatieworkflow

Configureer de catalogus en het workspacebeleid voordat je productietaken accepteert. De browser ontvangt ingeschakelde aliasen, terwijl capability-matching, modelselectie, entitlementchecks en budgethandhaving op de server blijven.

Houd credentials uit NEXT_PUBLIC_- en EXPO_PUBLIC_-variabelen. Gebruik voor bring-your-own-key-modus de bestaande versleutelde envelop en server-decryptiegrens; geef nooit een opgeslagen providerkey terug aan de interface.

Verificatie en probleemoplossing

Als de app meldt dat er geen AI-model beschikbaar is, controleer dan de AI_PROVIDER van de server, de ingeschakelde modellen en prijzen in de beheerderscatalogus en het goedkoop/snel/slimme aliasbeleid. Als een echte provider een authenticatiefout retourneert, controleer dan de sleutel ervan in apps/web/.env.local en start de server opnieuw op. Een sleutel met het voorvoegsel NEXT_PUBLIC_ zou zichtbaar zijn voor browsers en moet worden verwijderd.

Verifieer uitgeschakelde aliasen, ontbrekende capabilities, inactieve entitlement en uitgeputte budgetten. Gebruik een apart geautoriseerde provider-smokerun voor echte generatie. Als geen alias beschikbaar is, inspecteer dan serverbeleid en catalogusconfiguratie in plaats van een rauwe modelselector bloot te stellen.