IBX-9621: Document AI / Connect integration

Author: dabrt

docs/ai_actions/img/ai_action_connect_handler.png

@@ -101,37 +101,39 @@ 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 =]] scenarios
+## 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 combining the results of multiple AI services.
-One such example could be sending out text for translation by one service, and then to another to make sure that the resulting translation is written in  selected tone.
+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/initiate_connect_integration/), and [define scenarios](https://doc.ibexa.co/projects/connect/en/latest/scenarios/creating_a_scenario/) and/or templates in [[= product_name_connect =]].
+    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 =]].
     If users from the team are supposed to modify scenario settings, you must [grant them the right roles and permissions](https://doc.ibexa.co/projects/connect/en/latest/access_management/teams/#managing-teams).
 
 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 handler that uses an [[= product_name_connect =]] scenario to process the request, for example `connect-image-to-text`, and then 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.png)
+![[[= 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 a scenario from a drop-down list.
-The list contains only those [[= product_name_connect =]] scenarios, which are compatible with the selected action type.
+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.
 
-In such case, when you save the new AI action, a new scenario, its webhook and data structure are automatically created.
+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)
 
-If you have the right permissions, you can click **Go to Connect** and review all scenarios that exist in [[= product_name_connect =]].
+!!! 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.