运行 是对一个助手的调用。当你执行一个运行时,你需要指定使用哪个助手——可以通过图 ID 指定默认助手,或者通过助手 ID 指定特定配置。 此图展示了运行如何将助手与线程结合起来以执行图:
  • 图(浅蓝色):包含你智能体逻辑的已部署代码。
  • 助手(蓝色):配置选项(模型、提示、工具)。
  • 线程(橙色):用于保存对话历史的状态容器。
  • 运行(绿色):将助手与线程配对的执行实例。
组合示例:
  • 运行:A1 + T1:助手 1 的配置应用于用户 A 的对话。
  • 运行:A1 + T2:相同的助手服务于用户 B(不同的对话)。
  • 运行:A2 + T1:不同的助手应用于用户 A 的对话(配置切换)。
执行一个运行时:
  • 每个运行可以有自己的输入、配置覆盖和元数据。
  • 运行可以是无状态的(没有线程)或有状态的(在线程上执行以实现对话持久化)。
  • 多个运行可以使用相同的助手配置。
  • 助手的配置会影响底层图的执行方式。
Agent Server API 提供了多个用于创建和管理运行的端点。更多详情,请参阅 API 参考。

本节内容

启动后台运行

异步运行你的智能体并轮询结果。

在同一线程上运行多个智能体

在共享的线程上使用多个助手,以组合智能体能力。

无状态运行

当不需要对话历史时,执行不持久化状态的运行。

取消运行

通过 API 取消单个或多个运行。