会话管理
进入 开发专区 > 会话,可为已发布的 Agent 创建会话,发送消息并查看执行过程。
会话列表支持按名称或 ID 搜索、刷新、创建会话和批量删除。列表展示会话状态、关联 Agent、环境、创建时间和更新时间;操作列提供调试、API 接入和删除入口。

创建会话
点击页面右上方的创建会话,或从 Agent 列表点击目标 Agent 的创建会话。
按下表填写基本信息,完成后点击创建并进入调试。

| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 会话名称 | 必填 | 不超过 50 字,建议使用便于识别本次任务的名称 |
| 选择 Agent | 必填 | 仅可选择本企业在开发平台中已发布的 Agent |
| 凭证库 | 选填 | 选中的凭证库在本会话中可用,运行时按 MCP 注入对应凭证 |
| 环境 | 必填 | 选择 Agent 运行时使用的环境模板 |
| 资源配置 | 按需开启 | 开启后可通过选择文件挂载文件资源,并按文件名称或描述搜索 |
如需先准备凭证库或环境,可使用表单中的去凭证库、去环境管理入口。
在选择 API Key弹窗中选择用于本次调试的 API Key,按页面提示进入调试。

注意:选择 API Key 后,调试发起的调用和用量将归属该 Key。请使用与本次业务场景匹配的 Key。没有可用 Key 时,可通过弹窗中的入口前往 API Key 管理页面。
调试已有会话
在目标会话的操作列点击调试,进入会话详情。

会话详情提供以下页签:
| 页签 | 说明 |
|---|---|
| 事件 | 可切换对话视图和调试视图,后者支持按事件类型筛选 |
| Agent | 查看关联 Agent 的名称、ID、版本、描述、模型和记忆配置 |
| 凭证库 | 按凭证库筛选,查看凭证类型、绑定 MCP、所属库和脱敏密钥等信息 |
调试视图的筛选项包括 session_status、message、model_request_start、reasoning、model_request_end、tool 和 other,可用于定位不同类型的执行记录。
说明:建议从简单问题开始,先验证基础响应,再逐步验证文件读取、技能或连接应用调用。如果需要进行真实鉴权调试,请先为该会话准备正确的凭证库。
查看 API 接入指引
在会话列表操作列或会话详情右上方点击 API 接入,查看快捷接入面板。按面板提示准备 API Key,并结合完整 API 参考完成接入。

注意:API Key 属于敏感凭证,请妥善保管,不要写入前端代码、公开仓库、文档或截图。
管理会话记录
使用会话列表中的搜索和刷新功能查找目标会话。清理会话前,先核对名称、ID 和关联 Agent,确认不再需要相关调试记录。
如需删除单个会话,点击对应行的删除;如需批量清理,先勾选目标会话,再使用批量删除。后续操作以页面确认提示为准。

评价此篇文章
