.graph accessor --> Mix StateGraph and createAgent?

OSS Product Help LangGraph
1

:backhand_index_pointing_right: createAgent() has a .graph property that returns its internal CompiledStateGraph, which means you can plug agents directly into a StateGraph workflow! No wrappers… :nerd_face:

We’ve tested this setup pretty thoroughly and it works great.
But… there’s no mention of this pattern in the docs.

Questions

  1. Are others using .graph for composition?
  2. Is this an intended API or just a happy accident?
  3. Will this be documented officially?
  4. Is there a better or “official” way to compose StateGraph + createAgent?

Thank you for any insights :hugs:

2

The official blog post confirms it!

From: LangChain and LangGraph Agent Frameworks Reach v1.0 Milestones (Oct 22, 2025):

LangChain agents are built on LangGraph, so you’re not locked in. Start with LangChain’s high-level APIs and seamlessly drop down to LangGraph when you need more control. Since graphs are composable, you can mix both approaches—using agents created with create_agent inside custom LangGraph workflows as your needs evolve.

How can you do mix them freely without the undocumented .graph?