Problemen met de AI-verbinding
Aivie houdt elke aanroep naar het AI-model bij, voor twee profielen: Chat, dat tekst schrijft, en Beeld, dat afbeeldingen tekent. Heeft een profiel een probleem, dan verschijnt er boven aan elk Aivie-scherm een melding. Deze pagina legt de melding uit en wat je bij elke oorzaak doet. De status van beide profielen staat op het scherm Abonnement, zie AI-verbinding.
Je ziet "AI is tijdelijk niet beschikbaar"
De melding luidt AI is tijdelijk niet beschikbaar. Je beheerder is op de hoogte. Hij zegt niet waarom.
Oorzaak
De laatste aanroep met het chatprofiel is mislukt, of de laatste aanroep met het beeldprofiel is de afgelopen 24 uur mislukt. Alleen leden van Aivie-admin zien de oorzaak, omdat die meestal iets is wat alleen een beheerder kan oplossen. Zie Wie wat ziet.
Een beeldprobleem maakt na de laatste mislukte aanroep slechts 24 uur lang deel uit van de melding. Het chatprofiel telt mee zolang de status Probleem is.
Oplossing
- Meld het aan een lid van Aivie-admin. Die ziet de oorzaak in de melding, zoals hieronder beschreven.
- Zodra de oorzaak is opgelost, verdwijnt de melding vanzelf. Aivie leest de status ongeveer elke minuut opnieuw, dus wacht een minuut en ga naar een ander scherm.
De melding verdwijnt ook als de volgende aanroep lukt, of als een beheerder op Test verbinding drukt en dat slaagt. Zie De melding verdwijnt niet na de oplossing.
De melding toont een regel over de oorzaak
Leden van Aivie-admin zien één regel per profiel met een probleem, en een knop Naar het Abonnement-scherm.
Oorzaak
De zin hangt af van de oorzaak. Aivie leidt de oorzaak af uit het antwoord van de provider. Hieronder staat OpenAI voor de naam van jouw provider.
Oplossing
Zoek je regel in de onderstaande onderdelen en volg de oplossing van dat onderdeel.
De API-sleutel voor OpenAI werkt niet meer
De regel luidt De API-sleutel voor OpenAI werkt niet (meer). Controleer en vervang de sleutel in de instellingen van OpenAI.
Oorzaak
De provider heeft de sleutel geweigerd (HTTP-status 401 of 403, of een antwoord dat zegt dat de sleutel ongeldig is). De sleutel is ingetrokken, verkeerd getypt, of je site kan hem niet meer lezen. Zie na een verhuizing naar een andere server API-sleutel onleesbaar na een verhuizing.
Oplossing
- Maak een werkende sleutel aan in je OpenAI-account, of kopieer er een.
- Vul hem in bij het veld OpenAI secret key van het installatiescherm, druk op Aivie inrichten en herstart de site als het installatiescherm erom vraagt.
- Druk op Test verbinding.
Het tegoed bij OpenAI is op
De regel luidt Het tegoed bij OpenAI is op. Waardeer op bij de provider; daarna werkt Aivie vanzelf weer.
Oorzaak
Het vooruitbetaalde saldo bij je AI-provider is leeg. Dit is het saldo van je eigen account bij de provider, niet iets binnen Aivie. De provider antwoordde met HTTP-status 402, of met een melding over een tegoedsaldo of quotum.
Oplossing
Voeg tegoed toe aan je account bij de provider. Aivie hoeft niets te doen: de status wordt weer OK bij de volgende geslaagde aanroep, of druk op Test verbinding om het meteen te zien.
De uitgavenlimiet bij OpenAI is bereikt
De regel luidt Het ingestelde uitgavenlimiet bij OpenAI is bereikt. Verhoog de limiet bij de provider; daarna werkt Aivie vanzelf weer.
Oorzaak
Een uitgavenlimiet die je bij de provider hebt ingesteld, voor de organisatie of voor het project, is bereikt.
Oplossing
Verhoog de limiet in de instellingen van je provideraccount, of wacht tot de limiet bij de provider wordt gereset. Druk daarna op Test verbinding.
De provider beperkt het aantal verzoeken
De regel luidt OpenAI beperkt op dit moment het aantal aanvragen. Dit lost meestal vanzelf op; probeer het straks opnieuw.
Oorzaak
De provider antwoordde met HTTP-status 429: hij kreeg in korte tijd te veel verzoeken.
Oplossing
Wacht een paar minuten en druk op Test verbinding. Blijft het terugkomen, controleer dan de rate limits van je account bij de provider.
De provider is niet bereikbaar
De regel luidt OpenAI is op dit moment niet bereikbaar. Dit ligt niet aan Aivie; wacht en probeer het later opnieuw.
Oorzaak
De provider ligt eruit of is overbelast (HTTP-status 500, 502, 503, 504 of 529).
Oplossing
Wacht, en bekijk de statuspagina van je provider. De status verdwijnt bij de volgende geslaagde aanroep.
Het ingestelde model bestaat niet meer
De regel luidt Het ingestelde model bestaat niet (meer) bij OpenAI. Controleer de modelnaam in het AI-profiel.
Oorzaak
De provider antwoordde met HTTP-status 404 voor het model van het profiel. Het model is ingetrokken of hernoemd, of de naam ervan is in het profiel gewijzigd.
Oplossing
- Open AI → Profiles.
- Open het profiel met het probleem: het Aivie-chatprofiel (alias
aivie-chat) of het Aivie-beeldprofiel (aliasaivie-beeld). - Kies een model dat je provider aanbiedt, en sla op.
- Druk op Test verbinding.
Een onbekend probleem met de verbinding
De regel luidt Er is een onbekend probleem met de verbinding naar OpenAI. Bekijk de serverlogs voor details.
Oorzaak
De aanroep is mislukt op een manier die Aivie niet herkent, bijvoorbeeld een netwerkfout, of een antwoord zonder bruikbare status.
Oplossing
Kijk in de Umbraco-log. Een mislukte chataanroep wordt gelogd als een fout die begint met Call to agent, gevolgd door de alias van de agent. Een mislukte beeldaanroep wordt gelogd als Image generation failed for, gevolgd door de naam van de afbeelding. De logregel bevat de melding van de provider. Druk op Test verbinding nadat je de oorzaak hebt opgelost.
De melding verdwijnt niet na de oplossing
Oorzaak
De status toont de uitkomst van de laatste aanroep. Nadat je de oorzaak hebt opgelost, verandert hij pas als de volgende aanroep lukt, of als je op Test verbinding drukt.
Oplossing
Leden van Aivie-admin vinden Test verbinding naast de titel AI-verbinding op het scherm Abonnement. Het doet een korte aanroep met het chatprofiel en toont meteen de nieuwe status. Het test het beeldprofiel niet, omdat elke afbeelding geld kost. Een beeldprobleem blijft dus zichtbaar op het scherm Abonnement tot de volgende afbeelding lukt, maar valt na 24 uur uit de melding.
Is er nog geen chatprofiel, dan toont de knop Er is nog geen chatprofiel 'aivie-chat' ingesteld; er valt niets te testen. Voer eerst het installatiescherm uit. Aivie doet deze proefaanroep ook elke ochtend zelf, zie Geplande taken.