IBX-11004: Describe taxonomy suggestions in user doc (#382)

* IBX-11004: Describe taxonomy suggestions in user doc

* Fixed broken link

* Apply suggestions from code review

Co-authored-by: Mikolaj Adamczyk <[email protected]>

* Review fixes

---------

Co-authored-by: Marek Nocoń <[email protected]>
Co-authored-by: Mikolaj Adamczyk <[email protected]>

Author: 3 people

docs/ai_actions/img/taxonomy_source_fields.png

@@ -97,14 +97,45 @@ You can create AI actions that perform actions of different types, using differe
 
 1. When ready, toggle the status of the AI action to enabled.
 
-1. In the **Settings** area.
+1. Make settings in the **Settings** area.
 For a list of available settings, see [Edit existing AI actions](#edit-existing-ai-actions).
 
 1. Click **Save and close** to apply the changes or **Discard** to discard them and close the window.
 
 <!--ARCADE EMBED START--><div style="position: relative; padding-bottom: calc(51.27314814814815% + 41px); height: 0; width: 100%;"><iframe src="https://demo.arcade.software/4amA1EL6g3fFxSmQoFCp?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Work with AI actions" frameborder="0" loading="lazy" webkitallowfullscreen mozallowfullscreen allowfullscreen allow="clipboard-write" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; color-scheme: light;" ></iframe></div><!--ARCADE EMBED END-->
 
-## Create AI actions that use [[= product_name_connect =]]
+### Create AI actions that control taxonomy suggestions
+
+If the [Taxonomy suggestions]([[= developer_doc =]]/content_management/taxonomy/taxonomy#taxonomy-suggestions) feature is enabled in your system, before editors can use it to pick from product categories or tags suggested by an AI service, you must configure an AI action for the product types or content types of your choice. 
+
+1. Navigate to the Admin Panel and select **AI actions**.
+
+1. In the **AI actions** list, click **Create**.
+
+1. In the slide-out pane, make initial choices in the following fields, and click **Create**:
+
+    - **Language** - sets the base language for the AI action
+    - **Action type** - sets an action type to serve as a template for the AI action, for example, **Suggest taxonomy**
+    - **Action handler** - sets the AI model used to process the requests resulting from this AI action.
+    Pick `taxonomy-text-to-taxonomy` 
+
+1. Make settings in the **Global properties** section, as described above.
+
+1. Make settings in the **Settings** area:
+    1. Select a group of content types or product types that you want to pick types from.
+    1. Select the content types or product types in which you want to allow editors to use taxonomy suggestions.
+    1. Select source fields that contain values to be sent to an AI service for processing.
+    1. Select target fields (of **Taxonomy Entry Assignemnt** type) for which taxonomy entry suggestions are provided.
+
+    ![Selecting source fields](img/taxonomy_source_fields.png "Selecting source fields")
+
+1. Make optional settings, for example:
+    - Define a maximum number of returned suggestions
+    - Set the maximum number of tokens to be used by each call when generating suggestions
+
+1. Click **Save and close** to apply the changes or **Discard** to discard them and close the window.
+
+### Create AI actions that use [[= product_name_connect =]]
 
 If your organization uses [[= product_name_connect =]], you can build multi-step scenarios that define the logic needed to process your input data, for example, by merging the output of multiple AI services.
 One such example could be sending out a text for translation by one service, and then to another to make sure that the resulting translation is written in the right tone.

docs/ai_actions/work_with_ai_actions.md

@@ -257,4 +257,10 @@ For this feature to work as described, the content type must have a **Metadata**
 
 ![Selecting Taxonomy entries](img/taxonomy_select_taxonomy_entries.png "Selecting Taxonomy entries")
 
-For more information, see [Assign tag to content from taxonomy tree](taxonomy/work_with_tags.md#assign-tag-to-content-from-taxonomy-tree).
+!!! note "Taxonomy suggestions" 
+
+    If the [Taxonomy suggestions]([[= developer_doc =]]/content_management/taxonomy/taxonomy#taxonomy-suggestions) feature is enabled in your system, instead of manually browsing the taxonomy tree and selecting tags one by one, you can click **AI Suggest category** and pick from suggestions made by the AI Assistant.
+
+    ![Taxonomy entries suggested by the AI Assistant](img/taxonomy_suggestions_content.png "Taxonomy entries suggested by the AI Assistant")
+
+For more information, see [Assign tag to content from taxonomy tree](taxonomy/work_with_tags.md#add-taxonomy-entry-assignment-field-to-content-type).

docs/content_management/create_edit_content_items.md

@@ -25,7 +25,7 @@ Now, the tag is visible in the taxonomy tree.
 
 <!--ARCADE EMBED START--><div style="position: relative; padding-bottom: calc(51.27314814814815% + 41px); height: 0; width: 100%;"><iframe src="https://demo.arcade.software/l7FSQBrnzGvtBgAaicrs?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Add new tag" frameborder="0" loading="lazy" webkitallowfullscreen mozallowfullscreen allowfullscreen allow="clipboard-write" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; color-scheme: light;" ></iframe></div><!--ARCADE EMBED END-->
 
-### Assign tag to content from taxonomy tree
+### Add Taxonomy Entry Assignment field to content type
 
 Taxonomy is controlled and configured by the *Taxonomy Entry Assignment* field settings, so you can use multiple fields of this type with different taxonomies, for example, tags and product categories in the same content type.
 To be able to assign tags to a Content, first, you need to add a *Taxonomy Entry Assignment* field to the content type definition.

docs/content_management/img/taxonomy_suggestions_content.png

@@ -90,6 +90,12 @@ You can create or change product category relationships with products in two way
 
 ![Adding product categories](img/product_category_selection.png "Adding product categories")
 
+!!! note "Taxonomy suggestions" 
+
+    If the [Taxonomy suggestions]([[= developer_doc =]]/content_management/taxonomy/taxonomy#taxonomy-suggestions) feature is enabled in your system, instead of manually browsing the product category tree and selecting categories one by one, you can click **AI Suggest category** and pick from suggestions made by the AI Assistant.
+
+    ![Product categories suggested by the AI Assistant](img/taxonomy_suggestions_products.png "Product categories suggested by the AI Assistant")
+
 ### Assign products by editing product category details
 
 1. In the left panel, click **Product catalog** -> **Categories** to navigate to the product category tree.