常见问题
本页按一体化智能体运行与协同平台（AgentWorks）的使用过程整理常见问题。第一次使用时，从开始使用与能力范围开始；如果你熟悉 LangGraph、CrewAI、AgentCore、Copilot Studio、Gemini 或 A2A 等平台、框架和协议，可以直接查看兼容性与迁移。
开始使用与能力范围
能否不准备沙箱、MCP、记忆库、知识库和 Skill，直接创建智能体模板？
可以。第一个智能体只需要可用的模型凭证、模型和系统提示词。创建后再创建智能体实例，通过 Playground 验证。
AgentWorks 更适合通过控制台配置，还是通过代码定义？
AgentWorks 的智能体构建路径以控制台配置为主：创建智能体模板，选择模型凭证和模型，填写系统提示词并按需添加能力，再创建智能体实例。Invoke API 用于调用已有智能体实例，不用于上传编排代码或定义智能体运行图。
已有业务系统或编排程序可以继续在 AgentWorks 外部运行，并通过 Invoke API 调用智能体实例，或者通过 MCP 和用户工具包向智能体提供工具。参见创建第一个智能体并完成基础验证和通过 API 调用智能体。
能否不创建智能体模板，直接创建第一个智能体实例？
不能。每个智能体实例都必须引用一个已经存在的智能体模板。实例创建页面只允许选择已有模板，不会自动创建模板。
这不表示必须提前准备能力模板。模型凭证、模型和系统提示词足以创建第一个智能体模板；随后即可用它创建智能体实例。模板绑定渠道中的 /init 也只自动创建实例，渠道账号仍需预先绑定智能体模板。
智能体模板和智能体实例分别用于什么？
智能体模板保存可复用设计；智能体实例是实际运行并被 Playground、API 或渠道使用的对象。一个设计可以用于开发、预发布、生产或不同渠道用户的多个实例。
如果你熟悉其他平台中的 agent blueprint、configuration 或 deployment/runtime，可以把智能体模板理解为可复用设计，把智能体实例理解为实际运行对象；它们并不等同于一次会话或一个线程。参见智能体、插件和实例的关系。
创建实例与接入
什么时候直接创建一个智能体实例？
需要一个供控制台测试、API 调用或渠道绑定的持续运行实例时，直接创建智能体实例。例如，生产客服机器人或后端服务集成可以各使用一个实例。
如果每个渠道用户需要专属智能体实例，可以使用模板绑定和 /init 动态创建。
平台支持批量创建智能体实例吗？
控制台一次只能手动创建一个智能体实例；使用模板绑定的渠道用户还可以在首次发送 /init 时动态创建专属实例。
渠道应该绑定已有实例，还是按用户创建实例？
根据需要分别管理的是对话历史，还是智能体实例及其资源来选择：
按照需要管理的范围选择绑定方式：
- 用户使用相同配置和能力，只需分开对话：绑定已有智能体实例，并使用不同渠道会话。
- 需要分别管理实例参数、沙箱或生命周期：绑定智能体模板，让用户发送
/init按需创建实例；需要分别保存记忆时，还必须为各实例准备独立记忆库。
企业 FAQ、制度问答和公共服务台通常可以共享一个智能体实例。个人工作助手、客户专属助手、培训教练或研发运维助手更适合按用户开通。
按用户开通会创建不同的智能体实例，但不会自动拆分记忆、数据或权限。如果多个实例连接同一个记忆库、MCP 凭证或业务系统账号，这些资源仍然共享。参见选择共享服务或按用户开通和构建按用户开通的飞书助手。
修改智能体模板后，智能体实例会自动更新吗？
不会。列表会提示 智能体模板更新，实例需手动更新。看到提示后，编辑并保存实例，再通过 Playground 或 Invoke API 验证回复、工具调用和 Trace。
session_id 会保留什么？创建新会话会清空记忆库吗？
session_id 用于继续同一个智能体实例中的多轮 API 会话。同一个会话同时只能有一个活动调用任务。省略原来的 session_id 会开始新会话，但不会创建或清空记忆库。需要在后续会话中检索信息时，使用记忆库。
一个智能体实例服务多个最终用户时，先使用两个测试用户验证记忆的写入和检索范围。参见继续已有会话和使用和管理记忆库。
会话何时创建，什么时候算结束？
通过 API 首次发送 prompt 且不提供 session_id 时，平台创建会话并在响应中返回 ID。复用该 ID 会继续同一段对话；省略它会开始新会话。调用任务完成或失败只结束这一次执行，不会结束会话。Invoke API 不提供单独的会话结束或删除操作，调用方不再复用该 ID 即可结束自己的对话流程。
通过渠道使用时，渠道会话与 API session_id 分开管理。在支持会话指令的渠道中，私聊用户通常从默认会话开始，也可以使用 /session new、/session list、/session use 和 /session clear 管理对话。参见管理 API 会话、调用任务和中断和管理渠道会话。
API 会话会自动过期或删除吗？
Invoke API 不提供可配置的会话过期时间，也不提供会话删除操作。业务应用应根据用户、主题、业务任务、权限范围以及自己的最大时长或轮数规则，主动决定何时停止复用 session_id 并开始新会话。不要依赖空闲等待来获得新的对话上下文。
停止复用 session_id 不表示会话历史已经删除。组织要求按期限清理历史时，上线前与平台管理员确认目标环境的数据保留和清理流程。长会话仍需参考早期信息时，可以启用上下文压缩，但压缩同样不是过期或删除功能。参见规划会话边界、上下文和数据保留。
completed、not_found 或重置调用任务会删除会话吗？
不会。completed 和 error 表示当前调用任务已经结束；not_found 表示该任务状态已经无法查询；重置针对当前任务和待处理中断。这些结果或操作都不能作为会话历史已删除的依据。需要继续对话时仍可使用原 session_id，需要新的对话上下文时则省略它。在支持会话指令的渠道中，清空当前会话历史使用 /session clear。
可以由业务事件自动调用智能体吗？
可以由外部业务系统在事件发生时调用已有智能体实例的 Invoke API，或者通过 WebSocket 接入发送消息。飞书和 QQ 渠道则由用户消息触发。
控制台不提供通用事件触发器或流程画布。需要监听业务系统、邮件、工单或其他应用事件时，由相应系统完成事件订阅、身份校验和重试，再调用智能体实例。参见选择智能体的使用方式。
扩展智能体能力
插件和沙箱、MCP、记忆库等资源是什么关系？
请先在沙箱、MCP、记忆库、知识库组或技能组管理页面创建能力资源，再在智能体模板的 插件配置 中选择所需资源。创建或更新智能体实例后，智能体才能在运行中使用相应能力。
对于提供模板和实例选项的插件：
- 选择模板，表示创建智能体实例时按照模板准备或绑定所需资源。
- 选择实例，表示直接连接一个已经存在的资源。
保存智能体模板后，可以在智能体模板详情页的 插件 页签中核对关联。随后仍需创建或更新智能体实例，并通过测试和 Trace 确认能力实际生效。
Skill、平台工具包、用户工具包和 MCP 有什么区别？
- Skill：包含
SKILL.md和相关文件的版本化内容包，为智能体提供任务说明、方法和资源；它本身不等于一个托管工具服务。 - 平台工具包：AgentWorks 已经提供工具及其执行能力，用户从控制台可见列表中选择。
- 用户工具包：用户在智能体模板中定义工具名称和输入输出结构；通过 Invoke API 或 WebSocket 接入的业务系统接收中断、执行工具并返回结果。
- MCP：工具由 AgentWorks 外部的 MCP Server 提供，平台通过 Streamable HTTP 发现并调用。
参见管理 Skill 内容和版本、使用平台工具包、定义用户工具包和配置 MCP 模板和实例。
为什么配置了“工具权限”后，工具仍然直接执行？
智能体模板中的 工具权限 只处理已经进入审批流程的确认型工具调用，不会让原本直接执行的调用自动进入审批。
对于沙箱工具，先在沙箱模板或实例的 工具审批配置 中开启审批；关闭后，沙箱工具调用直接执行，模板和渠道用户的审批处理规则不参与。MCP、知识库、Skill 和平台工具包的配置页面不提供这个沙箱审批开关，模板规则也不会把这些调用改为需审批调用。应通过能力提供方的身份、权限和允许范围控制可执行操作。参见确认哪些工具调用会进入审批。
渠道用户的工具审批规则会覆盖模板规则吗？
不会。对于已经建立用户绑定的渠道调用，平台先检查智能体模板中的拒绝和允许规则；模板规则一旦命中，就不会继续检查渠道用户规则。只有模板规则未命中时，才检查对应 用户绑定 中的“工具权限规则”。
需要按用户区分处理方式时，让目标调用在模板中保持未命中，再配置用户补充规则。不要使用会提前匹配所有用户的宽泛模板允许规则。参见配置渠道用户补充规则。
工具审批规则能代替工具服务的访问授权吗？
不能。审批处理规则决定已经进入审批流程的调用是自动批准、自动拒绝还是交由人工处理；工具服务、MCP Server、沙箱或业务系统仍会使用自己的身份和权限执行请求。
必须禁止的操作应同时使用最小权限凭证、服务端授权、调用方允许列表或沙箱网络策略限制。不要把模板拒绝规则当作唯一的安全边界。
“工具权限”中的工具名称、参数名和匹配正则从哪里找？
工具名称来自工具的可调用名称，参数名来自输入 schema 顶层 properties，匹配正则则由你根据允许或限制的参数值编写。MCP 工具可以在 MCP 实例的 工具列表 中查看名称和输入 schema；沙箱工具列表提供名称和描述，需要按参数值配置时先通过低风险测试和 Trace 核对参数。
名称必须与工具定义完全一致。参数名和匹配正则必须同时填写；任一项留空时，规则只按工具名称生效。无法确认参数结构时，应保留人工审批，不要猜测参数名或创建宽泛允许规则。参见找到工具名称和参数名。
Skill 中的文件和脚本在哪里使用？添加 Skill 后会自动执行吗？
智能体通过技能组激活所选版本的 Skill，并在 Skill 说明需要时按相对路径读取相关资源。读取脚本文件只会取得其内容，不会自动执行、安装依赖或注册工具。
把技能组和沙箱添加到同一个智能体模板，不会自动把 Skill 文件放入沙箱。任务需要执行脚本时，应通过沙箱自身的工具、文件、运行时和依赖完成执行。
创建智能体实例后，应在 Trace 中确认 Skill 激活和资源读取，再通过 Playground、Trace 和沙箱运行记录分别确认沙箱工具的实际执行。Skill 使用正常不表示沙箱已经具备对应文件，沙箱执行成功也不表示目标 Skill 已经生效。参见在运行时读取 Skill 内容和资源和配置沙箱模板和实例。
用户工具包中的工具在哪里运行？沙箱或子代理可以执行吗？
用户工具包不提供运行环境。工具运行在通过 Invoke API 或 WebSocket 接入的业务系统中；业务系统接收工具中断、执行操作并返回结果。
沙箱不会因为与用户工具包同时添加到一个智能体模板而自动成为它的执行器，主智能体也不会代替业务系统处理子代理运行中的用户工具中断。需要平台内执行时，直接配置平台工具包、MCP 或沙箱；需要业务系统控制企业 API 调用时，使用用户工具包。
参见定义用户工具包、配置沙箱模板和实例和将任务委托给子代理。
子代理是否等同于多智能体工作流？
不等同。子代理把任务异步委托给已有智能体实例，并提供任务状态和结果；控制台不提供任意工作流图编辑。
如果你熟悉 crew、connected agent 或 subgraph，可以把子代理理解为受管理的实例间任务委托，而不是嵌套工作流。需要精确控制流程时，由外部编排系统调用相应智能体实例。参见理解模型驱动的动态委托。
子代理等待审批时在哪里处理？
通过飞书渠道运行主智能体时，子代理的确认型审批会显示在主智能体所在会话中。核对审批卡片中的操作和参数后批准或拒绝，再到智能体实例的 后台任务 确认任务继续运行或结束。
该审批只回答批准或拒绝，不会替业务系统执行用户工具包。用户工具包仍需 Invoke API 或 WebSocket 调用方返回工具结果。参见处理子代理的确认审批。
MCP Server 运行在哪里？
MCP Server 运行在 AgentWorks 之外。平台保存远程连接配置并发现工具；在普通控制台配置 MCP Server 时，传输方式为 Streamable HTTP。
“沙箱模板启动类型”是在选择冷启动方式吗？
不是。该标签选择沙箱隔离类型，即 Docker 容器或 Virtual Machine。真正的冷启动或预热策略由平台管理员在沙箱规格中配置。
如何定义自己的沙箱环境配置？
警告
仅限 AgentWorks 管理控制台
自定义沙箱环境、维护沙箱规格以及将规格分配给租户，只能在独立的 AgentWorks 管理控制台 完成。普通用户需要新的环境或规格时，请联系管理员。
普通用户只能选择平台管理员开放的环境。管理员在 AgentWorks 管理控制台的 沙箱环境管理 中配置镜像和工作目录，再把规格分配给租户。
每个会话都会自动获得独立沙箱吗？
不会。会话和沙箱是不同对象；创建 session_id 不会自动创建 Docker 容器、Virtual Machine 或其他独立执行环境。
需要代码或命令执行时，先为智能体模板添加沙箱模板或实例，再在目标智能体实例中测试执行和隔离结果。如果你熟悉按会话创建的 microVM、code interpreter 或 runtime environment，不要把它们直接等同于 AgentWorks 的沙箱生命周期。参见配置沙箱模板和实例。
知识库模板会同时配置解析、Embedding、重排和检索吗？
不会。知识库组配置用于选择知识库集合和 top_k 等检索参数；文档入库、构建任务和日志在 知识库管理 中处理。
解析器、Embedding 模型、重排器、混合检索和元数据过滤并不统一由知识库模板配置。上线前应使用固定问题检查入库结果、目标集合、实际检索结果和回答。参见配置知识库组和创建集合并导入知识。
记忆库和上下文压缩有什么区别？
上下文压缩用于控制长会话中送入模型的上下文，不会创建或更新记忆库条目；记忆库保存可供智能体后续检索的记忆条目。长会话需要继续使用早期事实时，可以启用上下文压缩；需要把信息保存为记忆条目并在后续交互中检索时，使用记忆库。
“记忆 - 模板”是否也会显示在记忆库管理页面？
不会。记忆 - 模板 是智能体模板的插件配置中准备记忆库的方式，不是 记忆库管理 页面中的另一类记忆库。该页面只管理已经创建的记忆库及其中的记忆条目。
- 选择 记忆 - 实例：将智能体模板连接到一个现有记忆库。从该模板创建的多个智能体实例都会使用所选记忆库。
- 选择 记忆 - 模板：仅在列表中已有可选模板时使用。创建智能体实例时，平台根据模板为该实例准备一个记忆库资源。
如果 记忆 - 模板 下没有可选项，请联系平台管理员确认当前环境是否提供记忆库模板。只需要一个专用记忆库时，可以选择 记忆 - 实例，但关联该记忆库的智能体模板不应供其他用户创建实例。业务要求每个新实例使用独立记忆库时，不要用一个包含私有数据的现有记忆库代替。
如何让多个智能体实例共享或隔离记忆？
需要有意共享同一份记忆数据时，为这些智能体实例选择同一个 记忆 - 实例。任何能够基于该智能体模板创建实例的人，创建出的实例都会连接该记忆库。不要把个人或私有记忆库连接到供他人复用的智能体模板。
需要每个新建智能体实例使用单独记忆库时，选择环境中可用的 记忆 - 模板。没有可选模板时，可以为每个隔离范围准备单独的智能体模板和现有记忆库，或由调用方业务系统管理按用户区分的长期记忆。配置不同记忆库后，再使用两个测试用户确认双方不能检索对方的测试事实。参见选择记忆库的使用范围。
生产环境可以让 Skill 动态使用 latest 吗？
可以，但不适合需要可重复结果的生产智能体。选择 latest 会动态跟随最新版本，后续 latest 变化可能改变智能体实例行为。生产技能组应选择经过验证的明确版本；修改版本后，更新智能体实例，并用目标版本独有的说明或资源重新检查行为。
参见管理 Skill 版本。
测试与排障
长会话越来越慢或接近上下文上限怎么办？
不再需要原对话时，开始新会话。需要继续原任务时，在智能体模板中启用上下文压缩，选择可调用的压缩模型，更新目标智能体实例，并用固定长会话比较事实保留、工具连续性、延迟和 Token 用量。如果仍在压缩前接近上限，降低压缩模型最大长度或压缩阈值，并减少过大的工具返回。
需要跨会话保存的稳定事实应放入记忆库或业务系统。参见排查长会话上下文压力和配置模型、提示词与上下文压缩。
智能体没有使用已经添加的能力时，应该检查什么？
先在智能体模板详情页的 插件 页签确认关联，再确认测试智能体实例已经更新到最新配置。使用一个必须依赖该能力才能完成的输入测试，并在智能体实例的 Trace 中检查模型是否发起了工具调用以及返回结果。
如果 Trace 中已经出现调用，再根据能力类型检查 沙箱运行记录、知识库构建任务和日志或 后台任务。参见为智能体添加能力和查看 Trace、指标和运行记录。
如何在上线前评估智能体效果？
先创建与生产隔离的预发布智能体实例，使用固定的成功、失败和边界用例通过 Playground 或 Invoke API 测试，再检查 Trace、工具结果、知识检索、记忆行为、延迟和 Token 用量。对高风险工具还要测试批准、拒绝、超时和重复请求。
AgentWorks 的这些能力支持人工验收和问题定位；评测数据集、自动评分、质量门禁和提示词自动优化需要由外部评测系统或团队流程补充。参见通过预发布验收。
API 调用暂停并返回 pending_interrupt 时怎么办？
不要用同一个 session_id 发送新的普通提示词。使用响应中的中断 ID 提交 interrupt_response：确认型中断使用 APPROVE 或 REJECT，输入型中断和用户工具结果使用 RESPOND，无法完成时使用 ERROR。
中断响应必须发回同一个会话。参见管理 API 会话、调用任务和中断。
在哪里查看工具调用、Token 用量和后台任务？
在智能体实例的 Trace 中查看输入、模型执行、工具调用、结果、耗时和中断；在工作台查看调用量、成功情况和 Token 用量；在 沙箱运行记录、知识库任务日志和 后台任务 中继续定位对应能力。
这些页面用于排查当前实例及相关能力的运行问题。参见查看 Trace、指标和运行记录。
API 调用返回 HTTP 200 就表示业务成功吗？
不一定。Invoke API 可能返回 HTTP 200，并在 JSON 错误信封中提供实际业务状态。客户端必须检查 success_response、http_status_code 和 data.reason，不能只检查 HTTP 状态码。
运行、安全与治理
能否停止一个智能体实例？
智能体实例页面没有停止或启动操作。需要暂停访问时，关闭 API 调用、停用 Token、停止或改绑渠道，并在调用方停止流量。
Agent API Token、WebSocket Token 和控制台登录身份可以互换吗？
不能。临时调试 Token 和 Agent API Token 用于 Invoke API；WebSocket Token 用于对应渠道接入；控制台登录身份用于管理产品对象。
调用方应按接入方式使用正确 Token，并分别执行授权、保存、轮换和停用。参见管理 API 调用和 WebSocket Token。
如何访问 AgentWorks 管理控制台？
AgentWorks 管理控制台与 AgentWorks 控制台使用独立入口。AgentWorks 管理控制台地址由平台运维人员提供，并应只开放给获得相应权限的管理员；AgentWorks 控制台中没有跳转到 AgentWorks 管理控制台的固定入口。
AgentWorks 提供哪些运行和治理控制？
可用能力包括租户能力类型开关、沙箱规格和环境、智能体实例状态和配置同步、API 开关和 Token、渠道用户绑定、Trace、调用和 Token 指标、沙箱运行记录及知识库入库日志。
组织级审批、自动评测、合规审计和预算管理需要通过现有企业流程或外部系统完成。
兼容性与迁移
AgentWorks 可以定义自定义编排循环吗？
AgentWorks 管理一次运行中的模型请求、能力调用、流式事件、会话和中断。添加子代理后，模型还可以根据任务动态委托给已有智能体实例。构建者负责配置模型、提示词、能力和权限，不需要为这些运行步骤绘制流程图。
如果需要由构建者精确控制节点、状态、条件路由、并行、重试、循环和终止条件，请在外部编排系统或智能体框架中定义这些步骤。外部系统保存编排状态，通常通过 Invoke API 调用 AgentWorks 智能体实例。如果接入方是需要双向长连接的自有消息系统，可以使用 WebSocket。AgentWorks 提供可调用的智能体步骤，不运行该外部流程。
如果你熟悉 LangGraph graph、Copilot Studio 或 Gemini Flow，以及 CrewAI Flow，可以把它们理解为可选的外部编排方式；AgentWorks 的单次运行循环和子代理委托不等同于外部编排。参见区分平台单次运行和可选的外部编排。
子代理和 Copilot Studio 的生成式编排相同吗？
两者都可以让模型根据用户输入、系统提示词和可用能力决定直接回答、调用工具或委托其他智能体。AgentWorks 的 子代理用于把任务异步委托给已经配置的智能体实例，再由主智能体取得结果并完成回答。
AgentWorks 不会根据一段自然语言说明自动生成主题、触发器或流程配置，也不显示一份可编辑的运行计划。主智能体根据系统提示词以及子代理的名称和描述选择委托目标；需要固定路由、重试次数、循环条件或终止条件时，由外部流程负责这些控制。参见让主智能体准确选择子代理。
AgentWorks 是否支持 A2A？子代理是否通过 A2A 通信？
AgentWorks 的 子代理只能选择已经存在的 AgentWorks 智能体实例。委托任务通过 后台任务查看状态和结果；配置时不填写 Agent Card 或 A2A 服务地址。因此，子代理不是 A2A 接入，后台任务也不是 A2A Task。
AgentWorks 提供 Invoke API、WebSocket 和相关文件接口，不提供 Agent Card 或 A2A 任务端点。需要组合独立部署的外部智能体时，请在外部系统中保留协调和编排逻辑，再通过目标部署提供的 Invoke API 调用 AgentWorks。如果接入方是需要双向长连接的自有消息系统，可以使用 WebSocket。需要接入外部工具、API 或数据资源时，使用 MCP 或用户工具包。
不要把 A2A 的 Task 或上下文标识直接映射为 AgentWorks 的调用任务、后台任务或 session_id；它们属于不同的接口契约。参见将任务委托给子代理和区分接口和能力的调用方向。
可以直接托管 LangGraph、CrewAI 或其他框架代码吗？
不能直接上传并托管这些框架的运行项目。AgentWorks 运行由控制台配置创建的智能体实例，不提供任意框架代码的通用托管入口。
已有 LangGraph、CrewAI、ADK、Strands、LlamaIndex 或自定义服务可以继续在外部运行，再通过 Invoke API 调用智能体实例，或者通过 MCP 和用户工具包向智能体提供能力。这是系统集成，不是把原有运行时迁移到 AgentWorks。
AgentWorks 是否提供 LangGraph、ADK 或 CrewAI 的专用适配器？
AgentWorks 提供通用 Invoke API。能够按照接口契约发送请求的业务应用，以及使用外部框架构建的应用，都可以调用已经创建的智能体实例。
AgentWorks 不提供 LangGraph、ADK 或 CrewAI 的专用适配器。使用外部框架时，原有流程继续在框架自己的运行环境中执行；集成方负责把框架输入转换为 Invoke 请求，并管理流程状态、session_id 对应关系、重试、终止和跨系统排障。参见在外部流程中划分运行责任。
可以从 Git 仓库、ZIP 或 CLI 导入并部署智能体项目吗？
不能通过通用 Git 仓库、项目 ZIP 或 CLI 部署智能体运行项目。智能体模板和智能体实例通过控制台管理。
Skill 支持 ZIP 导入和导出，但 ZIP 只包含 SKILL.md 和相关文件，不等于完整智能体或编排运行时。智能体可以按需读取这些资源，但平台不会把 ZIP 当作代码项目部署、安装依赖或自动运行脚本。已有代码项目应保留在原有运行环境中，并通过 API、MCP 或用户工具包接入。
可以在每次 API 调用时临时更换模型或插件吗？
不能通过 Invoke 请求临时覆盖模型或插件。模型、提示词和插件属于智能体模板及其智能体实例配置；Invoke 请求用于发送提示词、继续会话、响应中断以及选择流式或非流式响应。
需要不同模型或能力组合时，创建或更新对应智能体模板和智能体实例，并分别完成测试。不要把其他平台的 per-invocation override 直接映射为 AgentWorks 的调用参数。
可以查看、修改、回放或分叉智能体运行状态吗？
可以通过 Trace 查看输入、模型执行、工具调用、结果和中断，也可以通过 Invoke API 查询调用任务状态，并在任务无法继续时重置。平台不提供用户定义的状态模式、检查点历史、任意状态编辑、时间回放或从检查点分叉。
如果你熟悉 LangGraph 的 state、checkpointer、thread 和 time travel，可以把 session_id 理解为继续 API 会话的标识，而不是这些能力的一一对应。SSE 断开后，先查询调用任务状态，再决定继续、重置或新建会话。参见管理 API 会话、调用任务和中断。
session_id 与 thread_id、conversation_id、runtimeSessionId、kickoff_id 有什么区别？
这些标识都与一次对话或执行有关，但管理的对象不同：
| 熟悉的标识 | 与 AgentWorks 最接近的概念 | 需要注意的区别 |
|---|---|---|
LangGraph thread_id | API session_id | 都用于继续上下文；AgentWorks 不提供检查点历史、回放、分叉或 thread CRUD |
Dify conversation_id、Flowise sessionId | API session_id | 都用于多轮连续对话；AgentWorks Invoke API 不提供会话列表、读取或删除端点 |
AgentCore runtimeSessionId | 没有一一对应项 | 它还管理运行环境的隔离和生命周期；AgentWorks session_id 不会创建专属运行环境 |
CrewAI AMP kickoff_id | 调用任务 | 它标识一次执行；一个 AgentWorks API 会话可以包含多次调用任务 |
Copilot Studio New chat | 开始新会话 | API 调用时省略原 session_id；渠道中使用 /session new |
迁移时先确定你要管理的是多轮对话、一次调用任务、长期记忆还是隔离运行环境，再选择对应能力。参见理解会话、调用任务、记忆库和沙箱。