如何使用IronPDF与Google Antigravity

Curtis Chau
Curtis Chau
更新: 2026年10月20日

大多数AI编码工具只停留在代码片段上。 它们给您返回代码,而您自己运行看看是否有效。 这个差距对PDF生成来说尤为重要,因为一个编译干净的PDF仍然可能在视觉上出错,而构建日志中没有任何内容告诉您徽标丢失或表格跨页了。

Google Antigravity是一个更像代理的开发平台,而不是聊天助手。 代理在编辑器、终端和浏览器中工作,返回可交付物而不是记录。IronPDF使用嵌入式Chromium引擎将HTML渲染为PDF。这种配对有一个特定原因:因为比较的双方都是一个浏览器渲染相同的HTML,代理可以打开一个页面,生成PDF,查看两者,并持续调整直到它们匹配。 这就是验证循环,也是这个指南的构建核心。

开始之前请先明确一下,因为两个听起来相似的话题容易混淆。 本指南是关于使用AI开发工具与IronPDF 构建软件。 这不是关于使用AI模型阅读或分析PDF文件内容,这在AI驱动的PDF处理教程中单独介绍。 不同问题,不同页面。

快速入门
NuGet使用NuGet安装

PM > Install-Package IronPdf

通过在 NuGet 包管理器控制台中运行上述命令安装 IronPDF,或在 NuGet 包管理器中搜索该包。

在Antigravity中打开项目并描述您想要的文档:

In this C# project, add IronPDF and create Program.cs that renders the HTML
string "<h1>Hello from IronPDF</h1>" to hello.pdf. Read the license key from
the IRONPDF_LICENSE_KEY environment variable, never hardcode it. Run
dotnet build, fix any errors, and show me the resulting file.
Text

Antigravity的代理安装了软件包,编写了构建ChromePdfRenderer并调用RenderHtmlAsPdf的几行代码,保存了文件,并报告了构建结果。 您审核的是结果,而不是一份记录。

在这里,给您一个简短的安全提示。 在代理IDE中,代理可以进行文件写入和终端访问,所以许可证密钥应放在不纳入源代码管理的环境变量或配置文件中,切勿粘贴到任务描述中或提交到仓库中。 许可证密钥指南涵盖了支持的配置选项。



什么是Google Antigravity,它与聊天助手有何不同?

Antigravity是一个代理优先的开发平台,自主代理在编辑器、终端和浏览器中计划和执行工作,然后作为可审查的可交付物报告结果。 谷歌将其描述为结合编辑器视图和管理视图,用于部署计划、执行和验证复杂任务的代理。

PDF工作中的五个重要特性。

编辑器视图是熟悉的IDE界面,具有智能补全和内联命令。 在需要精细操作单个文件时使用,您可以驱动光标并检查每个变化。

管理视图是异步任务控制中心。 生成代理、排队任务、监控进度,并在一个工作空间中并行运行工作,而不是一次等待一个对话。

浏览器控制允许代理驱动浏览器以尝试功能并确认结果。 对于IronPDF来说,这是一个主要功能,并在下方有单独章节。

工件是代理生产的可交付物,而不是原始工具日志:任务列表、实施计划、流程演练、截图和浏览器录屏。 谷歌的界定是,这些让您可以一目了然地验证代理的逻辑,您可以直接在工件上给予反馈,就像在文档上评论一样,无需终止代理的运行。

模型可选性意味着代理可以由不同的基础模型提供支持,根据任务选择。

与聊天助手的实质区别在于您审核的内容。 聊天助手生成需要您阅读的文本。 代理生成一个计划、一个差异和实际渲染输出的截图。 对于PDF任务,文档的截图比描述文档应看起来如何的段落强得多。

这种验证循环之所以有效,是因为比较的一方是诚实的。被要求从零构建文档流程的代理将乐于发挥想象力:选择一个渲染库,将其连接起来,然后继续。 在此流程中交付的内容就是风险所在。

  • 敏感文档需要安全库:企业生成的PDF是其合同、发票和法律文件。 一些广泛复制的开源PDF工具如今已被遗弃,带有无人修补的公知安全漏洞,依赖它们的管道可能会泄漏它处理的文档。
  • 确定性的输出是浏览器比较值得信赖的原因:代理的输出在运行之间会有所不同,但底层渲染器不能,否则本指南中的循环就没有意义。 IronPDF固定了其Chromium引擎,因此同样的HTML在每次运行中都会渲染出相同的页面。
  • 合规格式是没有人原型的要求:SaveAsPdfA写入一个归档的PDF/A文件,而SaveAsPdfUA则编写屏幕阅读器可以导航的标记、可访问的PDF/UA。 免费渲染器很少提供任何一个。
  • 真正的包胜过猜测的:代理有时会安装仅仅听起来正确的包名称,这种技巧足够常见以致有了一个名字,叫做“错误占位”,攻击者注册这些名称并将其填入恶意软件。 在您的任务描述中指定一个已知的包名称可以避免这种风险。

