====== Image Search and Help Tool ======

The **Image Search and Help Tool** is a general assistant available on any page which is capable of displaying an image in some form. It can also be accessed by clicking the magic-wand icon on any media field which supports image uploads within the editor.

It lets you:

  * search for royalty-free images from supported websites directly in Xerte
  * generate AI images from a text prompt

To use it:

  * navigate to **Assistants** in the right-hand menu
  * open the **Image Search and Help Tool**
  * choose a service
  * enter a query, such as ''blue butterflies''
  * click **Query**

The tool returns up to 10 results. You can then choose which images to keep.

Explore the related sections to learn more about the available settings and general usage guidelines.

===== Image Search and Help Tool Location =====

{{:ai_assistants_all.jpg?200 }} {{:imgsh_inline.jpg?400 }}

===== Image Search and Help Tool Interface =====

{{:imgsh_assistant_interface.jpg?400}}


===== Service =====

The **Service** dropdown lets you choose either:

  * an image website to search
  * an AI model to generate images

Currently supported websites:

  * **Pexels**
  * **Pixabay**

Currently supported models:

  * **DALL·E 2** for generating multiple images
  * **DALL·E 3** for generating a single, higher-quality image
  * **GPT Image** for higher quality image generation.
    * **GPT Image 1** for standard quality images
    * **GPT Image 1.5** for higher quality but slower and more costly image generations
    * **GPT Image 1** mini for quicker and cheaper generation with slightly lower quality


===== Query =====

In the **Query** field, enter the text you want to use for either:
  * an image search
  * an image generation prompt

Which one is used depends on the selected service.

By default, the query is sent to the selected service exactly as entered, without AI modification.

Examples:
  * ''A summer sunset''
  * ''Teacher explaining to students''
  * ''Transparent clipart of paperclip''

===== Enable AI Query Interpretation =====

This option lets an AI model rewrite your query before sending it to the selected service.

The goal is to make the query better match that service's search or generation behaviour, which may help you get more relevant results faster.

===== Enable AI Settings Auto-fill =====

This option instructs AI to automatically infer certain search parameters based on your selected service, such as:

  * colour
  * size
  * orientation

Normally, these values are filled in manually.


===== Using the Tool Without AI =====

The **Image Search and Help Tool** can also be used without AI.

To do this:

  * select **Retrieve Images** in Image Service Type
  * select any vendor
  * clear **Enable AI Query Interpretation**
  * clear **Enable AI Settings Auto-fill**

This allows you to perform a manual search without AI involvement. If your administrator has enabled the Image Search and Help Tool but has not enabled any AI settings, vendors or other functionalities, you will only see the options which do not use AI by default.

**Tip:** Check the messages at the bottom of the AI section to confirm whether AI is currently being used.

{{:imgsh_ai_usage_tio.jpg?400}}


===== Selecting and Keeping Images =====

After the search or generation is complete, a selection window will appear.

From there, you can:

  * choose the images you want to keep
  * close the window if you do not want to keep any

To save images, select the ones you want and click **Keep**.

==== Image Selection Interface ====

{{:imgsh_select_images.jpg?600|}}