Skip to content

docs: add Needlepath context selection guardrail page - #858

Draft
kirankashalkar wants to merge 1 commit into
BerriAI:mainfrom
kirankashalkar:docs/needlepath-guardrail
Draft

docs: add Needlepath context selection guardrail page#858
kirankashalkar wants to merge 1 commit into
BerriAI:mainfrom
kirankashalkar:docs/needlepath-guardrail

Conversation

@kirankashalkar

Copy link
Copy Markdown

Draft, paired with BerriAI/litellm#36504. We are keeping both in draft pending our own upstream validation, and will mark them ready for review shortly.

Adds the documentation page for the needlepath guardrail introduced in BerriAI/litellm#36504, plus its sidebars.js entry.

The page covers:

  • what selection does: query-conditioned extractive selection of the spans that carry the answer, with nothing paraphrased or rewritten
  • how the query is derived per message, from the tool call's intent or the last user message
  • the full config surface, top-level and nested optional_params, with defaults
  • the fail-open behaviour, stated as a feature: every decline path and what the client gets in each case
  • what is not covered today, including /v1/responses and mixed text and non-text content parts

No performance, accuracy, or compression-ratio numbers are claimed anywhere on the page. It is deliberately mechanism-only and limited to behaviour that is observable on the wire.

Files:

  • docs/proxy/guardrails/needlepath.md (new)
  • sidebars.js (one line, alphabetical position in the guardrails list)

Documents the `needlepath` guardrail: what selection does, the config
surface, and the fail-open behaviour, plus the sidebar entry.
@vercel

vercel Bot commented Aug 11, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview Aug 11, 2026 3:16am

Request Review

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