指向Antigravity的IronPDF,代理的工作便缩小到其真正擅长的范围:编写模板、驾驶浏览器和验证结果。 父级指南涵盖了在开始之前需要交给每个代理的文档,并且相同的设置传输到Claude Code和ChatGPT Codex,仅需更改指令文件名。

代理返还了什么,您如何审核?

Antigravity代理的输出不是一份记录。 它生成工件:您审核的命名可交付物,如同审核一个文档。 它们以可预测的顺序到达,每个都回答有关PDF任务的不同问题。

在代码之前:任务列表

代理在写其他任何东西之前写一个结构化计划。 对于PDF工作,询问有用的问题是它打算触及哪一层。 当问题是跨页表格时,如果计划建议编辑渲染器,则已经走上了错误的道路,这是在最便宜的地方抓住的。

期间:实现计划

这是代理构建变更的地方:哪些文件、哪些方法、哪些渲染选项。 在写下一行之前,这里可以看到发明的API名称,这是比构建日志好得多的地方。

之后:指导步骤

在实现完成后撰写,总结变化并如何测试它。 对于文档任务,这意味着页面数、页眉和页脚,以您可以运行的检查来表达,而不是您必须信任的声明。

截图和浏览器录音堆积在一起,并且它们收集在辅助窗格中,而不是在聊天记录中滚动过去。 本指南的其余部分依赖于此:下面的两个任务后面跟随的是一个值得打开以确认工作确实发生的工件。

证据来自哪里?

浏览器控制是证明使用代理平台进行PDF工作的理由,而不是基于提示的助手。 IronPDF使用Chromium引擎渲染,Antigravity代理可驱动浏览器。 因此,比较的两方面是相同引擎渲染相同HTML,这使得比较有意义,而不是近似。

循环看起来像这样:代理在浏览器中打开模板,捕获所见内容,生成PDF,比较两者,调整CSS,重复直到匹配。

给予其一个要追踪的实际症状:

Templates/invoice.html renders correctly in a browser but the PDF output is
wrong: the line-item table splits a row across pages and the totals block
lands at the top of page 2 instead of under the table.

1. Open the template in the browser and capture a screenshot.
2. Run the renderer to produce invoice.pdf.
3. Compare the two and explain the difference before changing anything.
4. Fix it in the CSS using page-break properties. Do not change the C#.
5. Re-render, capture both again, and attach them as Artifacts.
Text

在该任务中的两个设计决策很重要。 在变更前请求解释,您可以评估的诊断信息而不是必须反向工程的修复。 将更改限制在CSS中,修复保持在应在的位置,因为分页行为是样式表的一部分,未受约束的代理通常会通过重构C#来“解决”它。

工件让审核变得可行。 渲染页面的截图和生成的PDF是直接证据; 书面声明版面现在匹配不算。 对于新入行的开发者来说,这也是建立直觉的最快方式,了解为什么浏览器和PDF输出会有所不同,因为差异变得直观而不是理论。

请注意: 查看截图。 如果代理从未真正打开过模板,它没有验证任何内容,截图是显示这些的地方。

关于布局问题的反馈是空间性的,这就是了解审核模型价值所在。 而不是在句子中描述哪个块是错误的,选择截图中的错误区域并直接评论,就像在文档中一样。 代理将该更正纳入工作中,而不会中止并重启运行。

即便不为其他用途,一个代理渲染页面、生成PDF并展示两者都比手动的构建、打开、眯眼、调整循环快。

为什么在浏览器中看起来正确而在PDF中出错?

该循环捕捉的大多数问题属于一小组原因,它们共同的症状是:文档看起来坏掉但没有抛出错误。 在任务中命名可疑原因可以省去代理一轮猜测。

症状为什么二者会不同在任务中写点这个
文本重排或溢出框布局计算时网页字体尚未加载完成,因此测量来自后备字体命名字体并请求确认它是嵌入而不是替代的
虽然浏览器显示了它们,图像缺失浏览器根据文件自身位置解析相对路径; 而渲染器解析它所获得的任意基础路径请求显式设置并在流程演练中命名基础路径
图表或表格显示为空内容是由渲染器捕获的尚未运行的JavaScript生成的请求代理确认渲染是否等待,并附上截图作为证据
表行跨越两页仅应用了屏幕CSS,而未应用打印CSS将修复限制在样式表中的分页属性

