Antigravity Artifacts 是谷歌 Antigravity 平台中的一个核心机制,它代表了 AI Agent 在分析、执行任务以及与用户互动过程中生成的所有工作产物。这些产物形式多样,包括但不限于 Markdown 文档、代码差异、架构图表、图像、浏览器录屏等,它们本质上是 Agent 与用户进行异步沟通和协作的关键媒介。
当 AI Agent 需要长时间自主运行时,用户无需时刻监控其所有操作。此时,Artifacts 便成为了 Agent 汇报进度、阐明思考逻辑和展示阶段性成果的重要窗口。这些产物主要在“规划模式”中生成,并在“Agent Manager”和“Editor”视图中集中呈现。其中,“Agent Manager”视图侧重于对这些 Artifacts 进行高效的检索、分类与管理。
Artifacts 不仅仅是 Agent 的输出结果,它更是一套促进人机高效协同的工作流。通过 Artifacts,用户可以实时审查工作进展并提供反馈,从而引导 Agent 的后续行动方向。根据用户设置,Agent 可能会主动请求对中间产物进行审查,以确认其思路或实现是否符合预期。虽然不同类型的 Artifacts 拥有不同的用户交互界面,但其核心目标一致:为用户提供便捷的介入点,以便施加有效的影响和指导。
深入了解各类核心 Artifacts
为了应对软件开发中的多样化场景,Antigravity 平台设计了一系列特定类型的 Artifacts,每种类型都具备独特的用途和交互模式。
任务清单 (Task List)
任务清单是 Agent 用于拆解复杂任务、追踪多线程行动进度的内部工作指南。它通常以 Markdown 列表的形式呈现,详细记录了 Agent 在研究、实施、验证等环节的子任务。这份清单是帮助 Agent 保持专注、确保每一步行动都服务于整体目标的重要工具。用户通常无需直接与之互动,它更多是 Agent 进行自我管理的实时状态快照。

实施计划 (Implementation Plan)
实施计划 Artifact 是 Agent 构思和规划代码库变更的核心载体。它详细阐述了为完成特定任务所需要进行的修改内容,并且通常需要用户进行关键审查后才能继续执行。

除非用户将审查策略设置为“始终自动继续”,否则 Agent 在着手修改代码前,会主动请求用户对实施计划进行审核。用户可以通过点击对话流或 Artifact 顶部的“继续”按钮,立即批准该计划的执行。

Agent 生成的计划有时可能与用户预期存在细微出入。Antigravity 支持用户直接对 Artifact 添加评论,以便提供精准反馈,例如建议缩小变更范围、更换技术方案,或纠正 Agent 理解上的任何偏差。

即使用户已经在实施计划上留下了评论,仍然可以点击“继续”按钮推进流程。此外,也可以切换至 Artifact 顶部的“审查”视图,集中查看所有评论并给出综合反馈,而非直接继续。一旦用户选择“继续”或完成审查,Agent 便会继续工作——可能是根据反馈迭代更新实施计划并再次请求审查,也可能是直接开始执行代码变更。

实施概要 (Walkthrough)
当 Agent 完成一项任务的实施后,会自动创建一个实施概要 Artifact。它对所做的更改进行精炼总结,旨在帮助用户快速回顾本次对话中发生的关键变动。对于未能实时跟踪 Agent 工作的用户而言,这是了解代码库最新状态的绝佳途径。对于涉及浏览器操作的任务,实施概要中通常会包含 Agent 在浏览器中构建或操作内容的屏幕截图与录屏。

屏幕截图 (Screenshots)
浏览器子 Agent 可以在需要用户审查页面状态时,对打开的网页或特定页面元素进行截图。此功能作为 Agent 的一个工具呈现,用户也可以主动指示 Agent 对特定区域截图。所有屏幕截图均以图像 Artifact 的形式保存,并支持评论功能,方便用户向 Agent 提供视觉相关的反馈。

浏览器录屏 (Browser Recordings)
每当浏览器子 Agent 执行操作时,都有可能生成操作过程录屏供用户审查。如果录屏可用,用户可在浏览器步骤界面的底部查看回放。所有浏览器录屏也会作为独立的录屏 Artifact 保存。该视图会循环播放 Agent 在浏览器中的操作序列,清晰直观地展示其执行路径。

