From 0da4ab4b010b599cee0b34b4cdc704e145a8df65 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tomasz=20D=C4=85browski?= <64841871+dabrt@users.noreply.github.com> Date: Thu, 30 Oct 2025 18:44:50 +0100 Subject: [PATCH 1/3] IBX-10868: Describe Anthropic connector in user doc --- docs/ai_actions/work_with_ai_actions.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/docs/ai_actions/work_with_ai_actions.md b/docs/ai_actions/work_with_ai_actions.md index 9aa3e9b1..517580a3 100644 --- a/docs/ai_actions/work_with_ai_actions.md +++ b/docs/ai_actions/work_with_ai_actions.md @@ -5,8 +5,14 @@ description: Create new AI actions or modify existing ones to work faster and in # Work with AI actions AI actions define what results are available to editors in AI-enabled areas, such as, for example, the AI Assistant. -If AI Actions have been configured in your application, and you have the required [permissions]([[= developer_doc =]]/permissions/policies/#ai-actions), including `Action configuration/Edit` and `Action configuration/Create`, you can reconfigure the existing AI actions, and create new ones. +If AI Actions, including at least one service connector, have been configured in your application, and you have the required [permissions]([[= developer_doc =]]/permissions/policies/#ai-actions), including `Action configuration/Edit` and `Action configuration/Create`, you can reconfigure the existing AI actions, and create new ones. +!!! note "Variations in AI action settings" + + The following description outlines the UI options displayed when either the default OpenAI connector or the Anthropic Claude [LTS update]([[= developer_doc =]]/ibexa_products/editions/#lts-updates) is installed and configured. + + Response generation settings may vary depending on the AI service, model implementation, and action type, so the settings shown below might differ from those available in your installation. + ## View AI actions With the right permissions, you can view all AI actions configured in the application by navigating to the Admin Panel and selecting **AI actions**. @@ -19,7 +25,7 @@ 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 already a number of existing AI actions that you can modify and clone. !!! note "Custom action types" @@ -52,22 +58,19 @@ You can modify the existing AI actions. The default request can be seen at the top of the settings area, on a light blue background. -- **Max tokens** - sets a maximum number of "[words](https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-to-count-them)" or tokens that can be used in a single request by both the request and the response +- **Model** - decides what AI service model is used to generate the response + +- **Max tokens** - sets a maximum number of "[words](https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-to-count-them)" or [tokens](https://docs.claude.com/en/docs/about-claude/glossary#tokens) that can be used in a single request by both the request and the response - **Length of prompt output** - sets a maximum number of words of the generated result - **Temperature** - controls the randomness of the response. Takes a value between 0 and 2, but the usual range is between 0 and 1. The output is more random at higher temperatures. -For more information, see the parameter description in [OpenAI API reference](https://platform.openai.com/docs/api-reference/chat/create#chat-create-temperature) +For more information, see the parameter's description in [OpenAI API reference](https://platform.openai.com/docs/api-reference/chat/create#chat-create-temperature) or [Anthropic's glossary](https://docs.claude.com/en/docs/about-claude/glossary#temperature). ![AI action options](img/ai_action_options.png) -!!! note "Action settings availability" - - Action settings differ depending on the AI service used, model implementation and actual action type. - Therefore the settings visible in your installation may vary from the ones presented above. - 5\. Click **Save and close** to apply the changes or **Discard** to discard them and close the window. ## Create new AI actions From 0a505afc585c2ec5a901dcb00bc216dde95e55db Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tomasz=20D=C4=85browski?= <64841871+dabrt@users.noreply.github.com> Date: Fri, 14 Nov 2025 09:51:41 +0100 Subject: [PATCH 2/3] Apply suggestions from code review --- docs/ai_actions/work_with_ai_actions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ai_actions/work_with_ai_actions.md b/docs/ai_actions/work_with_ai_actions.md index 517580a3..60ab391c 100644 --- a/docs/ai_actions/work_with_ai_actions.md +++ b/docs/ai_actions/work_with_ai_actions.md @@ -67,7 +67,7 @@ You can modify the existing AI actions. - **Temperature** - controls the randomness of the response. Takes a value between 0 and 2, but the usual range is between 0 and 1. The output is more random at higher temperatures. -For more information, see the parameter's description in [OpenAI API reference](https://platform.openai.com/docs/api-reference/chat/create#chat-create-temperature) or [Anthropic's glossary](https://docs.claude.com/en/docs/about-claude/glossary#temperature). +For more information, see the parameter's description in [OpenAI API reference](https://platform.openai.com/docs/api-reference/chat/create#chat-create-temperature) or [Anthropic's glossary](https://docs.claude.com/en/docs/about-claude/glossary#temperature) ![AI action options](img/ai_action_options.png) From 067cda0e95c4487a7811afb629d8feb0762bb227 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Wed, 10 Dec 2025 13:25:13 +0100 Subject: [PATCH 3/3] Renamed to Antropic connectoc --- docs/ai_actions/work_with_ai_actions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ai_actions/work_with_ai_actions.md b/docs/ai_actions/work_with_ai_actions.md index 60ab391c..e5674930 100644 --- a/docs/ai_actions/work_with_ai_actions.md +++ b/docs/ai_actions/work_with_ai_actions.md @@ -9,7 +9,7 @@ If AI Actions, including at least one service connector, have been configured in !!! note "Variations in AI action settings" - The following description outlines the UI options displayed when either the default OpenAI connector or the Anthropic Claude [LTS update]([[= developer_doc =]]/ibexa_products/editions/#lts-updates) is installed and configured. + The following description outlines the UI options displayed when either the default OpenAI connector or the Anthropic [LTS update]([[= developer_doc =]]/ibexa_products/editions/#lts-updates) is installed and configured. Response generation settings may vary depending on the AI service, model implementation, and action type, so the settings shown below might differ from those available in your installation.