每一行都是同一标记的两次渲染之间的差异,这正是为什么上面的比较是找到它们的方法。

您如何设置Antigravity可以工作的项目?

您为代理提供了一个已经编译的项目。 如果代理需要猜测您意图使用哪个PDF库,或在开始实际任务前调试损坏的构建,它将在错误上浪费运行时间。

首先创建或打开项目并确认构建通过。 之后,设置任务本身值得委派,因为安装是版本不匹配的来源。

直接将设置任务交给代理:

Add the IronPDF NuGet package to this project. Then tell me which version was
installed and show me the PackageReference line. Configure the license key to
be read from configuration rather than hardcoded, and add the config file to
.gitignore if it isn't already. Don't change other package references.
Text

要求返回的版本信息就是一个可在每个后续任务描述中包含的事实。 要求.gitignore检查可以让保存密钥的配置文件不被放入代码库。

请注意: 查看终端日志。 它记录了解决的实际包版本,这是每个后续任务中值得粘贴的事实。

在存储库根目录提交工作空间指令文件,值得设置一次。 Antigravity读取AGENTS.md用于长期项目说明,与ChatGPT Codex 使用的是同一文件。 记录IronPDF是PDF库,生成的代码必须仅使用已记录的API,以及许可证密钥不能内联,意味着您可以停止在每个任务中重复这些约束。 一个任务为您编写其中内容:

Create AGENTS.md at the repository root with a PDF section stating that this
project uses IronPDF for all PDF generation, that you must read
https://ironpdf.com/llms.txt before writing PDF code and use only APIs
documented there, that ChromePdfRenderer is the HTML to PDF entry point, and
that no competing PDF package may be added.
Text

您如何委托PDF生成和迁移工作?

生成任务效果最佳在于您描述文档而不是代码,并让代理选择如何在HTML中呈现。

要求文档,而非实现:

Create Templates/invoice.html with plain HTML and inline CSS: a header with a
company name, a line-item table (description, quantity, unit price, total), and
a right-aligned totals block. No JavaScript.

Then write Services/InvoiceRenderer.cs with an async RenderAsync method that
loads the template, substitutes {{CompanyName}}, renders it with IronPDF, and
returns a byte array. A4 portrait, 20mm margins. Build and fix errors.
Text

迁移是受益最多的任务类型,因为它是机械化的、乏味的,并且容易接近正确。 关键动作是将分析与实现分开。

指向现有代码而不是描述它的代理:

Read Reports/LegacyReportBuilder.cs. It builds PDFs by positioning text at
coordinates with another library.

1. Summarize the current output: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Produce this as a plan Artifact. Do not write code yet.
Text

如果代理在您同意方法前编写四百行,它产生的四百行需要您仔细阅读。 计划工件是您可以用一句话更正的东西,而Antigravity的反馈机制意味着您可以对其进行标注而不丢弃运行。 一旦批准,后续任务就变得狭义:实施计划,保持现有的公开方法签名不变以便调用者不变,报告差异。

页眉和页脚是渲染器设置而不是模板标记,因此任务应说明这一点。 让代理链接它使用的文档页面是一个廉价的验证步骤:如果它不能为刚调用的API提供真实的页面,这是一个信号。 页眉和页脚指南在此作为参考,而分页指南涵盖相关布局控制。

何时应指派多个代理?

管理视图适用于不需要您监控的工作。 与其一次运行一个任务,不如派遣几个代理并在其完成时审阅其工件。

对于PDF迁移的现实拆分:一个代理将遗留报告生成器转换为IronPDF,而另一个围绕其将产生的输出编写测试套件。 第二个代理不需要第一个完成,因为测试是对文档而非实现的断言。

同时派遣两者:

Agent A: migrate Reports/LegacyReportBuilder.cs to IronPDF per the approved
plan. Keep the public method signature unchanged.

Agent B: write xUnit tests for the migrated output. Assert that the result is
non-empty, begins with the %PDF- signature, contains the substituted company
name in extracted text, and has the expected page count. Do not use
golden-file byte comparisons; rendering output is not byte-stable.
Text

排除逐字节比较避免了一整类不稳定测试。渲染输出在引擎版本和平台之间有所不同,因此断言应停留在提取文本、页数和元数据的层次。

请注意: 要检查的工件:两个演练。 代理B的测试只有在确认文档是代理A实际生成的情况下才有意义。

