Skip to main content
官方智能体由平台预置并维护，所有用户可读、可直接引用其 agent_id 创建会话（Session），但不能更新或归档。自定义智能体由你通过 API 或控制台创建，仅你的项目可见，允许更新和归档。需要定制时，参照官方智能体的配置创建自己的自定义智能体，详见 智能体。
技能（Skill）是基于文件的可复用能力包：一个 SKILL.md 加上若干资源文件，告诉模型怎么做某类任务。插件（Plugin）是可复用的能力分发单元，分为平台维护的官方插件和项目自建的自定义插件，可以包含 MCP 服务和捆绑技能，引用后一次性获得打包好的工具连接与技能。详见 技能 与 插件。
记忆库是项目级的持久化文件集合，可以挂载到不同会话中反复读写，并保留版本历史；会话文件随会话产生，用于一次任务的输入与产出。需要跨会话沉淀的资料放记忆库，详见 记忆库；任务产出文件的取回见 文件。
不会。会话在创建时冻结当时的智能体版本，中断恢复也继续使用该版本；更新智能体只影响之后新建的会话。
更新请求携带的 version 与智能体当前版本不一致，说明它在你读取后被其他操作修改过。重新调用 GET /v1/agents/{id} 取得最新 version，确认配置后重试。不携带 version 则不做并发校验，详见 智能体。
使用官方插件或指定精确版本的自定义插件时，平台会把引用固定为当时的采用版本并写进智能体的不可变版本，之后插件升级不影响已保存的智能体版本。要让智能体用上新版本，需要对智能体做一次更新，生成新的智能体版本；如果自定义插件引用传入 latest，则会在每次唤醒时重新解析版本，详见 插件。
不需要。重新订阅时携带断开前最后一帧的 id: 值（恢复游标，不是事件 ID）作为 cursor（或使用 Last-Event-ID 请求头），就能从断点继续读取，任务本身在服务端继续运行，详见 事件流。
会。模型请求遇到限流、服务异常或超时时，最多自动重试 20 次，重试间隔依次为 0.5 秒、1 秒、2 秒、4 秒，随后每次固定等待 5 秒。当会话中所有线程（Thread）的模型请求及后续执行都结束后，会话会进入 idle 状态，并停止累计沙箱计费时长。
执行环境（Environment）的沙箱镜像在创建后需要异步构建。收到环境未就绪的错误时，等环境状态变为 ready 后用原请求重试，不要重复创建新环境，详见 执行环境。
取消（向 POST /v1/sessions/{id}/events 发送 user.interrupt 事件）只停止当前轮次，会话回到 idle，仍可继续发送输入；归档（POST /v1/sessions/{id}/archive）把会话置为只读的终止状态，不能再发送输入，且不可逆；删除（DELETE /v1/sessions/{id}）永久移除会话，只有已归档的会话才能删除。详见 会话操作。
先调用 GET /v1/sessions/{session_id}/filesystem 列出会话文件（可用 prefix 逐层查看目录），再用文件条目的 path 通过 GET /v1/sessions/{session_id}/filesystem/raw 下载，详见 文件。
上传限制以 文件 页为准。上传后先确认 extract_status 为 ready，再把文件引用到会话。
在控制台左侧“记忆”页面，可以通过“创建记忆”一步创建记忆库并写入首个记忆文件，进入详情页可修改名称和描述、复制或归档记忆库，并配置梦境和管理记忆文件。创建会话时，可以在“记忆库”区域选择一个或多个记忆库，并分别设置只读或读写权限和专属指令。也可以通过 API 完成这些操作，详见 使用控制台 和 记忆库。