Differences

This shows you the differences between two versions of the page.

--- assistants:ai_assistant_per_page [2026/07/01 13:38] – [Interface] idonkervoort
+++ assistants:ai_assistant_per_page [2026/10/01 08:34] (current) – [Quick Fill] idonkervoort
@@ Line 11: / Line 11: @@
 Regardless of page, generated content should be reviewed before publication, especially when accuracy and alignment with source material are important. Models are prone to hallucination and making mistakes, the risk of which may be more or less present depending on the subject matter and the type of page being generated. Double-checking is a must!
-----
 ====== Quiz: AI Assistant ======
@@ Line 52: / Line 50: @@
 | Text pages | Columns, Plain Text |
 | Navigators | Multi-Navigator, Multiple Perspectives, Tabbed Navigator+ |
-| Interactivities and media pages | Documentation, 360 Image, Advanced Image, Audio Slideshow, Flickr Slideshow, Graphics and Sound, Image Sequence, Image Viewer, Morph Images |
+| Interactivity and Media pages | Documentation, 360 Image, Advanced Image, Audio Slideshow, Flickr Slideshow, Graphics and Sound, Image Sequence, Image Viewer, Morph Images |
+Depending on the page, the AI Assistant may be available at the top level, on sub-pages, or on individual content items such as columns, tabs, slides, or images.
-Depending on the page, the AI Assistant may be available at top level, on sub-pages, or on individual content items such as columns, tabs, slides, or images.
 ===== General =====
@@ Line 684: / Line 683: @@
 ----
-====== Simulating Question: AI Assistant ======
+====== Stimulating Question: AI Assistant ======
-The **AI Assistant** for **Simulating Question** generates a thought-provoking question and supporting feedback.
+The **AI Assistant** for **Stimulating Question** generates a thought-provoking question and supporting feedback.
 ===== General =====
@@ Line 836: / Line 835: @@
   * objects
