跳到内容

工具 API 参考

  • NamespaceTemplate

    用于根据配置为命名空间字符串提供模板的工具。

NamespaceTemplate

用于根据配置为命名空间字符串提供模板的工具。

接收一个命名空间模板,该模板中可选变量用花括号括起来,并从 RunnableConfig 的 'configurable' 字段中替换值。

示例

基本的固定命名空间。

ns = NamespaceTemplate("user_123")
ns()  # Returns: ('user_123',)

可变命名空间。这将从 RunnableConfig 中的 'configurable' 字段替换值。

ns = NamespaceTemplate(("org", "{user_id}"))
ns({"configurable": {"user_id": "alice"}})
# Returns: ('org', 'alice')

如果在 "Runnable" 上下文中调用(例如,在 langgraph 实例中),'configurable' 字段将自动从上下文中检索。

from langgraph.func import entrypoint

ns = NamespaceTemplate(("org", "{user_id}"))


@entrypoint()
def my_agent(messages):
    print(ns({"configurable": {"user_id": "alice"}}))


my_agent.invoke([])
# Returns: ('org', 'alice')

函数

  • ReflectionExecutor

    创建一个用于本地或远程执行的 reflection 执行器。

ReflectionExecutor

ReflectionExecutor(
    reflector: Runnable | str,
    namespace: str | tuple[str, ...] | None = None,
    /,
    *,
    url: Optional[str] = None,
    client: Optional[LangGraphClient] = None,
    sync_client: Optional[SyncLangGraphClient] = None,
    store: Optional[BaseStore] = None,
) -> Executor

创建一个用于本地或远程执行的 reflection 执行器。

参数

  • namespace (str | tuple[str, ...] | None, default: None ) –

    用于标识 reflection 域的字符串(例如 "user:123")。

  • reflector (Runnable | str) –

    实现 reflection 逻辑的可调用对象,或命名远程图的字符串。

  • url (Optional[str], default: None ) –

    用于远程处理的可选 URL。

  • client (Optional[LangGraphClient], default: None ) –

    用于远程处理的可选 LangGraph 客户端。

  • sync_client (Optional[SyncLangGraphClient], default: None ) –

    用于远程处理的可选同步 LangGraph 客户端。

  • store (Optional[BaseStore], default: None ) –

    本地处理所需的存储。

返回

  • Executor

    根据 reflector 类型,返回 LocalReflectionExecutor 或 RemoteReflectionExecutor。

评论