Documentation · Documentation technique

Notes techniques sur l'Assistant IA

Ce document décrit la fonctionnalité optionnelle d'Assistant IA, qui génère des descriptions de véhicules orientées SEO, des textes alternatifs d'images, des métadonnées SEO et des points forts d'équipements à partir des données de véhicules importées.

Les fonctionnalités d'IA utilisent la configuration gérée de Google Gemini dans ADP Car Market Hub. Aucune sélection de fournisseur, sélection de modèle ou saisie de clé API n'est requise dans le back-office de WordPress. Le provisionnement de l'IA spécifique au client est effectué par AD Promotion après l'installation.

Quand utiliser ce document

Lisez ce document si vous devez :

Décider d'activer ou non l'Assistant IA pour votre site.
Comprendre comment la file d'attente en arrière-plan et la génération par import interagissent avec WP-Cron.
Auditer le modèle de sécurité autour de la configuration gérée de Gemini et des déclencheurs d'administration.

Aperçu

L'Assistant IA est implémenté dans AS24CI\Ai_Assistant. Lorsqu'il est activé, il peut :

Générer automatiquement une description dans le cadre du flux d'importation (connecté sur as24ci_vehicle_imported).
Traiter une file d'attente de générations en attente en arrière-plan via WP-Cron (as24ci_process_ai_queue).
Permettre aux éditeurs de générer ou régénérer manuellement une description depuis l'écran d'édition du véhicule, à la fois via une action AJAX et une action admin-post ponctuelle.

La fonctionnalité est optionnelle (opt-in) : elle ne fait rien tant que as24ci_ai_assistant_enabled n'est pas défini sur '1' et que la configuration gérée de Gemini n'est pas provisionnée. Le rappel cron est enregistré de manière inconditionnelle afin que tous les travaux pré-planifiés d'une configuration précédente puissent toujours se terminer.

Configuration IA gérée

Le plugin utilise une configuration IA gérée unique exposée par AS24CI\Ai_Config. Les constantes de clé/modèle Gemini précédemment codées en dur sur Ai_Config ont été supprimées ; la classe est désormais une fine façade sur AS24CI\Ai_Credential_Manager :

Ai_Config::get_effective_model() — renvoie le modèle Gemini d'exécution fixe, toujours Ai_Credential_Manager::PRIMARY_MODEL (actuellement gemini-3.5-flash). Toute valeur de modèle fournie par l'API est uniquement une métadonnée et ne contrôle jamais la sélection d'exécution.
Ai_Config::get_managed_gemini_api_key() — renvoie la clé Gemini du client provenant de l'enveloppe d'identifiants chiffrée synchronisée de serveur à serveur depuis l'API Platform. Renvoie une chaîne vide lorsque l'IA ne peut pas s'exécuter (pas de droit de licence ai_allowed ou pas d'identifiant stocké). Jamais exposée dans l'interface d'administration, les diagnostics, les journaux ou toute surface visible par l'utilisateur.
Ai_Config::is_configured() — renvoie true uniquement lorsqu'une clé Gemini gérée utilisable est disponible.

Les assistants hérités de Ai_Assistant (get_api_key_for_provider(), get_model(), etc.) sont conservés pour la compatibilité ascendante et renvoient aux valeurs Gemini gérées. Il n'y a pas de commutateur de fournisseur, pas de champ de clé API par fournisseur et pas de sélecteur de modèle dans le back-office de WordPress.

Les langues de sortie disponibles (de, en, fr, it), les tons (professional, emotional, technical) et les longueurs cibles (short, medium, long) sont définis comme des constantes de classe sur Ai_Assistant.

File d'attente en arrière-plan

Hook Cron : as24ci_process_ai_queue.
Planification personnalisée : as24ci_every_5_minutes.
Taille du lot par exécution : jusqu'à 3 véhicules.
Nombre maximal de tentatives par véhicule : 3.
Limite de l'extrait : 160 caractères.

La file d'attente permet au plugin de répartir la génération par IA sur les importations sans bloquer la requête front-end qui les a déclenchées.

Instructions étape par étape

Pour activer et configurer l'Assistant IA :

Ouvrez l'onglet d'administration Assistant IA.
Activez le réglage Activer l'Assistant IA (as24ci_ai_assistant_enabled = '1').
Choisissez une langue, un ton, une longueur cible et un prompt personnalisé (facultatif).
Décidez d'activer ou non la Génération automatique à l'importation (as24ci_ai_assistant_auto_generate).
Enregistrez et lancez une importation ou déclenchez une génération unique depuis l'écran d'édition d'un véhicule pour vérifier la connectivité.

