Artifacts
Agent 做给你看的网页和画布,带版本、隔离的查看器,还能分享成链接。
artifact 是 Agent 做给你看的 HTML 页面,比如一份报告、一个原型或几套设计方案。它保存在 Kettu 里,不在你的项目文件中。
类型
| 类型 | 是什么 |
|---|---|
| 网页 | 一个页面。 |
| 画布 | 一个文件里的多个页面,并排摆开。可以放大缩小,用上一页、下一页翻看,或者缩放至适合。 |
一个 artifact 最多 5 MiB 的 HTML。它只能从固定的几个公共 CDN 加载脚本和字体,别的都加载不了。
Agent 怎么做 artifact
Kettu 内置一个 MCP 服务器 kettu,给 Agent 提供创建、读取、更新、列出和删除 artifact,以及列出版本、恢复某个版本的工具。Agent 只能看到它所在会话的项目里的 artifact。
Claude Code 和 Codex 总能使用它。其他 Agent 支持通过 HTTP 连接的 MCP 服务器时也能用;不支持的,设置 › MCP 服务器里会写明它“不支持通过 HTTP 连接的 MCP 服务器”。同一页上每个 Agent 都有一个开关,比如在 Claude Code 中使用 Kettu 的工具,改动在这个 Agent 下次启动时生效。
想要一个,就在 Artifacts 页面的让 Agent 做一份下点网页或画布。新建会话会打开,输入框里已经写好要这种类型的那句话,补上你想要的内容再发送。也可以在任何会话里直接让 Agent 做。
对话里,Agent 的改动显示为一行,比如已创建或已更新,带着版本号。点它,artifact 在对话旁边打开,Agent 继续修改时它会自动重新加载。
版本
每次改动都是一个新版本:v1、v2,依次往后。版本历史列出所有版本,以及写下每个版本的会话,或者你。打开较早的版本可以查看,点恢复这个版本会把它复制成最新版本,所以不会丢失任何版本。
查看器
每个 artifact 在自己独立的源(origin)上运行,和应用本身、和其他 artifact 都隔开。它不能使用摄像头、麦克风和位置,不能提交表单,也不能打开别的网站。页面试图这样做时,查看器会提示此页面试图打开某个地址,点在浏览器中打开用默认浏览器打开它。页面停止时,点重新加载再显示出来。
Artifacts 页面
点侧边栏里的 Artifacts。这里按最近打开排列所有 artifact,可以用筛选按类型和项目过滤,布局可选平铺或按项目和会话分组,也能换排序方式。macOS 上按 ⌘F、Windows 和 Linux 上按 Ctrl+F 按标题筛选。新建会话页上也会显示最近的 Artifacts。
每个 artifact 的菜单里有打开、在浏览器中打开、导出…、重命名…、版本历史、打开会话和删除…。**导入 HTML 文件…**可以加入你自己的页面。
删除的 artifact 会移到最近删除,在那里保留 30 天,期间可以恢复或永久删除…。30 天后,它和它的所有版本都会被永久移除。
分享成链接
查看器里的分享通过你自己的 Cloudflare 账号,把 artifact 发布成任何人都能打开的链接:
连接 Cloudflare
在设置 › 分享里粘贴一个具有 Workers Scripts Edit 权限的 API token,点连接。这个账号需要有 workers.dev 子域名。token 由系统加密保存,只存放在这台电脑上。
发布
点分享,再点发布,然后复制链接。任何拿到链接的人都能看到这个页面,页面会从公共 CDN 加载脚本和字体。
改动之后,点更新到版本把最新版本发布到同一个链接。**取消发布…**让所有人都无法再打开这个链接,artifact 仍保留在 Kettu 里。设置 › 分享列出所有已发布的 artifact。