使用控制台

控制台适合在网页上配置资源、运行任务和查看结果。需要直接调用 API 时，详见 快速开始；在 AI 编程助手中，也可以通过 kha CLI 使用自然语言创建和管理资源。 当前的基本流程是：创建智能体、按需配置技能和插件、准备环境、按需准备凭据库和记忆库，然后创建会话；需要按时间自动运行时，再配置触发器。

​

快速开始：创建智能体并启动会话

“快速开始”页面是创建智能体并启动首次会话的向导，分为三步：创建智能体、配置环境、启动会话。

​

第一步：创建智能体

你可以从模板开始，也可以从空白配置开始：

​

第二步：配置环境

可以直接使用“默认环境”（推荐，通用云端沙箱，适合大多数任务），也可以选择“创建新环境”基于当前组织新建。按需配置网络访问范围，然后点击“创建并继续”。

​

第三步：启动会话

确认本次会话使用的智能体与环境（向导已预填），可选绑定凭据库、添加文件，然后点击“启动并进入会话”。创建成功后将自动进入会话工作区。

​

控制台中的资源页面

​

智能体

“智能体”页面以表格展示智能体 ID、名称、模型、归属、状态、创建时间和最近更新。可以按名称或精确智能体 ID 搜索，并按归属筛选。使用“创建智能体”按钮进入创建流程。官方智能体带有“官方”标记，项目中创建的智能体带有“项目”标记。 可以从列表操作菜单或详情页右上角“开启会话”进入已预填该智能体的创建会话流程。详情页包含以下标签页：

• “配置”：查看和编辑当前版本。选择历史版本可以查看只读快照；编辑当前版本并保存会生成新的不可变版本，不会改写历史版本。已经创建的会话继续使用创建时冻结的版本；如需使用更新后的版本，请新建会话。
• “会话”：按版本、来源和状态筛选该智能体的会话。
• “触发器”：查看该智能体的触发器。
• “成功率”：查看该智能体的运行成功率。
• “可观测性”：查看会话总数、Tool 调用、Tokens、最近会话和连接触发器。

​

技能

“技能”页面支持搜索和按分类、归属筛选。列表显示技能 ID、名称、归属、状态、最新版本和最近更新。 使用“上传技能”添加项目技能，然后在创建或配置智能体时选择它。官方技能在控制台中只读。技能的版本和使用方式见 技能。

​

插件

“插件”页面以卡片目录展示已上架的官方插件，可以按分类浏览，例如金融、办公效率、3D 创作和开发者工具。插件卡片会显示名称、简介，以及其中包含的技能或 MCP 服务数量。点击右上角“自定义插件”可进入插件构建器，按页面引导创建自定义插件。 在创建智能体时，可以从官方插件目录选择插件并加入配置。插件的具体能力和凭据要求以插件详情为准。自定义插件的创建和管理方式见 插件。

​

环境

“环境”页面展示环境 ID、名称、状态、归属、创建时间和更新时间。可以搜索环境，按归属和状态筛选，也可以选择是否显示已归档环境。 使用“创建环境”按钮新建环境。云环境创建或更新后，等待状态变为 Ready，再在创建会话时选择它。依赖包、网络配置和初始化脚本等详细配置见 执行环境。 需要在自己的基础设施中执行沙箱工具时，可以使用自托管环境。环境密钥在环境详情的“Worker”页生成，环境创建和 Worker 接入流程见 自托管环境。

​

凭据库

“凭据库”页面展示凭据库 ID、名称、状态、创建时间和更新时间，支持搜索，也可以选择是否显示已归档凭据库。 使用“新建凭据库”创建凭据库。会话需要访问外部服务时，可以在创建会话时选择凭据库，让平台在运行期间注入凭据。凭据值只写入、不回显；创建后无法再次查看明文，需要变更时轮换凭据值。详细操作见 凭据库。

​

会话

“会话”页面展示会话 ID、名称、状态、智能体、归属和创建时间。可以搜索会话，也可以按智能体和状态筛选，还可以选择是否显示已归档会话。 使用“创建会话”创建一次任务运行实例：

​

会话工作区

进入会话后，中间区域展示对话与执行过程，底部输入框可以继续发送任务。右侧有两个标签页：

• “会话信息”：查看会话状态、会话 ID，以及智能体、模型和环境等信息。
• “文件”：查看会话工作目录的文件树。智能体生成的文件保存在 output 文件夹中，点击文件即可下载。

创建会话的 API 流程还包括发送首条消息来启动任务，详见 启动会话。

​

文件

项目文件页提供 batch、batch_output 和 Hosted Agents 三个标签页。Hosted Agents 标签页显示文件 ID、文件名、文件大小、用途、状态、创建时间和可用操作，并支持搜索和显示容量信息。可以上传、下载和删除文件，单个文件不超过 100 MB，组织总容量 10 GiB；达到配额后新的上传会被拒绝，删除不再使用的文件可以释放配额。上传后不可修改，删除前需要确认。 上传文件不会自动绑定到会话。在控制台中，可以在创建会话时选择文件；通过 API 也可以在会话创建后追加文件。文件用途、解析状态和 API 操作见 文件。

​

记忆

“记忆”页面展示记忆库 ID、名称、描述和最近更新，支持按名称或记忆库 ID 搜索、按归属筛选，也可以选择是否显示已归档记忆库。 通过“创建记忆”创建记忆库并写入首个记忆文件：填写名称和文件路径（支持嵌套目录），直接输入内容或上传本地文件（单文件最大 20 MB）。创建后可在详情页补充描述。 进入记忆库详情页可以进行以下操作：

• 修改记忆库的名称和描述；
• 通过“复制记忆库”创建一个新记忆库，并将当前库的全部记忆文件复制进去（不包含历史版本）；
• 通过“归档”将记忆库置为只读，归档后不能挂载到新会话；
• 通过 Dreaming 的“配置”设置自动整理：可按活跃会话数（1–100 个变更会话）或每日计划（HH:mm、IANA 时区）触发，满足任一条件即运行；选择 Dream 智能体和环境，详见 梦境；
• 管理记忆文件：通过“添加记忆”写入新文件，已有文件可以下载或删除。

记忆库的文件版本、恢复等更多能力见 记忆库。

​

触发器

控制台可以通过“触发器”页面按计划或手动运行智能体。创建和配置触发器（Trigger）的完整字段见 定时运行智能体。 触发器列表展示触发器 ID、名称、智能体、调度配置、状态和创建时间，支持按触发器 ID 或名称搜索、按智能体和状态筛选，并可选择是否包含已归档触发器。 进入触发器详情页，可以查看消息内容、智能体、执行环境、智能体版本、调度配置、来源、时区和会话模式。下方的“运行实例”展示执行 ID、开始时间、触发方式、状态和会话 ID。可以立即运行、暂停或恢复触发器，也可以归档。暂停中的触发器仍可手动运行；恢复后从当前时间起按计划触发，不补跑暂停期间错过的时点。 梦境创建的托管触发器不能在详情页修改配置，只能立即运行；如需调整配置，请前往对应记忆库。

​

下一步