AI agents: added images to Start page, added definitions to API page

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.  
 
 <ColGrid colCount={3}>
-    <CardWithImage title="AI Agents - Overview" description="The starting point for the AI agents documentation: an overview of the feature" url="../../ai-integration/ai-agents/ai-agents_overview" imgIcon="ai-agents" imgAlt="imgAlt" ctaLabel="Read now" />
-    <CardWithImage title="Creating an agent using the API" description="Defining an agent configuration, Running a continuous conversation with the LLM, and Getting results via the Client API" url="../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api" imgIcon="ai-agents" imgAlt="imgAlt" ctaLabel="Read now" />
-    <CardWithImage title="Easily creating and testing an AI agent using Studio" url="../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio" imgIcon="ai-agents"  imgAlt="imgAlt" ctaLabel="Read now" />
+    <CardWithImage title="AI Agents - Overview" description="The starting point for the AI agents documentation: an overview of the feature" url="../../ai-integration/ai-agents/ai-agents_overview" imgSrc={aiAgentsStartOvImage} imgAlt="imgAlt" ctaLabel="Read" />
+    <CardWithImage title="Creating an agent using the API" description="Defining an agent configuration, Running a continuous conversation with the LLM, and Getting results via the Client API" url="../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api" imgSrc={aiAgentsStartApiImage} imgAlt="imgAlt" ctaLabel="Read" />
+    <CardWithImage title="Easily creating and testing an AI agent using Studio" url="../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio" imgSrc={aiAgentsStartStudioImage} imgAlt="imgAlt" ctaLabel="Read" />
 </ColGrid>
 
-## 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.
 
-<ColGrid colCount={1}>
-    <CardWithImageHorizontal title="How to run AI agents natively in your database (webinar recording)" description="Live webinar with RavenDB's CEO, Oren Eini" url="https://www.youtube.com/watch?v=A17GSLGN-cQ" imgSrc="https://media.licdn.com/dms/image/v2/D4D10AQG81cXtiYRc2w/image-shrink_800/B4DZZYYLcTHwAk-/0/1745239456036?e=2147483647&v=beta&t=yQVz6ji4wD4reOTXtlPpERK0fdpr1f2VoG_SEV9x3lc" imgAlt="imgAlt" ctaLabel="Watch now" />
-    <CardWithImageHorizontal title="How to create powerful and secure AI agents with RavenDB" description="Webinar with Oren Eini" url="https://www.youtube.com/watch?v=jzUxL9P17G4" imgSrc="https://media.licdn.com/dms/image/v2/D4D10AQG81cXtiYRc2w/image-shrink_800/B4DZZYYLcTHwAk-/0/1745239456036?e=2147483647&v=beta&t=yQVz6ji4wD4reOTXtlPpERK0fdpr1f2VoG_SEV9x3lc" imgAlt="imgAlt" ctaLabel="Watch now" />
+<ColGrid colCount={2}>
+    <CardWithImageHorizontal title="How to run AI agents natively in your database" description="Webinar with Oren Eini" url="https://www.youtube.com/watch?v=A17GSLGN-cQ" imgSrc="https://media.licdn.com/dms/image/v2/D4D10AQG81cXtiYRc2w/image-shrink_800/B4DZZYYLcTHwAk-/0/1745239456036?e=2147483647&v=beta&t=yQVz6ji4wD4reOTXtlPpERK0fdpr1f2VoG_SEV9x3lc" imgAlt="imgAlt" ctaLabel="Watch" />
+    <CardWithImageHorizontal title="How to create powerful and secure AI agents with RavenDB" description="Webinar with Oren Eini" url="https://www.youtube.com/watch?v=jzUxL9P17G4" imgSrc="https://media.licdn.com/dms/image/v2/D4D10AQG81cXtiYRc2w/image-shrink_800/B4DZZYYLcTHwAk-/0/1745239456036?e=2147483647&v=beta&t=yQVz6ji4wD4reOTXtlPpERK0fdpr1f2VoG_SEV9x3lc" imgAlt="imgAlt" ctaLabel="Watch" />
 </ColGrid>
 
 ## 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.
 
 <ColGrid colCount={3}>
-    <CardWithImage title="Practical Look at AI Agents with RavenDB" description="Article by Gracjan Sadowicz" imgSrc="" url="https://ravendb.net/articles/practical-look-at-ai-agents-with-ravendb" imgAlt="imgAlt" ctaLabel="Read now" />
+    <CardWithImage title="Practical Look at AI Agents with RavenDB" description="Article by Gracjan Sadowicz" imgSrc="" url="https://ravendb.net/articles/practical-look-at-ai-agents-with-ravendb" imgAlt="imgAlt" ctaLabel="Read" />
 </ColGrid>

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.  
      <Admonition type="note" title="">
      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<AiAgentActionRequest, TArgs, Task>` or `Action<AiAgentActionRequest, TArgs>` | The receiver function that processes the action request |
       | aiHandleError | `AiHandleErrorStrategy` | Errors handling strategy.<br /> `SendErrorsToModel` - Send errors to the model for handling.<br />`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.