Struct GraphBuilder 

pub struct GraphBuilder<S: WorkflowState = State, M: MergeStrategy<S> = StateMerge> { /* private fields */ }

Graph 构建器。

Implementations

impl<S: WorkflowState, M: MergeStrategy<S>> GraphBuilder<S, M>

pub fn new(name: impl Into<String>) -> Self

创建 GraphBuilder。

类型参数由调用方推断或显式指定。

• 默认: GraphBuilder::new("name") → GraphBuilder<State, StateMerge>
• 自定义: GraphBuilder::<AgentState, _>::new("name")

pub fn canonical_hash(&mut self, hash: u64) -> &mut Self

P0-2: 设置 canonical hash — 由 DSL 层（如 AgentBuilder）调用。

如果不设置，build() 会自动计算一个基于图结构的 hash。

pub fn start(&mut self, node: impl Into<String>) -> &mut Self

pub fn end(&mut self, node: impl Into<String>) -> &mut Self

pub fn node( &mut self, name: impl Into<String>, kind: NodeKind<S, M>, ) -> &mut Self

pub fn subgraph<Inner, IM, L>( &mut self, name: impl Into<String>, spec: SubgraphSpec<S, Inner, IM, L>, ) -> &mut Self

where S: 'static, Inner: 'static + WorkflowState, IM: 'static + MergeStrategy<Inner>, L: 'static + StateLens<S, Inner>,

便捷方法 — 添加 Subgraph 节点。

自动将 SubgraphSpec 编译为 CompiledSubgraph 并注册为节点。

示例

use lellm_graph::{GraphBuilder, SubgraphSpec, StateLens};

let agent_graph = AgentBuilder::new(model).tools([...]).build();
let spec = SubgraphSpec::new(agent_graph, AgentLens);

let mut builder = GraphBuilder::<WorkflowState, _>::new("workflow");
builder.subgraph("agent", spec);  // 语法糖
// 等价于:
// builder.node("agent", NodeKind::Subgraph(spec.compile()));

pub fn edge( &mut self, from: impl Into<String>, to: impl Into<String>, ) -> PendingEdge<'_, S, M>

pub fn edge_if( &mut self, from: impl Into<String>, to: impl Into<String>, condition: impl Fn(&S) -> bool + Send + Sync + 'static, ) -> PendingEdge<'_, S, M>

pub fn edge_fallback( &mut self, from: impl Into<String>, to: impl Into<String>, ) -> PendingEdge<'_, S, M>

pub fn build(self) -> Result<Graph<S, M>, BuildErrors>

pub fn name(&self) -> &str

pub fn compile(self) -> Result<Graph<S, M>, BuildErrors>

构建并编译 — 在 build() 之后运行 Compiler Pass（如 InlinePass）。

与 build() 的区别：

• build() — 仅验证 AST，返回原始 Graph
• compile() — 验证 + 运行优化 pass，返回优化后的 Graph

示例

let graph = builder.compile()?;  // 自动运行 InlinePass