Skip to main content
本页介绍如何创建、配置和管理助手。助手允许您通过配置(例如模型选择、提示词和工具可用性)来定制已部署图的行为,而无需更改底层图代码。 您可以使用 SDK 或在 LangSmith UI 中进行操作。

理解助手配置

助手存储用于在运行时定制图行为的 上下文 值。您在图代码中定义一个上下文模式,然后在通过 context 参数创建助手时提供具体的上下文值。 考虑以下从上下文中读取 model_namecall_model 节点示例:
当您创建助手时,您为这些配置字段提供具体的值。助手存储此配置,并在图每次运行时应用它。 有关 LangGraph 中配置的更多信息,请参阅运行时上下文文档 为您的工作流选择 SDK 或 UI:

创建助手

使用 AssistantsClient.create 方法创建一个新助手。此方法需要:
  • 图 ID:此助手将使用的已部署图的名称(例如 "agent")。
  • 上下文:与您图的上下文模式匹配的配置值。
  • 名称:助手的描述性名称。
以下示例创建一个将 model_name 设置为 openai 的助手:
响应:API 返回一个助手对象,包含:
  • assistant_id:唯一标识此助手的 UUID
  • graph_id:此助手配置所针对的图
  • context:您提供的配置值
  • namemetadata、时间戳和其他字段
assistant_id(一个类似 "62e209ca-9154-432a-b9e9-2d75c7a9219b" 的 UUID)唯一标识此助手配置。当您运行图以指定要应用的配置时,将使用此 ID。
图 ID 与助手 ID创建助手时,您指定一个图 ID(图名称,如 "agent")。这将返回一个助手 ID(UUID,如 "62e209ca...")。运行图时,您可以使用任一 ID:
  • 图 ID(例如 "agent"):使用该图的默认助手
  • 助手 ID(UUID):使用特定的助手配置
有关示例,请参阅使用助手

使用助手

要使用助手,在创建运行时传递其 assistant_id。以下示例使用我们上面创建的助手:
响应:当图使用您的助手配置执行时,流返回事件:
使用图 ID 与助手 ID运行图时,您可以传递图 ID助手 ID

为助手创建新版本

使用 AssistantsClient.update 方法为助手创建新版本。
更新需要完整配置更新时必须提供完整配置。更新端点从头开始创建新版本,不会与之前的版本合并。请包含您希望保留的所有配置字段。
例如,要向助手添加系统提示词:
更新会创建一个新版本并自动将其设置为活动版本。所有未来使用此助手 ID 的运行都将使用新配置。

使用助手的先前版本

使用 setLatest 方法更改活动版本:
更改活动版本后,所有使用此助手 ID 的运行都将使用指定版本的配置。