Skip to content

docs(langgraph): add Vaultak runtime security integration guide#4213

Open
Samuel Oladji (samueloladji-beep) wants to merge 4 commits into
langchain-ai:mainfrom
samueloladji-beep:add-vaultak-langgraph
Open

docs(langgraph): add Vaultak runtime security integration guide#4213
Samuel Oladji (samueloladji-beep) wants to merge 4 commits into
langchain-ai:mainfrom
samueloladji-beep:add-vaultak-langgraph

Conversation

@samueloladji-beep

Copy link
Copy Markdown

Summary

  • Adds src/oss/langgraph/vaultak.mdx — a new integration guide in the LangGraph Production section covering how to wire Vaultak runtime security into LangGraph agents and StateGraph workflows.
  • Updates src/docs.json to add oss/python/langgraph/vaultak to the Production nav group, directly after the existing Observability page.

Integration pattern

VaultakCallbackHandler extends LangChain's BaseCallbackHandler, so it plugs into LangGraph via the standard config dict with zero graph rewrites:

from langchain_vaultak import VaultakCallbackHandler

vaultak = VaultakCallbackHandler(
    api_key="vtk_...",
    agent_name="my-agent",
    block_on_high_risk=True,
    risk_threshold=7.0,
)

# Prebuilt ReAct agent — per invocation
result = agent.invoke(input, config={"callbacks": [vaultak]})

# StateGraph — at compile time (covers every run)
graph = builder.compile().with_config({"callbacks": [vaultak]})

Every tool call is risk-scored (0–10) before execution. Calls above the threshold raise an exception to halt the graph. Tool outputs are scanned for PII before they reach the next node.

Page contents

  • Install snippet (pip / uv tabs)
  • Prebuilt create_react_agent example with two realistic tools
  • Custom StateGraph workflow example with ToolNode
  • Per-invocation config pattern (varying threshold per request)
  • Configuration reference table
  • Event-coverage table (what LangGraph events Vaultak intercepts)

Test plan

  • Page renders at /oss/python/langgraph/vaultak without errors
  • Nav shows "Vaultak Runtime Security" in the Production group after Observability
  • Code blocks render correctly (pip/uv <CodeGroup>, Python snippets)
  • All internal links (back to observability, LangSmith docs) resolve

🤖 Generated with Claude Code

Adds a new page covering how to integrate Vaultak with LangGraph via
the standard LangChain callback system (VaultakCallbackHandler). Every
tool call is risk-scored before execution and PII is masked in outputs.

- src/oss/langgraph/vaultak.mdx — integration guide with:
  - prebuilt create_react_agent example
  - custom StateGraph workflow example
  - per-invocation config example
  - configuration table and event-coverage table
- src/docs.json — adds oss/python/langgraph/vaultak to the Production
  nav group after the observability page

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Thanks for opening a docs PR, Samuel Oladji (@samueloladji-beep)! When it's ready for review, please add the relevant reviewers:

  • @npentrel or @lnhsingh (LangGraph)
  • @mdrxy (Python integrations)

@github-actions github-actions Bot added langchain For docs changes to LangChain langgraph For docs changes to LangGraph oss python For content related to the Python version of LangChain projects external User is not a member of langchain-ai labels May 29, 2026
@samueloladji-beep

Copy link
Copy Markdown
Author

Naomi Pentrel (@npentrel) Lauren Hirata Singh (@lnhsingh) Mason Daugherty (@mdrxy) — ready for review. This adds a Vaultak runtime security integration guide to the LangGraph Production section.

Vale flagged 3 DashesSpaces violations at lines 11, 14, and 15.
Replace ' — ' with '—' throughout prose (code block on line 135 is exempt).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Comment thread src/oss/langgraph/vaultak.mdx Outdated
@@ -0,0 +1,197 @@
---
title: Vaultak Runtime Security

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

We do not include third-party integration guides in our main docs set. Please remove this page and move the content into the providers page

@lnhsingh Lauren Hirata Singh (lnhsingh) added the integration For docs updates for LangChain integrations label Jun 2, 2026
…feedback

Per @lnhsingh: third-party integration guides belong in the providers page,
not as standalone pages in the main docs set. Merged all LangGraph-specific
content (ReAct agent, StateGraph, config reference, monitoring table) into
the existing providers/vaultak.mdx and removed the standalone langgraph/vaultak.mdx
page and its docs.json entry.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot removed the langgraph For docs changes to LangGraph label Jun 14, 2026
@samueloladji-beep

Copy link
Copy Markdown
Author

Thanks for the review Lauren Hirata Singh (@lnhsingh) — makes sense, happy to follow the convention.

I've moved all the LangGraph content (prebuilt ReAct agent, StateGraph workflow, config reference, and monitoring events table) into the existing providers page (integrations/providers/vaultak.mdx) and removed the standalone langgraph/vaultak.mdx page and its docs.json entry. The branch is updated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external User is not a member of langchain-ai integration For docs updates for LangChain integrations langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants