Skip to content

docs: add Prompts feature page and linked agent instructions - #898

Closed
AtefBellaaj wants to merge 2 commits into
LibreChat-AI:mainfrom
AtefBellaaj:atef/docs-linked-instructions
Closed

AtefBellaaj wants to merge 2 commits into
LibreChat-AI:mainfrom
AtefBellaaj:atef/docs-linked-instructions

Conversation

@AtefBellaaj

@AtefBellaaj AtefBellaaj commented Oct 30, 2026 •

Copy link
Copy Markdown

Summary

Adds one Prompts feature page and links the existing prompt sections to it. It documents the prompt library and prompts as agent instructions (native and Langfuse), added in LibreChat-AI/LibreChat#17294. Claims are checked against LibreChat dev at 05e7f1d2e (the #17294 merge).

  • features/prompts.mdx (new, English only, like scheduled_chats and pull_requests). It covers:
    • the prompt library, versions and Deploy, and variables;
    • sharing and permissions;
    • prompts from Langfuse;
    • prompts as agent instructions: who can link and who can run, when instructions resolve, what happens when a link fails (empty instructions, no fallback to inline text), usage count, the Langfuse switch, a rollout callout with the v0.8.9-rc1 floor, version history, limitations, and a troubleshooting table of Builder messages.
  • features/meta*.json: lists prompts after agents in every locale, through sync-locale-meta.
  • features/agents.mdx: the saved-prompt section is cut to a short summary with a link.
  • configuration/langfuse.mdx: keeps the switch YAML and a one-line rollout warning, and links to the new page for user-facing behavior.
  • object_structure/agents.mdx linkedInstructions: states that only langfuse.enabled reaches the client and links to the new page.
content/docs/
├── features/
│   ├── prompts.mdx          (new)
│   ├── agents.mdx           (section → link)
│   └── meta*.json           (+ "prompts")
└── configuration/
    ├── langfuse.mdx         (admin facts → link)
    └── librechat_yaml/object_structure/agents.mdx

Screenshots needed

The page has these as commented-out ThemeImage placeholders (light + dark each, under public/images/features/prompts/). They do not render until the files are added and the comments are removed.

  • library: prompt library with prompt cards
  • slash-command: / menu in the chat box showing prompts
  • versions: prompt editor with versions and the Production marker
  • langfuse-group: synced read-only Langfuse group with the "Managed in Langfuse" badge
  • agent-instructions-picker: Agent Builder prompt picker with a native and a Langfuse group
  • agent-instructions-version: version picker open ("Production (Version N)" and the list)
  • agent-instructions-restricted: "Restricted prompt" state for a co-editor
  • agent-instructions-langfuse-off: saved Langfuse link with the switch-off note

Validation

pnpm build, pnpm test (466 passed), check:locale-meta, check:config-version, prettier --check. With next start, all internal links and anchors on the changed pages resolve (18/18), placeholders do not render, and the sidebar shows Prompts after Agents.

@vercel

vercel Bot commented Oct 30, 2026

Copy link
Copy Markdown

@AtefBellaaj is attempting to deploy a commit to the LibreChat's projects Team on Vercel.

A member of the Team first needs to authorize it.

@AtefBellaaj
AtefBellaaj force-pushed the atef/docs-linked-instructions branch from 5a67e31 to e5fec27 Compare October 30, 2026 17:40
@AtefBellaaj AtefBellaaj changed the title docs: add linkedInstructions Langfuse switch and Langfuse agent instructions docs: add Prompts feature page and linked agent instructions Oct 30, 2026
@AtefBellaaj

Copy link
Copy Markdown
Author

@codex review e5fec27

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 30, 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-11-01T13:19:34.376159Z 5433565 Manual request
ℹ️ 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.

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5fec273be

ℹ️ 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/docs/features/prompts.mdx Resolved
Add features/prompts covering the prompt library, versions, sharing,
Langfuse prompt groups, and prompts as agent instructions (link and run
permissions, resolution, failure, usage count, Langfuse switch, rollout,
troubleshooting). Shorten the agents, Langfuse, and linkedInstructions
config sections and link them to the new page. List the page in every
features sidebar.
@AtefBellaaj
AtefBellaaj force-pushed the atef/docs-linked-instructions branch from e5fec27 to 7c9c0ed Compare October 30, 2026 18:08
@AtefBellaaj

Copy link
Copy Markdown
Author

The analyze check failure is not from this change: the bundle build passes ("no changes to the JavaScript bundle"), then peter-evans/create-or-update-comment gets 403 because the fork PR token cannot write comments. It also fails on the previous head 5a67e313.

@AtefBellaaj

Copy link
Copy Markdown
Author

@codex review 7c9c0ed

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 7c9c0edca5

ℹ️ 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@AtefBellaaj
AtefBellaaj marked this pull request as ready for review November 1, 2026 13:15
@AtefBellaaj

Copy link
Copy Markdown
Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Chef's kiss.

Reviewed commit: 5433565ee1

ℹ️ 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@AtefBellaaj

Copy link
Copy Markdown
Author

Replaced by #905. The same commits are now on the upstream branch atef/docs-linked-instructions so CI can post its bundle report.

This branch was successfully deployed

1 active deployment
Preview — 5433565e Deployed Nov 2, 2026 by vercel[bot]
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.

1 participant