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

了解助手配置

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

创建助手

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

使用助手

要使用助手,请在创建运行时传递其 assistant_id。以下示例使用了上面创建的助手:
响应:随着图使用助手的配置执行,流会返回相应事件:
使用图 ID 与助手 ID运行图时可以传递图 ID或助手 ID:

为助手创建新版本

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

使用助手的旧版本

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