La configuration gérée de Gemini est déjà en place — aucun champ de fournisseur, de modèle ou de clé API n'est présenté dans l'interface d'administration.

Génération manuelle

Deux chemins d'administration existent :

AJAX (as24ci_generate_ai_assistant) — utilisé par la boîte méta sur l'écran d'édition du véhicule. Nécessite la capacité manage_as24_imports et le nonce as24ci_ai_generate.
Admin-post (as24ci_manual_ai_generate) — gère un bouton manuel de Génération ponctuel. Nécessite le nonce par publication as24ci_manual_ai_generate_<post_id> et la capacité edit_post pour le véhicule spécifique.

Les deux flux appellent finalement la routine Gemini gérée et réécrivent le résultat dans la publication.

Déclencheur d'arrière-plan d'administration

Le plugin expose l'action AJAX as24ci_trigger_ai_queue_now qui traite immédiatement un lot de la file d'attente de l'IA. Elle est protégée par manage_as24_imports et le nonce as24ci_trigger_ai_queue_now, et renvoie un code HTTP 400 si l'Assistant IA est désactivé.

Référence de configuration

Clé d'option	Objectif
`as24ci_ai_assistant_enabled`	Commutateur principal. `'1'` active la fonctionnalité.
`as24ci_ai_assistant_language`	Langue de sortie (`de`, `en`, `fr`, `it`).
`as24ci_ai_assistant_tone`	Ton d'écriture (`professional`, `emotional`, `technical`).
`as24ci_ai_assistant_max_length`	Longueur cible (`short`, `medium`, `long`).
`as24ci_ai_assistant_auto_generate`	Générer pendant le flux d'importation lorsque `'1'`.
`as24ci_ai_assistant_custom_prompt`	Modèle de prompt facultatif.

Pour la liste complète des options du plugin, voir Options And Settings Storage.

Notes opérationnelles

Flux de données tiers : Lorsque l'Assistant IA est activé, les données du véhicule et le contexte du prompt quittent le serveur de WordPress et sont envoyés au point de terminaison géré de Google Gemini. Examinez le traitement des données applicable et les conditions contractuelles de la configuration de l'IA gérée avant d'activer les fonctionnalités d'IA en production.
Coût et quota : L'utilisation de l'IA s'impute sur la configuration gérée de Gemini provisionnée par AD Promotion. Le plugin n'expose pas de tarification par appel.
Limites de taux : Gemini applique des limites de requêtes et de jetons indépendamment du plugin. Les générations ayant échoué sont retentées jusqu'à 3 fois par véhicule ; les véhicules en échec persistant sont abandonnés pour éviter les boucles infinies.
La génération automatique ne se déclenche que lors des importations lorsque le commutateur principal et l'option Génération automatique sont tous deux activés. La génération manuelle fonctionne toujours (indépendamment de la Génération automatique) lorsque le commutateur principal est activé.
Gestion de la clé gérée : la clé Gemini gérée est fournie de serveur à serveur par l'API Platform et conservée de manière chiffrée par Ai_Credential_Manager. Elle n'est jamais écrite dans wp_options en texte clair, affichée dans l'interface d'administration, ou imprimée dans les diagnostics ou les journaux.
La désactivation de la fonctionnalité arrête les nouvelles générations, mais le hook cron enregistré reste afin que les tâches déjà en file d'attente puissent se terminer. Vérifiez que la file d'attente est vide avant de considérer que la fonctionnalité est totalement désactivée.

Dépannage

Aucune description n'est générée lors de l'importation — confirmez que as24ci_ai_assistant_enabled est défini sur '1', que la Génération automatique est activée et que Ai_Config::is_configured() renvoie true (clé gérée provisionnée). Vérifiez le journal du plugin pour les réponses d'erreur de Gemini.
Le bouton manuel Générer ne fait rien — vérifiez l'onglet réseau du navigateur. Un code 403 indique une capacité ou un nonce manquant, un code 400 indique que l'Assistant IA est désactivé.
La file d'attente ne se vide jamais — WP-Cron nécessite un trafic régulier sur le site pour déclencher les événements planifiés. Configurez une tâche cron externe ou déclenchez la file d'attente manuellement via l'action d'administration Déclencher la file d'attente de l'IA maintenant. Voir Cron Events And Scheduler.
Le même véhicule ne reçoit jamais de description après plusieurs tentatives — le compteur de tentatives par véhicule a atteint 3. Examinez l'erreur Gemini sous-jacente dans le journal avant de réinitialiser.