Skip to content

🧠 docs: Explain How LibreChat Uses the RAG API - #889

Merged
berry-13 merged 1 commit into
mainfrom
docs/rag-api-feature-page-feedback
Oct 28, 2026
Merged

berry-13 merged 1 commit into
mainfrom
docs/rag-api-feature-page-feedback

Conversation

@berry-13

Copy link
Copy Markdown
Collaborator

Summary

The RAG API feature page spent most of its length on generic RAG marketing (benefits, research challenges, a conclusion that repeated the intro), had a first-person aside, and ended by pointing to "the official RAG API documentation" without a link. This replaces those sections with a short "How it works" covering what LibreChat actually does with the RAG API, keeps a brief concept explanation plus the IBM video (the configuration page links here for it), and links the rag-api repository.

The new facts were checked against LibreChat dev: packages/api/src/files/rag/search.ts (k=5 per file, 10 closest overall, citation anchors), api/server/services/Files/VectorDB/crud.js (/embed), and packages/api/src/files/rag.ts (vector deletion on file delete). The lazy indexing wording matches the Upload as Text page.

Feedback addressed

  • 1564667684472233985: /docs/features/rag_api
    • Reader called the page AI-written filler. Confirmed: generic sections with no LibreChat-specific information, a first-person aside, and an unlinked reference.
    • Rewrote the page body around verified LibreChat behavior and linked the rag-api repository.
    • Classification: FIXED

Validation

  • MDX body compiled with the repo's @mdx-js/mdx 3.1.1 for both the old and new page: both ok
  • npx fumadocs-mdx: generated without errors; frontmatter parsed with js-yaml
  • Internal link targets checked to exist, including the #filecitations and #what-happens-under-the-hood anchors
  • npx eslint content/docs/features/rag_api.mdx: file is ignored by the ESLint config (no JS/TS changed)
  • Not run: full pnpm build and Playwright, since only one MDX page's prose changed

Not changed

  • 1564504101033873449 (/docs, "Not good"): no identifiable problem, non-actionable
  • 1564891098038403124 (/es/docs): a list of names, no report, non-actionable
  • 1564892590002806825 (/docs/features): positive rating with no message, non-actionable
  • 1565061743040790660 (/pt-BR/docs): Portuguese greeting, non-actionable
  • Translated copies of the page are left to the translation workflow.

Replace the generic benefits, challenges and conclusion sections of the
RAG API feature page with how indexing, retrieval and answering actually
work in LibreChat (k=5 per file, top 10 overall, citations, vector
deletion), verified against LibreChat dev. Drop the first-person aside
and replace the unlinked "official RAG API documentation" pointer with a
link to the rag-api repository.

Feedback: 1564667684472233985
@berry-13 berry-13 added the documentation Improvements or additions to documentation label Oct 28, 2026
@vercel

vercel Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
librechat-ai Ready Ready Preview Oct 28, 2026 7:14pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-28T19:05:39.078016Z 33eef78 PR opened
🔒 Security Review ✅ Completed 2026-10-28T19:06:09.404058Z 33eef78 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@berry-13
berry-13 merged commit b464d4e into main Oct 28, 2026
5 checks passed
@berry-13
berry-13 deleted the docs/rag-api-feature-page-feedback branch October 28, 2026 22:31

This branch was successfully deployed

1 active deployment
Preview — 33eef789 Deployed Oct 28, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant