文档 / 让 AI 操作个人空间
让 AI 操作个人空间
以下是茄总对话中 Agent 的能力,不是沙箱应用的 platform.* API。应用仍然只能使用已经授权的 Bridge,也不能直接联网。
已经支持的操作
- 文件:搜索文件名、查看目录、创建目录、重命名、移动、删除普通文件和空目录。
- 知识库:读取、搜索、创建和更新笔记,创建目录、移动笔记及目录,收录文件、检查引用。
- 数据库:查询、添加、修改、删除记录;一次添加最多 50 条,任意一条无效时全部拒绝。
- 应用市场:搜索、查看详情、安装。安装创建独立的空数据集,不复制作者记录;重复安装保留现有应用与数据。
- 构建应用对话:创建表和应用、修改表结构、读取多文件源码和更新应用。读取源码默认返回文件清单,指定文件后分段读取,每次最多 40,000 个字符。
示例:“把旅行资料重命名为 2026 年旅行资料”“把这些账单整理成记录”“把这篇笔记移动到工作目录”。
图片与后续追问
对话附件支持图片内容理解。最近 20 条消息中,最多 4 张近期图片会继续附带原图内容,发送不含附件的追问也不会立刻丢失图片。每张图片最多 5MB;这项限制同时适用于 Web 和 iOS。
较早图片保留文件名称和编号;需要时 Agent 可以使用 read_file 重新读取图片像素,不需要为了阅读而收录进知识库。超出上下文窗口的文件可以先通过文件搜索找到,再按编号读取。每次模型请求最多附带 4 张图片,模型能否正确理解图片仍取决于所选模型的视觉能力。无法访问或不存在的当前附件会明确报错,不会假装已经读取。
直接执行,并继续后续步骤
Agent 调用写入工具时就会执行,并留下操作记录,然后继续完成同一段任务里的后续步骤。删除、移动、覆盖修改、批量添加、表结构调整、应用安装、发布,以及修改已经记住的信息,都按这个方式处理。模型不能通过额外参数跳过归属、空目录或冲突检查。
日常写入不会停下来等你逐项批准。只有确实需要你做决定时,Agent 才会在输入框旁边给出选项;你可以直接点一个选项,也可以不点,自己输入答复。Web 和 iOS 使用同一种方式。对话里不再使用「若干项操作需要关注」或查看、隐藏历史这套操作卡片。
一轮任务会一直做到 Agent 给出回复。如果连续处理了很多步还没结束,或者同一步骤反复没有成功,会先停下来。已经完成的修改都保留,你可以让它继续,或换个方式说明。
更早留下、尚未执行的记录不会在启动时自动补执行。这类记录如果已经超过 24 小时,或者对象已经变化,再次执行会被拒绝。字段删除会清除对应记录值,表结构修改不提供一键撤销。
操作记录和异常处理
每次写入都有操作记录。删除会话后,操作历史仍然保留。
| 状态 | 含义 |
|---|---|
| 等待你的确认 | 更早留下、尚未执行的记录。新的写入不会再停在这个状态 |
| 正在执行 | 可能仍在处理 |
| 已经完成 | 服务端已经执行成功 |
| 没有执行 | 执行前检查未通过 |
| 需要核对结果 | 请求中断,修改可能已经发生 |
| 已经取消 | 不会执行这项更早留下的待确认操作 |
| 已经恢复 | 已经恢复被删除的内容 |
重复提交相同请求不会重复执行。同一会话中仍未执行、正在执行或结果不确定的相同操作不会重新创建。结果不确定时只核对当前内容,不重新执行,也不会把相似内容误认为确定成功。
停止接收回复不代表取消服务端操作。当前不提供断线任务自动续跑或通用跨资源事务。
删除恢复
通过 Agent 删除的普通文件、空文件夹、空知识库目录、笔记和记录,可以告诉 Agent 恢复。文件内容与恢复资料私有保存,账号删除时一起清除。
恢复保留原 ID、内容和关联引用,不覆盖后来创建的内容。原目录不存在、数据表结构已经变化或原位置出现冲突时,会拒绝恢复并说明原因。需要先恢复原目录,再恢复其中的内容。
系统知识库根目录不能重命名或删除。普通文件工具不能修改知识库内部文件;应该通过知识库工具操作。此恢复范围仅限经过 Agent 操作记录删除的内容,不代表所有手动删除或覆盖编辑都可以撤销。
模型是否支持图片
图片识别能力取决于实际选择的模型。官方默认 DeepSeek Flash 支持图片;DeepSeek 官方接口的 deepseek-v4-pro 不支持图片。选择后者时,上传图片会收到明确的切换提示,不会将不能识别误报为上传失败;文字对话仍然可用。切换到「官方默认」后,可以继续询问近期已上传的图片,不需要重新上传,也不会清除保存的自定义模型配置。按需读取图片与知识库图片整理遵循相同检查。
此检查只针对已经确认的服务地址与模型组合;不能根据任意兼容接口的模型名称推断能力,也不表示所有自定义模型均已通过视觉验证。