Differences

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

--- assistants:ai_assistant_per_page [2026/07/01 13:28] – [Best practice] idonkervoort
+++ assistants:ai_assistant_per_page [2026/07/02 13:14] (current) – [Note on accuracy] 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 725: / Line 723: @@
 The subject defines what the rows are about, while the columns define the characteristics that should be included.
+===== Interface =====
+{{:sortablegrid-interface-ai-base.png?500}}
+===== Video Demo =====
+At the moment, there is no video demo for this assistant.
 ===== AI Assistant properties =====
@@ Line 766: / Line 774: @@
 For example, when asking learners to explain an abbreviation, the AI Assistant can generate possible alternative phrasings that should still be accepted as correct.
+===== Interface =====
+{{:dialogue-interface-ai-base.png?500}}
+===== Video Demo =====
+The video demo can be viewed at [[https://xot.xerte.org.uk/play_650#page1section7|Xerte AI Demos > Interactivity: Dialogue]].
 ===== Delimiter note =====
@@ Line 773: / Line 790: @@
 If a different delimiter is needed, add the delimiter optional property and define it there. The AI Assistant settings window will inherit the same value.
-This is important because the AI Assistant needs to know how to separate provided terms and generated answer variations.
+This is important because the AI Assistant needs to know how to separate provided terms and generated answer variations. If you change the delimiter for the AI generation without updating the delimiter in the optional properties, the generated results will likely break your page or refuse to render.
 ===== AI Assistant properties =====
@@ Line 797: / Line 814: @@
 When the task is set to **Generate a Sentence**, the AI Assistant generates text that is placed in the **Gap Fill Text** field.
+==== Interface ====
+{{:gapfill-interface-ai-generate.png?500}}
 ===== Task type: Mark Words as Blanks =====
@@ Line 813: / Line 834: @@
   * 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 835: / Line 864: @@
 ===== 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 877: / Line 907: @@
   * 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 911: / Line 952: @@
 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 922: / Line 974: @@
 ===== 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 944: / Line 996: @@
 The generated paragraph is placed in the **Initial Text** field.
+==== Interface ====
+{{:modify-interface-ai-generate.png?500}}
 ===== Task type: Alter Text =====
@@ Line 952: / Line 1007: @@
 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 =====