Skip to content

docs: add Vaultak runtime security integration for Haystack#487

Closed
samueloladji-beep wants to merge 1 commit into
deepset-ai:mainfrom
samueloladji-beep:add-vaultak-integration
Closed

docs: add Vaultak runtime security integration for Haystack#487
samueloladji-beep wants to merge 1 commit into
deepset-ai:mainfrom
samueloladji-beep:add-vaultak-integration

Conversation

@samueloladji-beep
Copy link
Copy Markdown

Summary

Adds a new integration page for Vaultak — a runtime security platform that wraps Haystack pipelines with real-time input screening and PII masking via two custom @component classes.

Install: pip install haystack-vaultak

Changes

integrations/vaultak.md (new) — covers:

  • VaultakSecurityChecker: a @component inserted before the retriever/LLM that risk-scores every query (0–10) via the Vaultak SDK and raises RuntimeError to halt the pipeline if the score exceeds the configured threshold; also runs a policy check on the input
  • VaultakPIIMasker: a @component inserted after the LLM generator that scans all replies for PII (names, emails, phone numbers, etc.) and masks them before they reach users
  • Full RAG pipeline example wiring both components around InMemoryBM25RetrieverPromptBuilderOpenAIGenerator

Test plan

  • Page renders correctly on the Haystack integrations site
  • Code examples are syntactically correct Python
  • Component interfaces match Haystack 2.0 @component contract (output_types, run method)

🤖 Generated with Claude Code

Adds integrations/vaultak.md with two Haystack @component classes:
- VaultakSecurityChecker: inserted before the retriever/LLM to
  risk-score queries (0–10) and check policy; raises RuntimeError
  to halt the pipeline if the score exceeds the threshold
- VaultakPIIMasker: inserted after the LLM generator to scan and
  redact PII from replies before they reach users

Includes a full RAG pipeline example wiring both components around
InMemoryBM25Retriever + PromptBuilder + OpenAIGenerator.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@samueloladji-beep samueloladji-beep requested a review from a team as a code owner May 29, 2026 08:39
@samueloladji-beep
Copy link
Copy Markdown
Author

@TuanaCelik @bilgeyucel @anakin87 — ready for review. This adds a Vaultak runtime security integration page with VaultakSecurityChecker and VaultakPIIMasker pipeline components.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

  • Adds a new Haystack integrations documentation page for Vaultak, describing two @component classes for runtime query screening and PII masking, plus a full RAG pipeline example.

Changes:

  • Introduces integrations/vaultak.md with installation + usage docs for VaultakSecurityChecker and VaultakPIIMasker.
  • Includes code examples for both components and a full pipeline wiring example.
  • Adds a License section and includes it in the page ToC.

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

Comment thread integrations/vaultak.md

| Component | Position in pipeline | What it does |
|---|---|---|
| `VaultakSecurityChecker` | Before the LLM / retriever | Risk-scores the input; raises `BlockedByVaultak` if above threshold; checks against policy rules |
Comment thread integrations/vaultak.md

Insert `VaultakSecurityChecker` before your retriever or LLM to intercept and score every user
query before it enters your pipeline. Queries whose risk score exceeds your threshold raise a
`BlockedByVaultak` exception so the pipeline halts cleanly.
Comment thread integrations/vaultak.md
Comment on lines +137 to +138
os.environ["OPENAI_API_KEY"] = "sk-..."
VAULTAK_API_KEY = "vtk_..."
Copy link
Copy Markdown
Member

@kacperlukawski kacperlukawski left a comment

Choose a reason for hiding this comment

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

All the links in the frontmatter do not exist. I'm closing the PR, as the integration does seem to be hallucinated. @samueloladji-beep, feel free to open another one once it's all fixed.

Comment thread integrations/vaultak.md
github: vaultak
twitter: vaultak_ai
linkedin: https://www.linkedin.com/company/vaultak/
pypi: https://pypi.org/project/haystack-vaultak/
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Project does not exist

Comment thread integrations/vaultak.md
twitter: vaultak_ai
linkedin: https://www.linkedin.com/company/vaultak/
pypi: https://pypi.org/project/haystack-vaultak/
repo: https://github.com/vaultak/haystack-vaultak
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Repository does not exist

Comment thread integrations/vaultak.md
repo: https://github.com/vaultak/haystack-vaultak
type: Monitoring Tool
report_issue: https://github.com/vaultak/haystack-vaultak/issues
logo: /logos/vaultak.png
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

File does not exist

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.

3 participants