IBX-9621: Describe creating a Connect-based AI action configurations

docs/ai_actions/work_with_ai_actions.md

@@ -14,12 +14,12 @@ 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"
 
@@ -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,6 +101,43 @@ 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.
 
+## 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 only those scenarios, which are compatible with the selected action type and are associated with your [[= product_name_connect =]] team.
+
+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.