Instructions for AI (GPT) assistant for working with products and categories

The add-on adds content generation tools for products and categories to the admin panel. Through an external AI service, it fills descriptions, SEO fields, and starts video generation from a selected product image.

What it does

- generates product and category descriptions;
- generates SEO title and meta description;
- runs bulk generation for selected products and categories;
- can clear description and SEO fields for selected entities through backend handlers;
- starts video generation from a product image;
- stores the task ID, status, service messages, callback response, and final video link;
- adds the finished video to product data for storefront display;
- shows instruction, full description, and changelog tabs in the add-on card.

Where it is located

- Administration → Add-ons → Manage add-ons → AI (GPT) assistant for working with products and categories — add-on card with instruction, description, and change history tabs;
- Administration → Add-ons → Manage add-ons → Settings — General section, Prompt for video generation by image field;
- Administration → Products → Products → product card — description, SEO, and video generation buttons;
- Administration → Products → Categories → category card — description and SEO generation button;
- product and category lists — Generate description and SEO action in the context menu for selected rows.

How to configure

1. Open the add-on settings.
2. If you plan to use video generation, check the Prompt for video generation by image field. By default, it asks for a short realistic product video without text, logos, or watermarks.
3. Make sure the store can reach the external AI service: for bulk generation and video, the service receives the store domain; for video, it must also send a callback to the public HTTPS store URL.
4. For video generation, add at least one image to the product in advance.

How to use it

Product description
1. Open the product card.
2. In the full description block, click Generate description.
3. After the service responds, review the text in the full description field before saving the product.

Product SEO
1. Open the product card.
2. Click Generate SEO.
3. Check the filled SEO title and meta description fields.

Category description and SEO
1. Open the category card.
2. Click Generate description and SEO.
3. If category keywords are filled in, the add-on adds them to the generation prompt for description and SEO.

Bulk generation
1. Select the required rows in the product or category list.
2. In the context menu, choose Generate description and SEO.
3. Wait for the processing notification and spot-check several updated entities.

Video generation
1. Open a product card that has images.
2. Click Generate video.
3. In the popup, select a product image and confirm the launch.
4. The add-on sends the image, prompt, store domain, and callback URL to the external service.
5. The task status will update in the product card. When the service returns the final video link, it appears in the video block and becomes available for storefront display.

How to check it

- after generation, the product or category has filled description and SEO fields;
- bulk action was applied only to the selected products or categories;
- during video generation, a task status appears in the product card;
- after callback or status check, the product card shows a link to the finished video;
- on the storefront, a product with completed generation displays the added video.

If something does not work

- check that the product has an image: without an image, the video button cannot select a file to send;
- check store access to the external AI service and availability of the public HTTPS callback URL;
- check the video prompt field if the service returns an unsuitable result;
- if the video status does not change, open the product card later: the add-on also polls the service and saves callback responses;
- if bulk generation did not fill fields, check admin notifications and service availability.