Skip to content

docs: document RAG file context scope#1304

Open
Eole7 wants to merge 1 commit into
open-webui:mainfrom
Eole7:rag-file-context-scope-docs
Open

docs: document RAG file context scope#1304
Eole7 wants to merge 1 commit into
open-webui:mainfrom
Eole7:rag-file-context-scope-docs

Conversation

@Eole7

@Eole7 Eole7 commented Jun 20, 2026

Copy link
Copy Markdown

Copilot AI review requested due to automatic review settings June 20, 2026 09:37

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation for the new RAG “File Context Scope” behavior so admins and plugin authors understand where attached-file context is injected (conversation-level vs message-level), and how it interacts with RAG_SYSTEM_CONTEXT.

Changes:

  • Documented the new RAG_FILE_CONTEXT_SCOPE environment variable and clarified interaction with RAG_SYSTEM_CONTEXT.
  • Added user-facing docs describing the “File Context Scope” admin setting and when to use each mode.
  • Updated plugin filter docs to reflect the new injection options for attached-file context.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
docs/troubleshooting/rag.mdx Adds a troubleshooting note pointing readers to File Context Scope / RAG_FILE_CONTEXT_SCOPE.
docs/reference/env-configuration.mdx Documents RAG_FILE_CONTEXT_SCOPE and updates RAG_SYSTEM_CONTEXT description to reference it.
docs/features/extensibility/plugin/functions/filter.mdx Updates the built-in RAG pipeline description to mention message-scoped file context.
docs/features/chat-conversations/rag/index.md Adds a new “File Context Scope” section explaining both modes and precedence with RAG_SYSTEM_CONTEXT.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/troubleshooting/rag.mdx
Comment thread docs/reference/env-configuration.mdx
Comment thread docs/features/extensibility/plugin/functions/filter.mdx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants