Technische opmerkingen over de AI Assistant

Dit document beschrijft de optionele AI Assistant-functie, die op SEO gerichte voertuigbeschrijvingen, alt-teksten voor afbeeldingen, SEO-metadata en uitrustingshoogtepunten genereert op basis van geïmporteerde voertuiggegevens.

AI-functies maken gebruik van de beheerde Google Gemini-configuratie in ADP Car Market Hub. Er is geen providerselectie, modelselectie of invoer van een API-sleutel vereist in de WordPress backend. Klantspecifieke AI-provisioning wordt na installatie door AD Promotion voltooid.

Wanneer u dit document moet gebruiken

Lees dit document als u:

• Wilt beslissen of u de AI Assistant wilt inschakelen voor uw site.
• Wilt begrijpen hoe de achtergrondwachtrij en het genereren per import samenwerken met WP-Cron.
• Het beveiligingsmodel rond de beheerde Gemini-configuratie en admin-triggers wilt controleren.

Overzicht

De AI Assistant is geïmplementeerd in AS24CI\Ai_Assistant. Wanneer deze is ingeschakeld, kan de functie:

• Automatisch een beschrijving genereren als onderdeel van de importstroom (gekoppeld aan as24ci_vehicle_imported).
• Een wachtrij met openstaande generatietaken op de achtergrond verwerken via WP-Cron (as24ci_process_ai_queue).
• Redacteuren in staat stellen handmatig een beschrijving te genereren of opnieuw te genereren vanaf het voertuigbewerkingsscherm, zowel via een AJAX-actie als een eenmalige admin-post-actie.

De functie is opt-in: deze doet niets totdat as24ci_ai_assistant_enabled is ingesteld op '1' en de beheerde Gemini-configuratie is geprovisioneerd. De cron-callback is onvoorwaardelijk geregistreerd, zodat eventuele vooraf geplande taken van een eerdere configuratie nog steeds kunnen worden afgerond.

Beheerde AI-configuratie

De plugin maakt gebruik van een enkele beheerde AI-configuratie die beschikbaar wordt gesteld door AS24CI\Ai_Config. De voorheen hardgecodeerde Gemini-sleutel/model-constanten op Ai_Config zijn verwijderd; de klasse is nu een dunne laag bovenop AS24CI\Ai_Credential_Manager:

• Ai_Config::get_effective_model() — retourneert het vaste runtime Gemini-model, altijd Ai_Credential_Manager::PRIMARY_MODEL (momenteel gemini-3.5-flash). Elke door de API geleverde modelwaarde is uitsluitend metadata en heeft nooit invloed op de runtime-selectie.
• Ai_Config::get_managed_gemini_api_key() — retourneert de Gemini-sleutel van de klant, afkomstig uit de gecodeerde inloggegevens-envelop die server-to-server is gesynchroniseerd vanaf het API Platform. Retourneert een lege string wanneer AI niet kan worden uitgevoerd (geen licentierecht voor ai_allowed of geen opgeslagen inloggegevens). Wordt nooit getoond in de beheerdersinterface, diagnostische gegevens, logs of andere voor gebruikers zichtbare plaatsen.
• Ai_Config::is_configured() — retourneert alleen true wanneer er een bruikbare beheerde Gemini-sleutel beschikbaar is.

De legacy-helpers van Ai_Assistant (get_api_key_for_provider(), get_model(), enz.) zijn behouden voor achterwaartse compatibiliteit en verwijzen naar de beheerde Gemini-waarden. Er is geen providerschakelaar, geen API-sleutelveld per provider en geen modelselectie in de WordPress backend.

Beschikbare uitvoertalen (de, en, fr, it), schrijfstijlen (professional, emotional, technical) en doellengtes (short, medium, long) zijn gedefinieerd als klasseconstanten op Ai_Assistant.

Achtergrondwachtrij

• Cron-hook: as24ci_process_ai_queue.
• Aangepast schema: as24ci_every_5_minutes.
• Batchgrootte per run: maximaal 3 voertuigen.
• Maximaal aantal pogingen per voertuig: 3.
• Limiet voor samenvatting (excerpt): 160 tekens.

De wachtrij stelt de plugin in staat om het genereren van AI-teksten te spreiden over imports, zonder het frontend-verzoek dat de import startte te blokkeren.

Stapsgewijze instructies

Om de AI Assistant in te schakelen en te configureren:

1. Open het tabblad AI Assistant in het beheerderspaneel.
2. Schakel de instelling AI Assistant inschakelen in (as24ci_ai_assistant_enabled = '1').
3. Kies een taal, schrijfstijl, doellengte en (optioneel) een aangepaste prompt.
4. Bepaal of u Automatisch genereren bij import wilt inschakelen (as24ci_ai_assistant_auto_generate).
5. Sla de wijzigingen op en voer een import uit of start een enkele generatie vanaf een voertuigbewerkingsscherm om de verbinding te controleren.

