diff --git a/docs/ai_actions/img/taxonomy_source_fields.png b/docs/ai_actions/img/taxonomy_source_fields.png new file mode 100644 index 00000000..41eaf43b Binary files /dev/null and b/docs/ai_actions/img/taxonomy_source_fields.png differ diff --git a/docs/ai_actions/work_with_ai_actions.md b/docs/ai_actions/work_with_ai_actions.md index 9aa3e9b1..e8b554f0 100644 --- a/docs/ai_actions/work_with_ai_actions.md +++ b/docs/ai_actions/work_with_ai_actions.md @@ -96,14 +96,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.
-## 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. diff --git a/docs/content_management/create_edit_content_items.md b/docs/content_management/create_edit_content_items.md index 4fab5e47..d0d004dd 100644 --- a/docs/content_management/create_edit_content_items.md +++ b/docs/content_management/create_edit_content_items.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). \ No newline at end of file +!!! 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). diff --git a/docs/content_management/img/taxonomy_suggestions_content.png b/docs/content_management/img/taxonomy_suggestions_content.png new file mode 100644 index 00000000..7e0524cb Binary files /dev/null and b/docs/content_management/img/taxonomy_suggestions_content.png differ diff --git a/docs/content_management/taxonomy/work_with_tags.md b/docs/content_management/taxonomy/work_with_tags.md index b2eca602..9dbc0f0e 100644 --- a/docs/content_management/taxonomy/work_with_tags.md +++ b/docs/content_management/taxonomy/work_with_tags.md @@ -25,7 +25,7 @@ Now, the tag is visible in the taxonomy tree.
-### 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. diff --git a/docs/pim/img/taxonomy_suggestions_products.png b/docs/pim/img/taxonomy_suggestions_products.png new file mode 100644 index 00000000..9e2044cc Binary files /dev/null and b/docs/pim/img/taxonomy_suggestions_products.png differ diff --git a/docs/pim/work_with_product_categories.md b/docs/pim/work_with_product_categories.md index 0542ad70..c84b5fc3 100644 --- a/docs/pim/work_with_product_categories.md +++ b/docs/pim/work_with_product_categories.md @@ -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.