跳到内容

工具 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

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

创建用于本地或远程执行的反射执行器。

参数

  • namespace (str | tuple[str, ...] | None, 默认值: None ) –

    用于识别反射域的字符串(例如 "user:123")。

  • reflector (Runnable | str) –

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

  • url (Optional[str], 默认值: None ) –

    用于远程处理的可选 URL。

  • client (Optional[LangGraphClient], 默认值: None ) –

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

  • sync_client (Optional[SyncLangGraphClient], 默认值: None ) –

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

  • store (Optional[BaseStore], 默认值: None ) –

    本地处理所需的存储。

返回

  • Executor

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

评论