Antigravity的代理还将过去任务中的模式和解决方案保存到一个知识库中,以便在后来的任务中提供信息。 对于以特定方式复合的文档流程:针对发票的分页规则就是声明、装箱单和汇款通知单所需的相同规则,因此第二份文档通常比第一份成本更低。

如何调试Linux、Docker或Azure上的部署失败?

部署问题是终端访问值得其表现的地方,因为答案通常位于容器中而不是代码中。

直接给予代理失败案例:

Rendering works locally on Windows but fails in our Linux container with:

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Inspect the Dockerfile for missing native dependencies IronPDF's Chromium
engine needs on Debian-based images. Explain the cause, then propose the
Dockerfile change. Don't modify C# code unless the cause is there.
Text

不触动应用代码的指令很重要。 图像中丢失的共享库不是C#问题,给有自由的代理可能会添加隐藏而非修复失败的防御性try/catch块。 Docker部署指南记录了当前的依赖关系要求,这在发行版本间有所不同,应阅读而非回忆。

代理也可以单纯用作阅读器。 指向一个不熟悉的类,询问列出影响页面大小的渲染选项并显示项目当前设置的选项,API参考变成了您可以查询而不是滚动查看的东西。

在实际运行中这些提示生成了什么?

上述八个提示中有七个是按照顺序运行的,无需人工干预,在一次会话中完成。 使用的工具是Antigravity CLI 1.4.0,默认模型为Gemini 4 Argon (Medium)。 该项目是一个使用.NET 9的控制台应用程序,已经用PDFsharp构建了报告。下面的数据来源于对运行留下的文件的独立检查。

  • 在浏览器任务之前,发票的第09行跨越了第1页和第2页,合计在第2页的顶部。
  • 安装IronPdf 2026.10.3破坏了现有的构建,因为该包增加了便于全球使用的别名,使PdfDocument与PDFsharp产生歧义。
  • 代理通过在报告生成器中使用类型别名解决了该错误,项目构建时没有出现警告或错误。
  • 在浏览器任务中,代理使用无头Chrome捕获了模板,并在编辑任何内容之前渲染了PDF。
  • 修复仅更改了样式表,向表格行和总计块添加了避免中断的规则。
  • 渲染的发票然后保持了每行的完整性,第09行和总计在第2页上。
  • 设置任务添加了一个包含空许可证密钥的appsettings.json,并在.gitignore中列出了它。
  • 该空值优先于IRONPDF_LICENSE_KEY。 在文件存在的情况下,快速启动项目和发票作业都抛出了“需要生产许可证”。
  • AGENTS.md中包含了提示中的所有四条规则,代理在编写发票代码之前读取了llms.txt。
  • InvoiceRenderer返回了一个两页的A4 PDF,具有20毫米的边距,并替换了公司名称。
  • 迁移计划正确报告了Letter页面大小、每页32行和全部五种字体,并且没有更改文件。
  • 派遣提示启动了两个子代理,代理A和代理B,它们并行运行。
  • 迁移的生成器保持了其公共签名、两个Letter页面和五个原始字体。
  • 代理B的两个xUnit测试针对代理A的输出进行检查,验证PDF签名、提取文本和页数。
  • 有些步骤与页面中的运行不一样。 快速启动程序构建完成,但未运行,因此单独检查生成了其单页的hello.pdf。 运行在浏览器任务之前添加了发票模板和渲染作业,该页面假设已经存在。CLI没有暂停,因此关于拆分的解释仅在最终答复中,在CSS编辑之后给出。 CLI产生了截图,但没有浏览器录音。 发票任务编辑了现有的模板,而不是创建一个新的。 代理B将测试放置在控制台项目中。 Linux容器提示未运行,因为该机器没有Docker或WSL。

浏览器任务中的发票,在样式修正之前和之后,嵌入在下面。

代理在修复之前渲染的发票,第09行跨越了第1页和第2页。

修正后的同一发票,保持了每行的完整性,并且总计就在第09行的正下方。

此运行的工具、模型及持续时间列在运行记录中。

是什么让这种配对值得?

速度不如返回的内容重要。 代理在工作前交出计划,在工作后交出演练,截图显示渲染实际发生。 对于文档工作,干净的构建并不能告诉您布局是否正确,有可审查的证据是全然不同的。

这一系列的可再现测试,从头到尾运行并发布了结果,位于AI编码助手指南上。


故障排除


有问题吗?

如果您有任何问题,请联系support@ironsoftware.com

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

NuGet 下载量 22,198,312版本:2026.11刚刚发布