Merge branch 'master' into IBX-8674

Author: dabrt

.github/workflows/preview_comment.yaml

@@ -0,0 +1,11 @@
+name: "Post preview links for changed files"
+
+on:
+    pull_request: ~
+
+jobs:
+    post-preview-links:
+        name: Post preview links for changed files
+        uses: ibexa/documentation-developer/.github/workflows/preview_comment.yaml@master
+        with:
+            project: 'projects/userguide/'

.readthedocs.yml

@@ -7,9 +7,8 @@ mkdocs:
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.11"
+    python: "3.13"
 
 python:
   install:
-    - requirements: pip_require.txt
     - requirements: requirements.txt

docs/ai_actions/img/ai_action_connect_handler_selection.png

@@ -14,17 +14,17 @@ With the right permissions, you can view all AI actions configured in the applic
 ![AI actions in Admin Panel](img/ai_actions_list.png)
 
 You can narrow down the list of AI actions by filtering it by the status, either Enabled or Disabled, or by the type.
-Out of the box, there are two categories of AI Actions present in the system:
+Out of the box, there are two categories of AI actions present in the system:
 
 - **Refine text** - used by default in [online editor](create_edit_content_items.md#ai-assistant) for refining text, for example: "Rewrite text in formal tone"
 - **Generate alternative text** - used by default in the [image asset editing screen](upload_images.md#ai) to generate alternative text, for example: "Generate short alternative description of an image"
 
-It may happen that a set of sample AI actions has been [installed with the AI Actions package]([[= developer_doc =]]/ai_actions/install_ai_actions/#install-sample-ai-action-configurations-optional), and there is a number of existing AI actions that you can modify and clone.
+It may happen that a set of sample AI actions has been [installed with the AI actions package]([[= developer_doc =]]/ai_actions/install_ai_actions/#install-sample-ai-action-configurations-optional), and there is a number of existing AI actions that you can modify and clone.
 
 !!! note "Custom action types"
 
     In your specific case, the types available can be different, and your organization's development team can create custom AI action types.
-    For more information, see [developer documentation]([[= developer_doc =]]/ai_actions/ai_actions).
+    For more information, see [developer documentation]([[= developer_doc =]]/ai_actions/ai_actions/).
 
 ### View AI action details
 
@@ -88,7 +88,7 @@ You can create AI actions that perform actions of different types, using differe
 
     - **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, **Refine text**
-    - **Model** - sets the AI model used to process the requests resulting from this AI action
+    - **Action handler** - sets the AI model used to process the requests resulting from this AI action
 
 1. In the **Global properties** section, set the name and identifier of the AI action.
 
@@ -101,3 +101,50 @@ For a list of available settings, see [Edit existing AI actions](#edit-existing-
 
 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 =]]
+
+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.
+
+!!! note "[[= product_name_connect =]] configuration required"
+
+    To use AI actions that interface with [[= product_name_connect =]], you must first [configure and initiate the connection]([[= developer_doc =]]/ai_actions/install_ai_actions/#configure-access-to-ibexa-connect), and [define templates](https://doc.ibexa.co/projects/connect/en/latest/scenarios/scenario_templates/#creating-templates) and/or [scenarios](https://doc.ibexa.co/projects/connect/en/latest/scenarios/creating_a_scenario/) in [[= product_name_connect =]].
+    
+1\. Navigate to the Admin Panel and select **AI actions**.
+
+2\. In the **AI actions** list, click **Create**.
+
+3\. In the slide-out pane, make choices like in [Create new AI actions](#create-new-ai-actions) but in the **Action handler** field, select the model that uses an [[= product_name_connect =]] scenario to process the request, for example `connect-image-to-text`, and then click **Create**.
+
+![[[= product_name_connect =]] handler](img/ai_action_connect_handler_selection.png)
+
+4\. In the **Global properties** area, set the required properties.
+
+5\. In the **Settings** area, select an existing scenario from a drop-down list.
+The list contains all scenarios that exist in [[= product_name_connect =]].
+They may be incompatible with the selected action type and require adjustments on the [[= product_name_connect =]] side.
+
+6\. Optionally, if there are no scenarios for the selected action type, or you want to create a custom scenario, click **Create scenario based on template** and select a template from a drop-down list.
+
+If you do so, when you save the new AI action, a new scenario is automatically created.
+You must then fine-tune its settings in [[= product_name_connect =]].
+
+![Ibexa Connect scenario selection](img/ai_action_settings_connect.png)
+
+!!! note "Link to [[= product_name_connect =]]"
+
+    Click **Go to Connect** to review all scenarios that exist in [[= product_name_connect =]].
+
+7\. Click **Save and close** to apply the changes or **Discard** to discard them and close the window.
+
+After you save the AI action, you can click its name in the AI actions list and see all the information, such as Scenario ID, webhook URL, or scenario label, which you may needed when working with scenarios in [[= product_name_connect =]]. 
+
+## Duplicate AI actions
+
+You can duplicate existing actions, for example, to create a variant version of an action with slightly different settings.
+To do so, in the **AI actions** list, click the **Duplicate** icon next to a name of the AI action that you want to duplicate.
+
+You can then modify the duplicated action (for example, change its name or fine-tine the instructions), enable it and save your changes.
+If you discard your changes, the duplicated action will appear on the actions list with status Disabled.

docs/ai_actions/img/ai_action_settings_connect.png

@@ -21,7 +21,7 @@ Available filters are:
 
 !!! note "Order statuses"
 
-    Order statuses visible in the **Status** filter field are defined in the [Order workflow]([[= developer_doc =]]/commerce/order_management/configure_order_management/#order-processing-workflow).
+    Order statuses visible in the **Status** filter field are defined in the [Order workflow]([[= developer_doc =]]/commerce/order_management/configure_order_management/#configure-order-processing-workflow).
 
 - Created - a range of dates between which the order was created
 - Client type - either B2B or B2C client