From bba9d703f242bb42af40d562fb63d701d19b7181 Mon Sep 17 00:00:00 2001
From: April M <36110273+aimurphy@users.noreply.github.com>
Date: Tue, 2 Dec 2025 14:41:16 -0800
Subject: [PATCH] built-in filter

---
 docs/docs/core-components/chat.mdx              | 12 ++++++++++--
 docs/docs/core-components/knowledge-filters.mdx | 10 ++++++++++
 docs/docs/core-components/knowledge.mdx         |  2 +-
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/docs/docs/core-components/chat.mdx b/docs/docs/core-components/chat.mdx
index 728f3fb6..996dcc8d 100644
--- a/docs/docs/core-components/chat.mdx
+++ b/docs/docs/core-components/chat.mdx
@@ -11,15 +11,23 @@ import PartialTempKnowledge from '@site/docs/_partial-temp-knowledge.mdx';
 
 After you [upload documents to your knowledge base](/ingestion), you can use the OpenRAG <Icon name="MessageSquare" aria-hidden="true"/> **Chat** feature to interact with your knowledge through natural language queries.
 
+The OpenRAG **Chat** uses an LLM-powered agent to understand your queries, retrieve relevant information from your knowledge base, and generate context-aware responses.
+The agent can also fetch information from URLs and new documents that you provide during the chat session.
+To limit the knowledge available to the agent, use [filters](/knowledge-filters).
+
+The agent can call specialized Model Context Protocol (MCP) tools to extend its capabilities.
+To add or change the available tools, you must edit the [**OpenRAG OpenSearch Agent** flow](#flow).
+
 :::tip
 Try chatting, uploading documents, and modifying chat settings in the [quickstart](/quickstart).
 :::
 
 ## OpenRAG OpenSearch Agent flow {#flow}
 
-When you use the OpenRAG **Chat**, the **OpenRAG OpenSearch Agent** [flow](/agents) runs in the background to retrieve relevant information from your knowledge base and generate a response.
+When you use the OpenRAG **Chat**, the **OpenRAG OpenSearch Agent** flow runs in the background to retrieve relevant information from your knowledge base and generate a response.
 
 If you [inspect the flow in Langflow](/agents#inspect-and-modify-flows), you'll see that it is comprised of eight components that work together to ingest chat messages, retrieve relevant information from your knowledge base, and then generate responses.
+When you inspect this flow, you can edit the components to customize the agent's behavior.
 
 ![OpenRAG Open Search Agent Flow](/img/opensearch-agent-flow.png)
 
@@ -49,7 +57,7 @@ One or more specialized tools can be attached to the **Tools** port to extend th
 
    Different models can change the style and content of the agent's responses, and some models might be better suited for certain tasks than others. If the agent doesn't seem to be handling requests well, try changing the model to see how the responses change. For example, fast models might be good for simple queries, but they might not have the depth of reasoning for complex, multi-faceted queries.
 
-* [**MCP Tools** component](https://docs.langflow.org/mcp-client): Connected to the **Agent** component's **Tools** port, this component can be used to [access any Model Context Protocol (MCP) server](https://docs.langflow.org/mcp-server) and the MCP tools provided by that server. In this case, your OpenRAG Langflow instance's [**Starter Project**](https://docs.langflow.org/concepts-flows#projects) is the MCP server, and the [**OpenSearch URL Ingestion** flow](/ingestion#url-flow) is the MCP tool.
+* [**MCP Tools** component](https://docs.langflow.org/mcp-client): Connected to the **Agent** component's **Tools** port, this component can be used to [access any MCP server](https://docs.langflow.org/mcp-server) and the MCP tools provided by that server. In this case, your OpenRAG Langflow instance's [**Starter Project**](https://docs.langflow.org/concepts-flows#projects) is the MCP server, and the [**OpenSearch URL Ingestion** flow](/ingestion#url-flow) is the MCP tool.
 This flow fetches content from URLs, and then stores the content in your OpenRAG OpenSearch knowledge base. By serving this flow as an MCP tool, the agent can selectively call this tool if a URL is detected in the chat input.
 
 * [**OpenSearch** component](https://docs.langflow.org/bundles-elastic#opensearch): Connected to the **Agent** component's **Tools** port, this component lets the agent search your [OpenRAG OpenSearch knowledge base](/knowledge). The agent might not use this database for every request; the agent uses this connection only if it decides that documents in your knowledge base are relevant to your query.
diff --git a/docs/docs/core-components/knowledge-filters.mdx b/docs/docs/core-components/knowledge-filters.mdx
index 8376a55b..7821f814 100644
--- a/docs/docs/core-components/knowledge-filters.mdx
+++ b/docs/docs/core-components/knowledge-filters.mdx
@@ -14,6 +14,16 @@ Each knowledge filter captures a specific subset of documents based on given a s
 Knowledge filters can be used with different OpenRAG functionality.
 For example, knowledge filters can help agents access large knowledge bases efficiently by narrowing the scope of documents that you want the agent to use.
 
+## Built-in filters
+
+When you install OpenRAG, it automatically creates an **OpenRAG docs** filter that includes OpenRAG's default documents.
+These documents provide information about OpenRAG itself and help you learn how to use OpenRAG.
+
+When you use the OpenRAG <Icon name="MessageSquare" aria-hidden="true"/> **Chat**, [apply the **OpenRAG docs** filter](#apply-a-filter) if you want to ask questions about OpenRAG's features and functionality.
+This limits the agent's context to the default OpenRAG documentation rather than all documents in your knowledge base.
+
+After uploading your own documents, it is recommended that you create your own filters to organize your documents effectively and separate them from the default OpenRAG documents.
+
 ## Create a filter
 
 To create a knowledge filter, do the following:
diff --git a/docs/docs/core-components/knowledge.mdx b/docs/docs/core-components/knowledge.mdx
index d299aab1..3edf5a55 100644
--- a/docs/docs/core-components/knowledge.mdx
+++ b/docs/docs/core-components/knowledge.mdx
@@ -26,7 +26,7 @@ The **Knowledge** page lists the documents OpenRAG has ingested into your OpenSe
 To explore the raw contents of your knowledge base, click <Icon name="Library" aria-hidden="true"/> **Knowledge** to get a list of all ingested documents.
 Click a document to view the chunks produced from splitting the document during ingestion.
 
-OpenRAG includes some initial documents about OpenRAG. You can use these documents to ask OpenRAG about itself, and to test the [**Chat**](/chat) feature before uploading your own documents.
+By default, OpenRAG includes some initial documents about OpenRAG. You can use these documents to ask OpenRAG about itself, and to test the [**Chat**](/chat) feature before uploading your own documents.
 If you [delete these documents](#delete-knowledge), you won't be able to ask OpenRAG about itself and it's own functionality.
 It is recommended that you keep these documents, and use [filters](/knowledge-filters) to separate them from your other knowledge.