知识项 (Knowledge Items)
知识项是 Antigravity 的持久性记忆与知识管理体系,它能自动捕捉并组织用户在编码会话中产生的重要见解、通用模式和有效解决方案。其核心价值在于帮助用户在不同开发会话之间构建和复用沉淀下来的工作成果。
那么,知识项具体是什么?它是一个围绕特定主题的相关信息集合。每个知识项都包含描述其内容的标题与摘要,以及一系列提供该主题详情的关联 Artifacts。这些 Artifacts 的示例可能包括自动生成的文档、可复用的代码示例或需持久记忆的用户指令。
知识项是如何生成的?在与 Agent 的交互过程中,Antigravity 会自动分析对话内容,提取关键信息,并据此创建新的知识项或更新已有的知识项。
如何查看知识项?用户可以在 Antigravity 的 Agent Manager 界面中浏览和管理所有知识项。

Agent 如何使用知识项?所有知识项的摘要都对 Agent 可用,Agent 会利用这些知识来生成更明智的响应。当 Agent 识别出当前对话与某个知识项相关时,它会自动深入研究该知识项内的 Artifacts,并应用其中适用的信息。
Artifacts 类型一览表
为了帮助开发者更系统地理解各类 Artifacts 及其在开发流程中的定位与作用,以下整理了一份详细的对比表格:
| Artifact 类型 | 主要用途 | 用户交互方式 | 示例内容 | 适用场景 |
|---|---|---|---|---|
| 任务清单 | Agent追踪复杂任务进度,保持目标一致 | 通常无需直接交互 | Markdown列表形式的研究、实现、验证步骤 | Agent内部规划与自我管理,用户了解Agent当前行动 |
| 实施计划 | Agent提出代码库修改方案,供用户审查 | 审查、评论、点击“继续”或“审查”按钮提供详细反馈。Agent会根据反馈迭代或执行。 | 技术细节、修改清单、架构变更提议 | Agent修改代码前,用户审查和批准其方案,提供指导和纠正 |
| 实施概要 | Agent完成任务后,总结所做更改 | 查看,快速了解代码库状态,尤其是在长时间未关注Agent工作后。 | 任务完成总结、变更点概览、浏览器任务的截图/录屏 | 了解Agent已完成的工作,验证结果,快速跟进项目进展 |
| 屏幕截图 | 视觉展示页面状态或特定元素,供用户审查 | 查看图片,可评论提供反馈。可主动要求Agent截图。 | 网页截图、UI元素截图 | 视觉验证UI/UX变更,确认浏览器子Agent的操作是否符合预期 |
| 浏览器录屏 | 录制Agent在浏览器中的操作过程,供用户回放审查 | 查看录像回放,了解Agent在浏览器中的具体动作。 | Agent在网页上的点击、输入、导航等操作的视频 | 深入理解Agent在浏览器任务中的执行逻辑和步骤,用于调试和审计 |
| 知识项 | 持久化存储和组织重要见解、模式和解决方案,形成Agent的长期记忆 | 在Agent Manager中查看。Agent自动利用相关知识项来生成更明智的响应。 | 相关Artifacts集合(文档、代码示例、用户指令等),带有标题和摘要 | 跨会话重用经验,Agent生成更连贯、更准确的响应,提高开发效率和一致性,构建长期项目知识库 |
总结与展望
Antigravity Artifacts 的设计精妙之处在于,它通过一套灵活、透明且可交互的机制,巧妙平衡了 AI Agent 的高度自主性与用户所需的精准控制与深度反馈。无论是支撑 Agent 的内部任务管理,还是赋能用户在关键代码变更上的审查与指导,乃至实现项目知识的长期积累与智能复用,Artifacts 都扮演着至关重要的枢纽角色。熟练掌握并有效运用各类 Artifacts,将能显著提升开发者与 Antigravity Agent 的协作流畅度与产出质量,共同驱动软件开发流程的智能化演进。
