Skip to main content
Last updated on
Tags:
Options
Open in ChatGPTAsk ChatGPT about this pageOpen in ClaudeAsk Claude about this page

Wrap an Existing Graph

Use this guide when you already have a compiled LangGraph graph and want to add OpenBox governance, monitoring, and compliance evidence.

Prerequisites​

  • an existing compiled LangGraph graph
  • Python 3.11+
  • an OpenBox API key, agent DID, and private key unless Require signing is disabled for the agent

Step 1: Install The SDK​

uv add openbox-langgraph-sdk-python

# Or with pip
pip install openbox-langgraph-sdk-python

Step 2: Configure Environment​

.env
OPENBOX_URL=https://core.openbox.ai
OPENBOX_API_KEY=obx_live_your_api_key_here

# Required by default for newly created agents unless Require signing is disabled.
OPENBOX_AGENT_DID=did:aip:550e8400-e29b-41d4-a716-446655440000
OPENBOX_AGENT_PRIVATE_KEY=base64_raw_ed25519_seed

Keep the DID private key in your secret manager or runtime environment. Do not commit it or reuse it across agents. If Require signing is disabled for the agent, omit both DID values.

Step 3: Wrap The Compiled Graph​

agent.py
import os
from langgraph.graph import END, START, MessagesState, StateGraph
from openbox_langgraph import create_openbox_graph_handler

graph = StateGraph(MessagesState)
graph.add_node("agent", call_model)
graph.add_node("tools", tool_node)
graph.add_edge(START, "agent")
graph.add_conditional_edges("agent", should_continue, {"tools": "tools", END: END})
graph.add_edge("tools", "agent")

app = graph.compile()

governed = create_openbox_graph_handler(
    graph=app,
    api_url=os.getenv("OPENBOX_URL"),
    api_key=os.getenv("OPENBOX_API_KEY"),
    agent_did=os.getenv("OPENBOX_AGENT_DID"),
    agent_private_key=os.getenv("OPENBOX_AGENT_PRIVATE_KEY"),
    agent_name="MyAgent",
)

result = await governed.ainvoke({"messages": [("user", "Hello")]})

Step 4: Run A Live Request​

Start your service normally and invoke the governed handler. After the run completes:

  1. Open the OpenBox Dashboard
  2. Navigate to Agents
  3. Open the registered agent
  4. Confirm the new run appears with graph, tool, LLM, and telemetry events

Step 5: Add Optional Context​

If tool calls represent other agents, configure resolve_subagent_name so OpenBox can show agent-to-agent activity:

from openbox_langgraph.types import LangGraphStreamEvent

def resolve_subagent_name(event: LangGraphStreamEvent) -> str | None:
    if event.name == "invoke_research_agent":
        return "ResearchAgent"
    return None

governed = create_openbox_graph_handler(
    graph=app,
    api_url=os.getenv("OPENBOX_URL"),
    api_key=os.getenv("OPENBOX_API_KEY"),
    agent_did=os.getenv("OPENBOX_AGENT_DID"),
    agent_private_key=os.getenv("OPENBOX_AGENT_PRIVATE_KEY"),
    resolve_subagent_name=resolve_subagent_name,
)

Next Steps​