跳到内容

实用工具 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')

如果在“可运行”上下文(例如,在 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 (可选的[str], 默认: None ) –

    用于远程处理的可选 URL。

  • client (可选的[LangGraphClient], 默认: None ) –

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

  • sync_client (可选的[SyncLangGraphClient], 默认: None ) –

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

  • store (可选的[BaseStore], 默认: None ) –

    本地处理所需的存储区。

返回

  • Executor

    根据反射器类型,可以是 LocalReflectionExecutor 或 RemoteReflectionExecutor。

评论