Documentation · Admin Reference
AI Assistant Reference
This document is a reference for the AI Assistant screen of the ADP Car Market Hub plugin (CMH Center → AI Assistant, admin.php?page=as24ci-ai-assistant). The AI Assistant generates marketing text and metadata for your vehicles — vehicle descriptions, SEO titles and descriptions, image alt texts and equipment highlights — directly from the imported vehicle data.
Not to be confused with the AI Support Assistant on the Support screen, which is a help chatbot that answers questions about using the plugin. That is documented separately in the Support Reference. This page is about generating content for your vehicles.
When to use this document
Read this if you are an administrator and you need to:
- Turn AI-generated vehicle descriptions on or off.
- Set the language, tone and length of generated descriptions.
- Automate generation when new vehicles are imported, including SEO metadata, image alt texts and equipment highlights.
- Provide your own prompt template.
- Enable automatic background scans that look for typos and duplicates in your taxonomy terms.
Overview
AI text generation is built in and managed internally through Google Gemini. There is no provider choice, model choice or API key to enter on this page — the AI provisioning is completed by AD Promotion after installation. You only decide what should be generated and how it should read.
Availability is governed by your licence. If the AI feature is not included, the page shows a single "AI Assistant unavailable" card and none of the controls below are shown; contact ADP Car Market Hub support to enable it.
The page is organised into five cards:
| Card | Purpose |
|---|---|
| AI Assistant | The master on/off switch for AI-powered vehicle description generation. |
| Output Settings | Language, writing tone and description length for generated text. |
| Automation | What is generated automatically on import (descriptions, image alt texts, SEO metadata, equipment highlights). |
| Custom Prompt Template | An optional custom prompt with vehicle-data placeholders. |
| Automated Data Quality Monitoring | Optional background AI scans for taxonomy typos and duplicates. |
Requirements or prerequisites
- A user with the plugin's management capability.
- The AI feature must be included in your licence.
- Outbound HTTPS access from the server so the plugin can reach the managed AI service.
- Vehicles in the inventory to generate content for. See Car Importer Reference.
The five AI Assistant cards
1. AI Assistant (enable / disable)
A single switch — Enable AI-powered automatic vehicle description generation via Gemini. When off, no AI descriptions are generated. Save with Save AI Assistant settings.
2. Output Settings
Controls how generated descriptions read:
- Language — the language the descriptions are written in.
- Writing Tone — Professional (factual and business-like), Emotional (engaging and enthusiastic) or Technical (detailed specs focus).
- Description Length — short, medium or long output.
3. Automation
Decides what runs automatically when vehicles are imported. Each option is a toggle:
- Auto-generate on import — generate a description for each newly imported vehicle. Only new imports are affected; existing vehicles that already have an AI description are not regenerated on update. Each generation uses one API call.
- Auto-generate Image Alt-Texts — SEO-friendly alt texts for downloaded vehicle images.
- Auto-generate SEO Metadata — optimised meta titles and descriptions for Yoast / Rank Math.
- Extract Top Highlights — the top five most valuable equipment features as bullet points.
4. Custom Prompt Template
Leave this empty to use the built-in prompt. To take full control of the wording, enter your own template and insert vehicle data with placeholders such as {make}, {model}, {year}, {mileage}, {price}, {equipment} and others listed in the field hint.
5. Automated Data Quality Monitoring
Optional background scans that use AI to flag likely typos and duplicate taxonomy terms (for example two spellings of the same make or model):
- Enable Background Scans — turn the scans on or off.
- Scan Frequency — once or twice daily.
- Preferred Scan Time — the hour the scan should run. Without a server-side cron job, the scan runs on the first site visit after the chosen time. See Server Cron Setup.
Operational notes
- AI work runs through a background queue on a custom 5-minute interval, so generated text may appear a few minutes after import rather than instantly.
- Generation depends on the managed AI service and outbound HTTPS. If the service is unreachable, generation is retried by the queue.
- This page configures generation only; it does not change already-published descriptions unless you re-trigger generation.
Troubleshooting
- The whole page shows "AI Assistant unavailable". The AI feature is not included in your current licence. Contact ADP Car Market Hub support.
- No descriptions are generated. Confirm the Enable AI Assistant switch is on, Auto-generate on import is enabled, and that new vehicles are actually being imported. Existing vehicles are not regenerated automatically.
- Generation seems delayed. Work is processed by the 5-minute background queue; a server-side cron job makes timing more reliable. See Cron And Background Processing.
- SEO metadata does not appear. Confirm a supported SEO plugin (Yoast or Rank Math) is active and that Auto-generate SEO Metadata is enabled.