AI start pages (new start pages for the AI integration branch and the embeddings and vector search sections, edits in existing GenAI and AI agents pages), added embeddings & vector search use cases, and some editing of existing AI content.

Author: reebhub

docs/ai-integration/ai-agents/ai-agents_overview.mdx

@@ -26,33 +26,17 @@ import LanguageContent from "@site/src/components/LanguageContent";
 * Delegating the communication with the LLM to an AI agent can significantly reduce client code complexity and development overhead.
 
 * In this article:
-   * [Common use cases](../../ai-integration/ai-agents/ai-agents_overview#common-use-cases)  
    * [Defining and running AI agents](../../ai-integration/ai-agents/ai-agents_overview#defining-and-running-an-ai-agent)
       * [The main stages in defining an AI agent](../../ai-integration/ai-agents/ai-agents_overview#the-main-stages-in-defining-an-ai-agent)
       * [What is a conversation](../../ai-integration/ai-agents/ai-agents_overview#what-is-a-conversation)
       * [Initiating a conversation](../../ai-integration/ai-agents/ai-agents_overview#initiating-a-conversation)
    * [AI agent usage flowchart](../../ai-integration/ai-agents/ai-agents_overview#ai-agent-usage-flowchart)
    * [Streaming LLM responses](../../ai-integration/ai-agents/ai-agents_overview#streaming-llm-responses)
    * [Reducing throughput and expediting LLM response](../../ai-integration/ai-agents/ai-agents_overview#reducing-throughput-and-expediting-llm-response)
+   * [Common use cases](../../ai-integration/ai-agents/ai-agents_overview#common-use-cases)  
 
 </Admonition>
 
-## Common use cases
-
-AI agents are designed to easily integrate AI capabilities into applications and workflows. They can interact with users, intelligently retrieve and process data from proprietary databases, and apply actions based on roles they are requested to take and the data they have access to. Some of the tasks and applications they can be tailored to perform include:  
-
-<a id="customer-support-chatbot-agents"/> **Customer support chatbot agents** can answer customer queries based on information stored in databases and internal knowledge bases, provide troubleshooting steps, and guide users through processes in real time.  
-
-<a id="data-analysis-and-reporting-agents"/> **Data analysis and reporting agents** can analyze large datasets to extract relevant data and present it in a user-friendly format, escalate customer issues and application output, create reports and highlight points of interest, and help businesses make informed decisions.  
-
-<a id="automated-content-generation-agents"/> **Automated content generation agents** can generate summaries, add automated comments to articles and application-generated content, reference readers to related material, and create marketing content based on user input and stored information.
-
-<a id="workflow-automation-agents"/> **Workflow automation agents** can automate repetitive tasks such as email sorting, spam filtering, form filling, or file organization.  
-
-<a id="intelligent-recommendation-agents"/> **Intelligent recommendation agents** can provide personalized recommendations based on user preferences and available data, e.g. a _library assistant_ suggesting books and other resources, an _HR office assistant_ recommending rewards for employees based on their performance and available facilities near their residence, or an _e-commerce assistant_ recommending products.  
-
-<hr />
-
 ## Defining and running an AI agent
 
 AI agents can be created by RavenDB clients (providing they have database administration permissions).  
@@ -265,3 +249,24 @@ When creating query tools -
 You can limit the number of times that the LLM is allowed to trigger database queries in response to a single user prompt.  
 
 [Setting iterations limit using the API](../../ai-integration/ai-agents/creating-ai-agents/creating-ai-agents_api#set-maximum-number-of-iterations)  
+
+<hr />
+
+## Common use cases
+
+AI agents are designed to easily integrate AI capabilities into applications and workflows. They can interact with users, intelligently retrieve and process data from proprietary databases, and apply actions based on roles they are requested to take and the data they have access to. Some of the tasks and applications they can be tailored to perform include - 
+
+* **Customer support chatbot agents**  
+  Agents can answer customer queries based on information stored in databases and internal knowledge bases, provide troubleshooting steps, and guide users through processes in real time.  
+
+* **Data analysis and reporting agents**  
+  Agents can analyze large datasets to extract relevant data and present it in a user-friendly format, escalate customer issues and application output, create reports and highlight points of interest, and help businesses make informed decisions.  
+
+* **Content generation agents**  
+  Agents can generate summaries, add automated comments to articles and application-generated content, reference readers to related material, and create marketing content based on user input and stored information.
+
+* **Workflow automation agents**  
+  Agents can automate repetitive tasks like email sorting, spam filtering, form filling, or file organization.  
+
+* **Intelligent recommendation agents**  
+  Agents can provide personalized recommendations based on user preferences and available data, e.g. a _library assistant_ suggesting books and other resources, an _HR office assistant_ recommending rewards for employees based on their performance and available facilities near their residence, or an _e-commerce assistant_ recommending products.

docs/ai-integration/ai-agents/ai-agents_start.mdx

@@ -13,24 +13,11 @@ import aiAgentsStartApiImage from "./assets/ai-agents_start_apiImage.png";
 import aiAgentsStartStudioImage from "./assets/ai-agents_start_studioImage.png";
 
 # AI Agents: Start
-
 AI agents are built to easily integrate AI capabilities into RavenDB clients.  
 An AI agent serves as a client's proxy to an AI model; the agent can not only maintain a continuous conversation with the model but also enable it to securely query a RavenDB database and request the client to perform actions.  
 Using AI agents frees developers from the need to manage an AI model in their code, enhances the model by giving it access to a credible and relevant data source, and opens the door to numerous operational scenarios.  
 
-## Use cases
-
-Creating an AI agent and assigning it a role can be done in minutes using Studio or the API, making it easy to address a wide variety of use cases like -    
-
-- [Customer support chatbot agents](../../ai-integration/ai-agents/ai-agents_overview#customer-support-chatbot-agents)  
-- [Data analysis and reporting agents](../../ai-integration/ai-agents/ai-agents_overview#data-analysis-and-reporting-agents)  
-- [Automated content generation agents](../../ai-integration/ai-agents/ai-agents_overview#automated-content-generation-agents)  
-- [Workflow automation agents](../../ai-integration/ai-agents/ai-agents_overview#workflow-automation-agents)  
-- [Intelligent recommendation agents](../../ai-integration/ai-agents/ai-agents_overview#intelligent-recommendation-agents)  
-
-
 ## Technical documentation
-
 Our technical documentation explains in detail what AI agents are and how to define and use them.  
 If you're new to AI agents, we recommend the [overview](../../ai-integration/ai-agents/ai-agents_overview) page as a good starting point.  
 
@@ -40,19 +27,27 @@ If you're new to AI agents, we recommend the [overview](../../ai-integration/ai-
     <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>
 
-## Videos
+## In-depth articles
+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" />
+</ColGrid>
+
+## Videos
 Watch our webinars to see AI agents in action and learn practical implementation techniques.
 
 <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
+## Use cases
+Creating an AI agent and assigning it a role can be done in minutes using Studio or the API, making it easy to address a wide variety of use cases like -    
 
-Once you get acquainted with AI agents, expand your expertise with a comprehensive guide that includes some practical insights.
+- [Customer support chatbot agents](../../ai-integration/ai-agents/ai-agents_overview#customer-support-chatbot-agents)  
+- [Data analysis and reporting agents](../../ai-integration/ai-agents/ai-agents_overview#data-analysis-and-reporting-agents)  
+- [Automated content generation agents](../../ai-integration/ai-agents/ai-agents_overview#automated-content-generation-agents)  
+- [Workflow automation agents](../../ai-integration/ai-agents/ai-agents_overview#workflow-automation-agents)  
+- [Intelligent recommendation agents](../../ai-integration/ai-agents/ai-agents_overview#intelligent-recommendation-agents)  
 
-<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" />
-</ColGrid>