review of all chat pages except reference

Author: guimachiavelli

learn/chat/conversational_search.mdx

@@ -1,34 +1,25 @@
 ---
-title: Conversational search
-sidebarTitle: Conversational search
-description: Learn how to implement AI-powered conversational search using Meilisearch's chat feature
+title: What is conversational search?
+description: Conversational search is an AI-powered feature that allows users to ask questions in everyday language and receive answers based on the information in Meilisearch's indexes
 ---
 
-Meilisearch's chat completions feature enables AI-powered conversational search, allowing users to ask questions in natural language and receive direct answers based on your indexed content. This feature transforms the traditional search experience into an interactive dialogue.
+## What is conversational search?
 
-<Note>
-This is an experimental feature. Use the Meilisearch Cloud UI or the experimental features endpoint to activate it:
+In conversational search interfaces, users ask questions in everyday language instead of using keywords, and receive complete answers rather than links to articles.
 
-```sh
-curl \
-  -X PATCH 'MEILISEARCH_URL/experimental-features/' \
-  -H 'Content-Type: application/json' \
-  --data-binary '{
-    "chatCompletions": true
-  }'
-```
-</Note>
+## When to use chat completions vs traditional search
 
-## What is conversational search?
+Use conversational search when:
 
-Conversational search interfaces allow users to:
+- Users need easy-to-read answers to specific questions
+- You are handling informational-dense content, such as software documentation and knowledge bases
+- Natural language interaction improves user experience
 
-- Ask questions in natural language instead of using keywords
-- Receive direct answers rather than just document links
-- Maintain context across multiple questions
-- Get responses grounded in your actual content
+Use traditional search when:
 
-This approach bridges the gap between traditional search and modern AI experiences, making information more accessible and intuitive to find.
+- Users need to browse multiple options, such as an ecommerce website
+- Approximative answers are not acceptable
+- Your users need very quick responses
 
 ## How chat completions differs from traditional search
 
@@ -43,73 +34,24 @@ This approach bridges the gap between traditional search and modern AI experienc
 1. User asks a question in natural language
 2. Meilisearch retrieves relevant documents
 3. AI generates a direct answer based on those documents
-4. User can ask follow-up questions
-
-## When to use chat completions vs traditional search
-
-### Use conversational search when:
 
-- Users need direct answers to specific questions
-- Content is informational (documentation, knowledge bases, FAQs)
-- Users benefit from follow-up questions
-- Natural language interaction improves user experience
+## Implementation strategies
 
-### Use traditional search when:
+### Retrieval Augmented Generation (RAG)
 
-- Users need to browse multiple options
-- Results require comparison (e-commerce products, listings)
-- Exact matching is critical
-- Response time is paramount
+In the majority of cases, you should use the [`/chats` route](/reference/api/chats) to build a Retrieval Augmented Generation (RAG) pipeline. RAGs excel when working with unstructured data and emphasise high-quality responses.
 
-## Use chat completions to implement RAG pipelines
-
-The chat completions feature implements a complete Retrieval Augmented Generation (RAG) pipeline in a single API endpoint. Meilisearch's chat completions consolidates RAG creation into one streamlined process:
+Meilisearch's chat completions consolidates RAG creation into a single process:
 
 1. **Query understanding**: automatically transforms questions into search parameters
 2. **Hybrid retrieval**: combines keyword and semantic search for better relevancy
 3. **Answer generation**: uses your chosen LLM to generate responses
 4. **Context management**: maintains conversation history by constantly pushing the full conversation to the dedicated tool
 
-### Alternative: MCP integration
-
-When integrating Meilisearch with AI assistants and automation tools, consider using [Meilisearch's Model Context Protocol (MCP) server](/guides/ai/mcp). MCP enables standardized tool integration across various AI platforms and applications.
-
-## Architecture overview
-
-Chat completions operate through workspaces, which are isolated configurations for different use cases. Each workspace can:
-
-- Use different LLM sources (openAi, azureOpenAi, mistral, gemini, vLlm)
-- Apply custom prompts
-- Access specific indexes based on API keys
-- Maintain separate conversation contexts
-
-### Key components
-
-1. **Chat endpoint**: `/chats/{workspace}/chat/completions`
-   - OpenAI-compatible interface
-   - Supports streaming responses
-   - Handles tool calling for index searches
-
-2. **Workspace settings**: `/chats/{workspace}/settings`
-   - Configure LLM provider and model
-   - Set system prompts
-   - Manage API credentials
-
-3. **Index integration**:
-   - Automatically searches relevant indexes
-   - Uses existing Meilisearch search capabilities
-   - Respects API key permissions
-
-## Security considerations
-
-The chat completions feature integrates with Meilisearch's existing security model:
+Follow the [chat completions tutorial](/learn/chat/getting_started_with_chat) for information on how to implement a RAG with Meilisearch.
 
-- **API key permissions**: chat only accesses indexes visible to the provided API key
-- **Tenant tokens**: support for multi-tenant applications
-- **LLM credentials**: stored securely in workspace settings
-- **Content isolation**: responses based only on indexed content
+### Model Context Protocol (MCP)
 
-## Next steps
+An alternative method is using a Model Context Protocol (MCP) server. MCPs are designed for broader uses that go beyond answering questions, but can be useful in contexts where having up-to-date data is more important than comprehensive answers.
 
-- [Get started with chat completions implementation](/learn/chat/getting_started_with_chat)
-- [Explore the chat completions API reference](/reference/api/chats)
+Follow the [dedicated MCP guide](/guides/ai/mcp) if you want to implement it in your application.