+==== Interface ====
+{{:gapfill-interface-ai-mark.png?500}}
+===== Video Demo =====
+The video demo can be viewed at [[https://xot.xerte.org.uk/play_650#page1section6|Xerte AI Demos > Interactivity: Gap Fill]].
 ===== Passage field =====
@@ Line 858: / Line 865: @@
 ===== General =====
-The main **Question** field must already contain the question.
+The **Use Own Question** checkbox toggles the main field. When it is off, the **Subject** field is visible and you need to provide a subject for which both a question and possible answers will be generated. When it is on, the **Question** field is visible. By default, it inherits the question from the page, but can be manually changed. In this case, the question will remain identical and only possible answers will be generated.
-The AI Assistant then generates possible answers for that question.
+===== Interface =====
-===== Important limitation =====
+{{:mcq-interface-ai-base.png?500}}
-The AI Assistant currently generates answers for the question provided in the main **Question** field.
-It does not currently generate both the question and the answers from a subject in one 'go'.
+===== Video Demo =====
+The video demo can be viewed at [[https://xot.xerte.org.uk/play_650#page1section10|Xerte AI Demos > Interactivity: Multiple Choice Question]].
 ===== AI Assistant properties =====
@@ Line 900: / Line 908: @@
   * result categories;
   * interpretation text for the end user.
+===== Interface =====
+{{:inventory-interface-ai-base.png?500}}
+===== Video Demo =====
+The video demo can be viewed at [[https://xot.xerte.org.uk/play_650#page1section21|Xerte AI Demos > Interactivity: Inventory]].
 ===== Classes field =====
@@ Line 934: / Line 953: @@
 A hint is also generated for each sentence pair.
+===== Interface =====
+{{:matchingtexts-interface-ai-base.png?500}}
+===== Video Demo =====
+The video demo can be viewed at [[https://xot.xerte.org.uk/play_650#page1section22|Xerte AI Demos > Interactivity: Matching Texts]].
 ===== AI Assistant properties =====
@@ Line 945: / Line 975: @@
 ===== Notes =====
-The **Sentence Length** field approximately determines the length of each part of the sentence.
+The **Sentence Length** field approximately determines the length of each //part// of the sentence.
 The **Number of Sentences** field determines how many sentence pairs are generated at one time.
@@ Line 967: / Line 997: @@
 The generated paragraph is placed in the **Initial Text** field.
+==== Interface ====
+{{:modify-interface-ai-generate.png?500}}
 ===== Task type: Alter Text =====
@@ Line 975: / Line 1008: @@
 The source text can be text generated by the AI Assistant or text entered manually.
+==== Interface ====
+{{:modify-interface-ai-alter.png?500}}
+Note: because the settings of this window do not feed into a single page, the common settings between alter text and generate mode have been cropped out.
 ===== Text Specifications field =====
@@ Line 1006: / Line 1044: @@
 Use clear, concrete instructions in **Text Specifications**. The more precise the transformation, the more predictable the generated result.
+----
+====== Timeline / Matching Pairs: AI Assistant ======
+The **AI Assistant** for **Timeline / Matching Pairs** generates the individual items used by either a timeline or a matching-pairs activity.
+===== General =====
+Use **Interactivity Mode** to choose the type of activity to generate:
+  * **Timeline** creates an ordered series of steps or events.
+  * **Matching Pairs** creates related item pairs for learners to match.
+Enter a subject and set the **Number of Steps or Pairs**. The AI Assistant then creates that number of **Item** sub-pages.
+Each generated item contains a name and description appropriate to the selected mode.
+The **Interactivity Mode** shown in the AI Assistant inherits the page's current **Interactivity** setting. Check that the correct mode is selected before generating, as it changes the structure and meaning of the generated content.
+===== Interface =====
+{{:timeline-interface-ai-base.png?500}}
+===== Video Demo =====
+At the moment, there is no video demo for this assistant.
+===== AI Assistant properties =====
+^ Property ^ Description ^ Type ^ Additional information ^
+| **Subject** | The subject for the generated timeline or matching activity. | AI input | Required. Be specific about the process, period, sequence, concepts, or relationships to cover. |
+| **Additional Instructions** | Extra guidance about scope, ordering, pair relationships, formatting, or source use. | AI input | Optional. |
+| **Interactivity Mode** | Selects whether the assistant generates a timeline or matching pairs. | Selection / inherited page setting | Options are **Timeline** and **Matching Pairs**. It inherits the page's Interactivity setting. |
+| **Number of Steps or Pairs** | The number of Item sub-pages to generate. | Numeric | Represents steps/events in Timeline mode and pairs in Matching Pairs mode. The default is **5**. |
+| **Reading Level** | Sets the intended reading level of the generated item text. | AI setting | Available in advanced settings. |
+| **Education Level** | Sets the intended education level of the generated item text. | AI setting | Available in advanced settings. |
+| **Tone and Style** | Sets the tone and style of the generated item text. | AI setting | Available in advanced settings. |
+===== Timeline mode =====
+In Timeline mode, describe a subject that has a meaningful chronological or logical order.
+For example:
+<code>
+Subject: The main stages of photosynthesis
+Additional Instructions: Present the stages in the order in which they occur and keep each description concise.
+</code>
+Check the generated order carefully. Dates, causal relationships, and event order should always be verified before publication.
+===== Matching Pairs mode =====
+In Matching Pairs mode, explain what relationship the two parts of each pair should represent.
+For example:
+<code>
+Subject: Key terms in cellular biology
+Additional Instructions: Pair each term with a concise definition. Make every definition distinct enough to avoid ambiguous matches.
+</code>
+Review the generated pairs for duplicate, overlapping, or ambiguous answers.
+===== Quick Fill =====
+This page also has a separate **Quick Fill** assistant.
+Quick Fill creates a chosen number of empty Item sub-pages with default values. It does not generate subject-specific content.
+Use the AI Assistant when you want completed timeline steps or matching pairs. Use Quick Fill when you only want to create the empty activity structure.
+----
+====== Model Answer: AI Assistant ======
+The **AI Assistant** for **Model Answer** creates one or more learner prompts together with model feedback.
+===== General =====
+Enter a single subject and choose the **Number of Questions** to generate.
+The AI Assistant creates that number of **Text Area** items/sub-pages. Each generated item contains:
+  * a prompt for the learner;
+  * feedback containing a suggested or model answer.
+The generated Text Area items can be reviewed and edited independently after generation.
+You can also use the AI Assistant to generate additional items later. Set **Number of Questions** to **1** when you want to add one item at a time.
+===== Interface =====
+{{:modelanswer-interface-ai-base.png?500}}
+===== Video Demo =====
+At the moment, there is no video demo for this assistant.
+===== AI Assistant properties =====
+^ Property ^ Description ^ Type ^ Additional information ^
+| **Subject** | The subject on which the generated prompts and feedback will be based. | AI input | Required. The same subject is used for all items generated in the current operation. |
+| **Additional Instructions** | Extra guidance for the prompts, feedback, format, focus, or use of source material. | AI input | Optional. |
+| **Number of Questions** | The number of Text Area items/sub-pages to create. | Numeric | Each generated item receives its own prompt and feedback. The default is **3**. |
+| **Reading Level** | Sets the intended reading level of the generated prompts and feedback. | AI setting | Available in advanced settings. |
+| **Education Level** | Sets the intended education level of the generated prompts and feedback. | AI setting | Available in advanced settings. |
+| **Tone and Style** | Sets the tone and style of the generated prompts and feedback. | AI setting | Available in advanced settings. |
+===== Notes =====
+Unlike Basic Text Generation, this assistant creates structured child items rather than filling a single text field.
+Review both the learner prompt and the feedback/model answer for every generated item. In particular, check that the feedback answers the corresponding prompt and does not introduce unsupported information.