RDoc-3682 fix links

Author: Danielle9897

docs/ai-integration/ai-agents/creating-ai-agents/content/_creating-ai-agents_api-csharp.mdx

@@ -16,26 +16,26 @@ import Panel from "@site/src/components/Panel";
   and perform actions based on LLM insights.
 
 * This article provides a step-by-step guide to creating an AI agent and interacting with it using the **Client API**.  
-  To create an AI agent from Studio, see [Creating AI agents - Studio](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio).
+  To create an AI agent from Studio, see [Creating AI agents - Studio](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio).
 
 * In this article:
-   * [Create a connection string](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#creating-a-connection-string)  
-   * [Define the agent](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#defining-an-agent-configuration)
-   * [Add agent tools](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#adding-agent-tools)
-      * [Query tools](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#query-tools)
-      * [Action tools](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#action-tools)
-   * [Create the agent](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#creating-the-agent)
-   * [Manage conversations](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#managing-conversations)
-      * [Create a conversation](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#setting-a-conversation)
-      * [Process action-tool requests](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#processing-action-tool-requests)
-         * [Action-tool handlers](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#action-tool-handlers)
-         * [Action-tool receivers](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#action-tool-receivers)
-      * [Set user prompt and RUN the conversation](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#setting-user-prompt-and-running-the-conversation)
-      * [Handle the conversation response](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#conversation-response)
-      * [Stream LLM responses](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#stream-llm-responses)
-   * [Full example](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#full-example)    
-   * [Retrieve existing agents](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#retrieving-existing-agent-configurations)
-   * [Syntax](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#syntax)
+   * [Create a connection string](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#creating-a-connection-string)  
+   * [Define the agent](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#defining-an-agent-configuration)
+   * [Add agent tools](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#adding-agent-tools)
+      * [Query tools](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#query-tools)
+      * [Action tools](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#action-tools)
+   * [Create the agent](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#creating-the-agent)
+   * [Manage conversations](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#managing-conversations)
+      * [Create a conversation](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#setting-a-conversation)
+      * [Process action-tool requests](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#processing-action-tool-requests)
+         * [Action-tool handlers](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#action-tool-handlers)
+         * [Action-tool receivers](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#action-tool-receivers)
+      * [Set user prompt and RUN the conversation](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#setting-user-prompt-and-running-the-conversation)
+      * [Handle the conversation response](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#conversation-response)
+      * [Stream LLM responses](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#stream-llm-responses)
+   * [Full example](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#full-example)    
+   * [Retrieve existing agents](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#retrieving-existing-agent-configurations)
+   * [Syntax](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#syntax)
 
 </Admonition>
 
@@ -44,9 +44,9 @@ import Panel from "@site/src/components/Panel";
 
 Your agent will need a connection string to connect to a **conversational or text generation LLM**.  
 RavenDB supports the following providers for these model types:  
-[Ollama](../../../ai-integration/connection-strings/ollama),
-[OpenAI and compatible providers](../../../ai-integration/connection-strings/open-ai),
-and [Azure OpenAI](../../../ai-integration/connection-strings/azure-open-ai).
+[Ollama](../../../../ai-integration/connection-strings/ollama),
+[OpenAI and compatible providers](../../../../ai-integration/connection-strings/open-ai),
+and [Azure OpenAI](../../../../ai-integration/connection-strings/azure-open-ai).
 
 Choose the model that best suits your needs:  
 You can use a local _Ollama_ model if your priorities are speed, cost, open-source usage, or security.  
@@ -57,9 +57,9 @@ Or use a remote _OpenAI_ service for its broader resources and capabilities.
 
 * **From the Studio**:    
   You can define a connection string in the _AI Connection Strings_ view.
-  See [AI connection strings - Overview](../../../ai-integration/connection-strings/overview).  
+  See [AI connection strings - Overview](../../../../ai-integration/connection-strings/overview).  
   You can also create a connection string when defining an AI agent.
-  See [Configure basic settings](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio#configure-basic-settings).  
+  See [Configure basic settings](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_studio.mdx#configure-basic-settings).  
 
 ---
 
@@ -158,9 +158,9 @@ using (var store = new DocumentStore())
 
 **Syntax reference**    
 See the dedicated syntax sections in the following articles for full configuration details:    
-* [Ollama (syntax)](../../../ai-integration/connection-strings/ollama#syntax)  
-* [OpenAI and compatible providers (syntax)](../../../ai-integration/connection-strings/open-ai#syntax)  
-* [Azure OpenAI (syntax)](../../../ai-integration/connection-strings/azure-open-ai#syntax)  
+* [Ollama (syntax)](../../../../ai-integration/connection-strings/ollama.mdx#syntax)  
+* [OpenAI and compatible providers (syntax)](../../../../ai-integration/connection-strings/open-ai.mdx#syntax)  
+* [Azure OpenAI (syntax)](../../../../ai-integration/connection-strings/azure-open-ai.mdx#syntax)  
 
 </Panel>
 
@@ -178,14 +178,14 @@ See the dedicated syntax sections in the following articles for full configurati
 
 * Populate the `AiAgentConfiguration` instance with your system prompt, agent settings, and tools.  
   The following sections explain how to configure each component of the agent:    
-  * [System prompt](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#system-prompt)  
-  * [Agent name](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#agent-name)  
-  * [Agent ID](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#agent-id)  
-  * [Connection string](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#connection-string)  
-  * [Expected response format](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#expected-response-format)  
-  * [Agent parameters](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#agent-parameters)  
-  * [Maximum number of iterations](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#maximum-number-of-iterations)  
-  * [Chat trimming configuration](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#chat-trimming-configuration)          
+  * [System prompt](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#system-prompt)  
+  * [Agent name](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#agent-name)  
+  * [Agent ID](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#agent-id)  
+  * [Connection string](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#connection-string)  
+  * [Expected response format](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#expected-response-format)  
+  * [Agent parameters](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#agent-parameters)  
+  * [Maximum number of iterations](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#maximum-number-of-iterations)  
+  * [Chat trimming configuration](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#chat-trimming-configuration)          
 
 ---
 
@@ -240,7 +240,7 @@ agentConfiguration.Identifier = "reward-productive-employee";
 <ContentFrame>
 ### Connection string
 
-Provide the name of the connection string you created above in [Create a connection string](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#creating-a-connection-string).    
+Provide the name of the connection string you created above in [Create a connection string](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#creating-a-connection-string).    
 
 ```csharp
 agentConfiguration.ConnectionStringName = connectionString.Name;
@@ -321,9 +321,9 @@ agentConfiguration.OutputSchema = @"
 Agent parameters let you define named placeholders for values used in queries inside query tools.
 
 At configuration time, you define the parameter name (e.g. `country`),  
-which you can then use in the RQL of your [query tools](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#query-tools) as a placeholder (e.g. `$country`).  
+which you can then use in the RQL of your [query tools](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#query-tools) as a placeholder (e.g. `$country`).  
 The values for these parameters are Not set by the LLM - 
-you must provide the actual value at [conversation startup](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#setting-a-conversation).
+you must provide the actual value at [conversation startup](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#setting-a-conversation).
 
 When the agent is requested to execute a query that references an agent parameter,   
 it replaces each placeholder with the corresponding value you supplied at chat startup, before running the query.    
@@ -362,8 +362,8 @@ agentConfiguration.MaxModelIterationsPerCall = 3;
 <Admonition type="note" title="">
 * Note that you can reduce Time To First Byte (TTFB) by streaming the LLM response as it's being generated.  
   This allows the LLM to return selected fields in chunks before the full response is complete.  
-* Find more about streaming in [Streaming LLM responses - overview](../../../ai-integration/ai-agents/overview#streaming-llm-responses) 
-  and in [Stream LLM responses](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#stream-llm-responses) below.  
+* Find more about streaming in [Streaming LLM responses - overview](../../../../ai-integration/ai-agents/overview.mdx#streaming-llm-responses) 
+  and in [Stream LLM responses](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#stream-llm-responses) below.  
 </Admonition>
 
 </ContentFrame>    
@@ -424,19 +424,19 @@ agentConfiguration.ChatTrimming =
 
 ### Query tools
 
-* [Query tools](../../../ai-integration/ai-agents/overview#query-tools) provide the LLM with the ability to retrieve data from the database.  
+* [Query tools](../../../../ai-integration/ai-agents/overview.mdx#query-tools) provide the LLM with the ability to retrieve data from the database.  
   Each query tool includes:  
   * **Description** - a natural-language description that tells the LLM when to use it, 
-  * **RQL** - an [RQL query](../../../client-api/session/querying/what-is-rql) that defines what data to retrieve.
+  * **RQL** - an [RQL query](../../../../querying/rql/what-is-rql.mdx) that defines what data to retrieve.
 
 * To run a query tool at agent startup and provide initial context to the LLM **before** the conversation begins,  
-  see: [Initial-context queries](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#initial-context-queries) below.
+  see: [Initial-context queries](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#initial-context-queries) below.
 
 * **Passing values to a query tool**  
   The RQL in the query tool may include parameter placeholders prefixed with `$` (e.g. `$country`).  
   Both the user and the LLM can pass values to these parameters.  
   * **Passing values from the user**:  
-    Users can pass values to queries through [Agent parameters](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#agent-parameters).  
+    Users can pass values to queries through [Agent parameters](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#agent-parameters).  
     If agent parameters are defined in the agent configuration -  
     * The client must provide values for them when initiating a conversation with the agent.
     * Before executing the query, the agent will replace the placeholders with the provided values.
@@ -519,7 +519,7 @@ agentConfiguration.ChatTrimming =
 
 #### <u>Initial-context queries</u>
 
-* Use the `Options.AddToInitialContext` property to configure a query tool as an [initial-context query](../../../ai-integration/ai-agents/overview#initial-context-queries)
+* Use the `Options.AddToInitialContext` property to configure a query tool as an [initial-context query](../../../../ai-integration/ai-agents/overview.mdx#initial-context-queries)
   so that it executes immediately when the agent starts, before the LLM receives any user input.  
   The results are provided to the LLM as part of the initial conversation context.
 
@@ -653,7 +653,7 @@ agentConfiguration.ChatTrimming =
   * Conversation creation options - including values for any agent parameters, if defined.
 
 * The object returned by the `Conversation` method is used to run the conversation.  
-   See [Set user prompt and run the conversation](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#setting-user-prompt-and-running-the-conversation).
+   See [Set user prompt and run the conversation](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#setting-user-prompt-and-running-the-conversation).
 
 * **Example**  
   <TabItem>
@@ -676,7 +676,7 @@ agentConfiguration.ChatTrimming =
 
   * **Start a new conversation**  
     To start a new conversation, provide a prefix ending with  `/` or `|` (e.g., `Performers/`).  
-    RavenDB will auto-generate the rest of the conversation document ID (see [document ID generation](../../../server/kb/document-identifier-generation)).
+    RavenDB will auto-generate the rest of the conversation document ID (see [document ID generation](../../../../server/kb/document-identifier-generation)).
 
   * **Resume an existing conversation**  
     To resume an existing conversation, provide the full ID of an existing conversation document  
@@ -696,8 +696,8 @@ agentConfiguration.ChatTrimming =
   When this happens, the agent forwards the tool’s name and parameters to the client -  
   and it’s up to the client to handle the request.
 
-* The client can process an action-tool request using either a [Handler](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#action-tool-handlers) 
-  or a [Receiver](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#action-tool-receivers).  
+* The client can process an action-tool request using either a [Handler](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#action-tool-handlers) 
+  or a [Receiver](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#action-tool-receivers).  
 
 ---
 
@@ -909,7 +909,7 @@ if (response.Status == AiConversationResult.Done)
 
 <Admonition type="note" title="">
 Instead of `Run` or `RunAsync`, you can use `StreamAsync` to **stream** the LLM's response as it is generated.  
-See [Stream LLM responses](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#stream-llm-responses).
+See [Stream LLM responses](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#stream-llm-responses).
 </Admonition>
 
 </ContentFrame>
@@ -935,8 +935,8 @@ See [Stream LLM responses](../../../ai-integration/ai-agents/creating-ai-agents/
     The conversation requires further interaction.  
     For example, the LLM may have triggered a tool request, and the conversation is paused until the client processes it.
 
-* See [Return value of Run & Stream](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#return-value-of--run----stream)
-  in the [Syntax](../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#syntax) section below.    
+* See [Return value of Run & Stream](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#return-value-of--run----stream)
+  in the [Syntax](../../../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api.mdx#syntax) section below.    
 
 </ContentFrame>
 
@@ -945,7 +945,7 @@ See [Stream LLM responses](../../../ai-integration/ai-agents/creating-ai-agents/
 ### Stream LLM responses
 
 * Instead of calling `Run` / `RunAsync`, which returns the LLM's response to the client when it is fully prepared,  
-  you can call `StreamAsync` to [Stream llm responses](../../../ai-integration/ai-agents/overview#streaming-llm-responses),
+  you can call `StreamAsync` to [Stream llm responses](../../../../ai-integration/ai-agents/overview.mdx#streaming-llm-responses),
   and receive the LLM's response in real time as it is being generated.
 
 * Streaming allows the client to start processing the response before it is complete,