了解助手配置
助手会存储用于在运行时自定义图行为的_上下文_值。您可以在图代码中定义上下文架构,然后在通过context 参数创建助手时提供具体的上下文值。
请考虑以下示例:call_model 节点从上下文中读取 model_name:
- SDK
- UI
创建助手
使用assistants.create 方法创建新的助手。此方法需要:- 图 ID:此助手将使用的已部署图的名称(例如
"agent")。 - 上下文:与图上下文架构匹配的配置值。
- 名称:用于描述助手的名称。
model_name 设置为 openai:assistant_id:用于唯一标识此助手的 UUIDgraph_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 方法创建助手的新版本。例如,为助手添加系统提示词:使用助手的旧版本
使用setLatest 方法更改活动版本:Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

