Verified Workflows as a LangChain tool
Use Verified Workflows as a tool in LangChain agents and chains. Python package with a client class and ready-made tool wrappers for agents.
Your agentLangChain / LangGraph
VW tool callsubmit_review
Certified reviewerhuman review
Tool resultstructured verdict
Agent continuesnext action
Install
Install the integration and add it to your Langchain workspace.
terminal
pip install verifiedworkflows-langchain
pyproject.toml
[project]
dependencies = [
"verifiedworkflows>=1.0",
"verifiedworkflows-langchain>=0.3",
"langchain>=0.2"
]
Submit a task
Instantiate the client, pass it to a tool factory, and hand the resulting tool list to any agent. The tool returns a structured verdict your chain can branch on.
review.py
from verifiedworkflows import VerifiedWorkflows
client = VerifiedWorkflows(api_key="vw_live_xxx")
task = client.tasks.create(
content="Body of the generated support reply",
content_type="text",
callback_url="https://your-app.example.com/webhook/vw",
)
print(task["id"]) # tsk_live_f8a29
review.js
import { VerifiedWorkflows } from "verifiedworkflows";
const client = new VerifiedWorkflows({ apiKey: "vw_live_xxx" });
const task = await client.tasks.create({
content: "Body of the generated support reply",
contentType: "text",
callbackUrl: "https://your-app.example.com/webhook/vw",
});
console.log(task.id); // tsk_live_f8a29
submit_task.sh
# Submit any AI output for human review
curl -X POST https://api.verifiedworkflows.com/v1/tasks \
-H "Authorization: Bearer vw_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"content": "Body of the generated support reply",
"content_type": "text",
"callback_url": "https://your-app.example.com/webhook/vw"
}'
Operations
- submit_review tool — queue content for human review; agent receives a structured verdict.
- get_review_status tool — poll a previously submitted task; useful for long-running chains.
- wait_for_review tool — block the chain until the review completes (synchronous mode).
- review_history tool — retrieve a paginated list of past tasks for memory or analytics.
Setup
Install the package and set the VW_API_KEY environment variable. The client picks it up automatically.
Async flows
For long-running agents, submit a task with a callback_url and let your chain continue. React to the webhook in a separate LangServe endpoint when the result lands.
Does it work with LangGraph?
Yes. The tools are plain BaseTool instances and integrate with any LangChain-compatible agent framework.
What does the tool return?
A Pydantic model with status, reviewer verdict, and reviewer notes. Branch on it inside your chain.
Is it compatible with the v1 agent API?
Yes. Both the legacy AgentExecutor and the new langgraph prebuilt agents are supported.