De beheerde Gemini-configuratie is al actief — er worden geen velden voor provider, model of API-sleutel weergegeven in de beheerdersinterface.

Handmatige generatie

Er zijn twee beheerpaden beschikbaar:

• AJAX (as24ci_generate_ai_assistant) — gebruikt door de metabox op het voertuigbewerkingsscherm. Vereist de capability manage_as24_imports en de nonce as24ci_ai_generate.
• Admin-post (as24ci_manual_ai_generate) — verwerkt een eenmalige handmatige Genereren-knop. Vereist de per-post nonce as24ci_manual_ai_generate_<post_id> en de capability edit_post voor het specifieke voertuig.

Beide stromen roepen uiteindelijk de beheerde Gemini-routine aan en schrijven het resultaat terug naar het bericht (post).

Beheerders achtergrond-trigger

De plugin stelt de AJAX-actie as24ci_trigger_ai_queue_now beschikbaar, die onmiddellijk één batch van de AI-wachtrij verwerkt. Deze is beveiligd met manage_as24_imports en de nonce as24ci_trigger_ai_queue_now, en retourneert HTTP 400 als de AI Assistant is uitgeschakeld.

Configuratiereferentie

Voor de volledige lijst met plugin-opties, zie Options And Settings Storage.

Operationele opmerkingen

• Gegevensstroom naar derden: Wanneer de AI Assistant is ingeschakeld, verlaten voertuiggegevens en promptcontext de WordPress-server en worden ze naar het beheerde Google Gemini-eindpunt verzonden. Controleer de toepasselijke gegevensverwerking en contractuele voorwaarden voor de beheerde AI-installatie voordat u AI-functies inschakelt in een productieomgeving.
• Kosten en quota: AI-gebruik loopt via de beheerde Gemini-configuratie die door AD Promotion is geprovisioneerd. De plugin toont geen prijzen per aanroep.
• Snelheidslimieten (Rate limits): Gemini handhaaft verzoek- en tokenlimieten onafhankelijk van de plugin. Mislukte generaties worden maximaal 3 keer per voertuig opnieuw geprobeerd; voertuigen die herhaaldelijk mislukken, worden overgeslagen om oneindige lussen te voorkomen.
• Automatisch genereren start alleen bij imports wanneer zowel de hoofdschakelaar als de optie Automatisch genereren zijn ingeschakeld. Handmatige generatie werkt altijd (ongeacht Automatisch genereren) wanneer de hoofdschakelaar aan staat.
• Beheer van de beheerde sleutel: de beheerde Gemini-sleutel wordt server-to-server geleverd door het API Platform en versleuteld opgeslagen door Ai_Credential_Manager. Deze wordt nooit in platte tekst naar wp_options geschreven, getoond in de beheerdersinterface of weergegeven in diagnostische gegevens of logs.
• Uitschakelen van de functie stopt nieuwe generaties, maar de geregistreerde cron-hook blijft actief zodat reeds in de wachtrij geplaatste taken kunnen worden afgerond. Controleer of de wachtrij leeg is voordat u ervan uitgaat dat de functie volledig is uitgeschakeld.

Problemen oplossen

• Er wordt geen beschrijving gegenereerd bij import — controleer of as24ci_ai_assistant_enabled op '1' staat, Automatisch genereren is ingeschakeld en Ai_Config::is_configured() de waarde true retourneert (beheerde sleutel geprovisioneerd). Controleer het plugin-logboek op Gemini-foutmeldingen.
• Handmatige Genereren-knop doet niets — controleer het netwerktabblad van de browser. Een 403 duidt op een ontbrekende capability of nonce, een 400 geeft aan dat de AI Assistant is uitgeschakeld.
• Wachtrij wordt nooit verwerkt — WP-Cron vereist regelmatig websiteverkeer om geplande taken uit te voeren. Configureer een externe cron-taak of start de wachtrij handmatig via de beheerdersactie AI-wachtrij nu starten. Zie Cron Events And Scheduler.
• Hetzelfde voertuig krijgt na meerdere pogingen nog steeds geen beschrijving — de pogingsteller per voertuig heeft 3 bereikt. Onderzoek de onderliggende Gemini-fout in het logboek voordat u deze reset.

Gerelateerde documenten

• Cron Events And Scheduler
• AJAX Actions
• Options And Settings Storage
• Security And Capabilities
• Import Engine
• Known Limitations And Open Risks