Educaplay

Add images to the activity: for every text you send, it searches the Educaplay image bank and a stock photo library for what you describe, chooses the best match and puts it on that text, without touching the text or its audio. It is the way to add images, and you must call it ONLY when the user asked for images in their own words: never illustrate an activity on your own initiative, not even one you have just written. The user decides WHICH texts get an image and you send exactly those, every one of them: all the questions, every choice, only the correct choices, only the incorrect ones, the odd or the even items, the first five, one named text... whatever they said. Never reduce their selection, never pick a subset of your own and never ask which ones to start with: send the whole selection in this call, up to 40 entries, and call again in the same turn with the rest when there are more. Which texts can hold an image depends on the type: "media_targets.image" in the activity state lists them (for example question and choice, or word, hint, definition, card). A text that already has an image keeps it unless existing is "replace"; one with a video or a youtube link is always left untouched. The result lists in "applied" every text that got its image, with the element and the item it went to and, when known, what the image shows, and in "pending" the texts that are still waiting for theirs.

illustrate_items

List the activity types the assistant can create and edit, with their localized name, what each one is best for, payload key and capabilities. The order changes on every call and "how_to_choose" says how to pick the type of a new activity from it. Not needed when the user already named the type: create_activity takes it directly.

list_activity_types

List the activities of the current user, newest first, with pagination.

list_my_activities

List the media files the user already has in their activities, newest first and with no relation to what they show, so that the user can point at one of them. To choose an image for a text use search_image_library instead: this list cannot tell you what each file contains.

list_my_media

Publish an activity so that it can be played and shared. It checks the publishing blockers itself and, when the activity is not ready, fails with their list.

publish_activity

Take the image or the audio away from texts of the activity, leaving the text and everything else as it is. It cannot be undone. Call it ONLY when the user asked to remove, delete or take away the image or the audio of texts they name, or to swap one medium for the other ("change the image of Paris for an audio": first add the audio, then remove the image). Never use it to change an image for another image or an audio for another audio: that is "existing": "replace" in illustrate_items, set_item_images or generate_field_audio. Send exactly the texts the user named, up to 40 per call. The result lists in "removed" every text that lost it and in "skipped" the ones that had none.

remove_item_media

Remove a label (tag) from an activity by its name.

remove_label

List image candidates WITHOUT adding anything to the activity. Use it only when the user asks to see or to choose among options ("show me options for...", "which images are there of..."): to put images on the activity use illustrate_items, which finds and applies them in one step. Send one query per concept, up to 10 in the same call: each one is answered with candidates from the Educaplay image bank and from a stock photo library, every item with its "source" and a "title" that says what it shows. A call with a single query answers with more candidates and adds the images the user already has. Returned image ids are used in set_item_images.

search_image_library

Set who the activity is aimed at: content language, target audience and knowledge area. Call it only when the user asks for one of these; a title or a description never needs it.

set_activity_audience

Add or replace the content of an activity. The "content" object must follow the schema of the activity type: the "content_schema" that create_activity returned, or get_activity_schema for an activity that already existed. Never guess it.

set_activity_content

Change who can reach the activity: its visibility and whether the Top 10 ranking of scores is hidden. Call it only when the user asks to change one of the two.

set_activity_privacy

Put one specific image, chosen by its id, on texts of the activity, without touching the text or its audio. Only for an image the user pointed at: one of their own files (list_my_media) or a candidate they chose from search_image_library. When the user simply wants images on their texts, use illustrate_items, which finds them by itself. Call it ONLY when the user asked for images in their own words. Which texts can hold an image depends on the type: "media_targets.image" in the activity state lists them (for example question and choice, or word, hint, definition, card). Send the text of that exact element copied from get_activity_content: to illustrate a choice send the choice, to illustrate a question send the question. A text that already has an image keeps it unless existing is "replace"; one with a video or a youtube link is always left untouched. The result says, for every image, which element and which item it went to.

set_item_images

Show texts of the activity as their image alone, or show their text again. Call it ONLY when the user asked for it in their own words: "leave only the flag", "remove the word and keep the picture", "only images in the left column" (hidden), or "put the names back" (shown). Hiding keeps the text stored, so the item can still be named and shown again, and it never touches the image or the audio. Only a text that already has an image can be hidden: when the user wants only images on texts that have none, first add them with illustrate_items and then call this tool in the same turn. Which texts can show only their image depends on the type: "media_targets.image_only" in the activity state lists them; an empty list means the type always shows its texts. Send exactly the texts the user named, up to 40 per call. The result lists in "hidden" or "shown" every text that changed and in "skipped" the ones that could not, with the reason.

set_item_text_visibility

Unpublish an activity so that it can no longer be played. It stays editable and can be published again.

unpublish_activity

Update game settings of an activity (time limit, attempts, shuffling...). Get the editable fields with get_activity_schema(include_settings: true).

update_activity_settings

Update the title and the description of an activity. Send only the one you want to change. An activity needs both to be published, and set_activity_content reports in next_step when they are still empty. The audience and the visibility have their own tools.

update_activity