类 StateGraph<SD, S, U, N, I, O, C>

一个图，其节点通过读写共享状态进行通信。每个节点都将定义的 State 作为输入并返回一个 Partial<State>。

每个状态键都可以选择性地使用一个 reducer 函数进行注解，该函数将用于聚合从多个节点接收到的该键的值。reducer 函数的签名为 (left: Value, right: UpdateValue) => Value。

有关定义状态的更多信息，请参阅 Annotation。

向图中添加节点和边后，必须先调用 .compile() 才能使用它。

示例

import {
  type BaseMessage,
  AIMessage,
  HumanMessage,
} from "@langchain/core/messages";
import { StateGraph, Annotation } from "@langchain/langgraph";

// Define a state with a single key named "messages" that will
// combine a returned BaseMessage or arrays of BaseMessages
const StateAnnotation = Annotation.Root({
  sentiment: Annotation<string>,
  messages: Annotation<BaseMessage[]>({
    reducer: (left: BaseMessage[], right: BaseMessage | BaseMessage[]) => {
      if (Array.isArray(right)) {
        return left.concat(right);
      }
      return left.concat([right]);
    },
    default: () => [],
  }),
});

const graphBuilder = new StateGraph(StateAnnotation);

// A node in the graph that returns an object with a "messages" key
// will update the state by combining the existing value with the returned one.
const myNode = (state: typeof StateAnnotation.State) => {
  return {
    messages: [new AIMessage("Some new response")],
    sentiment: "positive",
  };
};

const graph = graphBuilder
  .addNode("myNode", myNode)
  .addEdge("__start__", "myNode")
  .addEdge("myNode", "__end__")
  .compile();

await graph.invoke({ messages: [new HumanMessage("how are you?")] });

// {
//   messages: [HumanMessage("how are you?"), AIMessage("Some new response")],
//   sentiment: "positive",
// }

类型参数

继承关系 (查看完整)

  • Graph<N, S, U, StateGraphNodeSpec<S, U>, ToStateDefinition<C>>
    • StateGraph

构造函数

构造函数

属性

分支 通道 已编译 边 入口点? 节点 等待中的边

访问器

所有边

方法

_添加Schema 添加条件边 添加边 添加节点 添加序列 编译 设置入口点 设置结束点 验证 如果已编译则警告

构造函数

构造函数

属性

分支

branches: Record<string, Record<string, Branch<S, N, any>>>

通道

channels: Record<string, BaseChannel<unknown, unknown, unknown> | ManagedValueSpec>

已编译

compiled: boolean

边

edges: Set<["__start__" | N, "__end__" | N]>

可选 入口点?

entryPoint?: string

节点

nodes: Record<N, StateGraphNodeSpec<S, U>>

等待中的边

waitingEdges: Set<[N[], N]>

访问器

所有边

  • get allEdges(): Set<[string, string]>

  • 返回 Set<[string, string]>

方法

_添加Schema

  • _addSchema(stateDefinition): void

  • 参数

    • stateDefinition: SDZod

    返回 void

添加条件边

添加边

  • addEdge(startKey, endKey): this

  • 参数

    • startKey: "__start__" | N | N[]
    • endKey: "__end__" | N

    返回 this

添加节点

添加序列

  • addSequence<K>(nodes): StateGraph<SD, S, U, N | K, I, O, C>

  • 类型参数

    • K extends string

    参数

    • nodes: [key: K, action: NodeAction<S, U, C>, options?: StateGraphAddNodeOptions<string>][]

    返回 StateGraph<SD, S, U, N | K, I, O, C>

  • addSequence<K>(nodes): StateGraph<SD, S, U, N | K, I, O, C>

  • 类型参数

    • K extends string

    参数

    • nodes: Record<K, NodeAction<S, U, C>>

    返回 StateGraph<SD, S, U, N | K, I, O, C>

编译

设置入口点

  • setEntryPoint(key): this

  • 参数

    • key: N

    返回 this

    已弃用

    请改用 addEdge(START, key)

设置结束点

  • setFinishPoint(key): this

  • 参数

    • key: N

    返回 this

    已弃用

    请改用 addEdge(key, END)

验证

  • validate(interrupt?): void

  • 参数

    • 可选 interrupt: string[]

    返回 void

受保护的 如果已编译则警告

  • warnIfCompiled(message): void

  • 参数

    • message: string

    返回 void

设置

成员可见性

主题

本页内容

构造函数分支通道已编译边入口点节点等待中的边所有边_添加Schema添加条件边添加边添加节点添加序列编译设置入口点设置结束点验证如果已编译则警告