diff --git a/docs/ai-integration/ai-agents/ai-agents_start.mdx b/docs/ai-integration/ai-agents/ai-agents_start.mdx
index e434ddc37e..7878a6c229 100644
--- a/docs/ai-integration/ai-agents/ai-agents_start.mdx
+++ b/docs/ai-integration/ai-agents/ai-agents_start.mdx
@@ -8,6 +8,9 @@ sidebar_position: 0
import CardWithImage from "@site/src/components/Common/CardWithImage";
import CardWithImageHorizontal from "@site/src/components/Common/CardWithImageHorizontal";
import ColGrid from "@site/src/components/ColGrid";
+import aiAgentsStartOvImage from "./assets/ai-agents_start_ovImage.png";
+import aiAgentsStartApiImage from "./assets/ai-agents_start_apiImage.png";
+import aiAgentsStartStudioImage from "./assets/ai-agents_start_studioImage.png";
# AI Agents: Start
@@ -32,24 +35,24 @@ Our technical documentation explains in detail what AI agents are and how to def
If you're new to AI agents, we recommend the [overview](../../ai-integration/ai-agents/ai-agents_overview) page as a good starting point.
-
-
-
+
+
+
-## Lives & videos
+## Videos
-Take a look at our webinars and video content to see AI agents in action, and learn how to create and use them.
+Watch our webinars to see AI agents in action and learn practical implementation techniques.
-
-
-
+
+
+
## In-depth articles
-Once you get to know AI agents, find more about them here:
+Once you get acquainted with AI agents, expand your expertise with a comprehensive guide that includes some practical insights.
-
+
diff --git a/docs/ai-integration/ai-agents/assets/ai-agents_start_apiImage.png b/docs/ai-integration/ai-agents/assets/ai-agents_start_apiImage.png
new file mode 100644
index 0000000000..834870f37d
Binary files /dev/null and b/docs/ai-integration/ai-agents/assets/ai-agents_start_apiImage.png differ
diff --git a/docs/ai-integration/ai-agents/assets/ai-agents_start_ovImage.png b/docs/ai-integration/ai-agents/assets/ai-agents_start_ovImage.png
new file mode 100644
index 0000000000..94cf289840
Binary files /dev/null and b/docs/ai-integration/ai-agents/assets/ai-agents_start_ovImage.png differ
diff --git a/docs/ai-integration/ai-agents/assets/ai-agents_start_studioImage.png b/docs/ai-integration/ai-agents/assets/ai-agents_start_studioImage.png
new file mode 100644
index 0000000000..93c97251cc
Binary files /dev/null and b/docs/ai-integration/ai-agents/assets/ai-agents_start_studioImage.png differ
diff --git a/docs/ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx b/docs/ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx
index f638ef3459..8c420895db 100644
--- a/docs/ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx
+++ b/docs/ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx
@@ -898,7 +898,7 @@ Receivers are typically used asynchronously for multi-step or delayed operations
* When you **finish handling the requested action**,
call `AddActionResponse`. Pass it -
- * The action tool's name.
+ * The action tool's ID.
* The response to send back to the LLM.
Note that the response can be sent at any time, even after the receiver has finished executing,
@@ -962,6 +962,34 @@ Receivers are typically used asynchronously for multi-step or delayed operations
| action | `Func` or `Action` | The receiver function that processes the action request |
| aiHandleError | `AiHandleErrorStrategy` | Errors handling strategy.
`SendErrorsToModel` - Send errors to the model for handling.
`RaiseImmediately` - throw error exceptions.|
+* `AddActionResponse` Definition
+ ```csharp
+ // Closes the action request and sends the response back to the LLM
+ void AddActionResponse(string toolId, string actionResponse)
+ ```
+
+ | Property | Type | Description |
+ |----------|------|-------------|
+ | toolId | `string` | The action request unique ID |
+ | actionResponse | `string` | The response to send back to the LLM through the agent |
+
+
+* `AiAgentActionRequest` class
+ Contains the action request details, sent by the LLM to the agent and passed to the receiver when invoked.
+ ```csharp
+ public class AiAgentActionRequest
+ {
+ // Action tool name
+ public string Name;
+
+ // Action tool unique ID
+ public string ToolId;
+
+ // Request arguments provided by the LLM
+ public string Arguments;
+ }
+ ```
+
### Conversation response:
The LLM response is returned by the agent to the client in an `AiAnswer` object, with an answer to the user prompt and the conversation status, indicating whether the conversation is complete or a further "turn" is required.