如何使用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是一個以代理為中心的開發平台,自主代理可計畫和執行在編輯器、終端和瀏覽器中的工作,然後將結果報告為可複查的交付作品。 Google將其描述為結合編輯器視圖與管理員界面,用於部署計劃、執行和驗證複雜任務的代理。

PDF工作的五個特性要點。

編輯器視圖是熟悉的IDE界面,附帶標籤完成和內聯命令。 當您需要精確控制游標並逐步查看每一次變更時,可以使用它來進行單個文件的近距離工作。

管理員界面為異步控制台。 可以生成代理、排隊任務、監視進度並在工作區中並行運行工作,而不是一次性等待一個對話。

瀏覽器控制讓代理能夠驅動瀏覽器以測試功能並確認結果。 對於IronPDF來說,這是標題功能,並在下面設立了自己的章節。

人工產物是代理生成的交付成果,如任務清單、實施計劃、操作步驟、截圖和瀏覽器記錄,而不是原始工具日誌。 Google的框架是這些讓您一目了然地驗證代理的邏輯,且您可以像評論文件一樣直接在人工產物上留下反饋,而無需中斷代理的運行。

模型可選性意味著代理可以由不同的底層模型驅動,並根據每個任務選擇不同的模型。

與聊天助手的實際區別在於您查看的內容。 聊天助手會生成您需要閱讀來評估的文本。 代理生成一個計畫、一個差異和一個實際渲染輸出的截圖。 對於PDF任務來說,文件的截圖作為證據比描述文件應該長什麼樣的段落更有意義。

這個驗證循環只能運作,因為比較的一方面是真實的。要求代理從頭開始構建一個文件流水線時,它很樂意即興發揮:選擇一個渲染程式庫,接著後續。 那條流水線中運送的是風險。

  • 敏感文件需要安全的程式庫: 商務生成的PDF是其合同、發票和法律文件。 當今有幾個廣為人知的開源 PDF 工具被廢棄,公認的安全漏洞無人修補,基於它們構建的管道可能會洩漏其處理的文件。
  • 確定性的輸出是為何瀏覽器比較具有可信度:代理的輸出在運行之間不同,但底層的渲染器不能或本指南中的循環將毫無意義。 IronPDF固定其Chromium引擎,因此每次運行相同的HTML會呈現相同的頁面。
  • 合規格式是沒人會預先製作原型的要求: SaveAsPdfA寫了一個存檔用的PDF/A檔案,而SaveAsPdfUA寫了標記的、可通過螢幕閱讀器瀏覽的PDF/UA。 免費的渲染器通常不提供任何一種。
  • 真正的套件優於猜測的套件:代理有時會安裝聽起來正確的套件名稱,一個足以讓人命名一種叫做“slopsquatting”的常見技巧,攻擊者會註冊這些名稱並用惡意軟體填充它們。 在您的任務描述中指定一個知名的套件名字可以防止這種事情發生。

將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)上運行。 該專案是一個已用PDFsharp生成報告的.NET 9控制台應用程式。以下數據來自對運行留下的文件的獨立檢查。

  • 在瀏覽器任務之前,發票的第09行拆分在第1和第2頁之間,第2頁頂部為總計數。
  • 安裝IronPdf 2026.10.3破壞了現有構建,因為該套件添加了一個全局使用,這使得PdfDocument和PDFsharp產生歧義。
  • 代理在報告生成器中以類型別名解析了該錯誤,並且項目建構沒有警告或錯誤。
  • 在瀏覽器任務中,代理用無頭模式的Chrome捕獲了模板並渲染出PDF,在此之前它未進行任何編輯。
  • 修正僅更改了樣式表,對表格行和總計塊添加了內部中斷規則。
  • 渲染的發票然後保持每行完整,第09行和總計在一起於第2頁上。
  • 設置任務添加了一個appsettings.json,內含空的授權金鑰,並把它列入.gitignore中。
  • 該空值優先於IRONPDF_LICENSE_KEY。 文件現有,Quickstart程式和發票作業都拋出“需要生產授權”。
  • AGENTS.md包含了提示的所有四個規則,代理在寫發票代碼之前讀取了llms.txt。
  • InvoiceRenderer返回了一個有20毫米邊距並替換公司名稱的兩頁A4 PDF。
  • 遷移計劃正確回報了信件頁面大小、每頁32行和所有五種字體,並且未更改任何文件。
  • 調度提示啟動了兩個子代理,代理A和代理B,它們並行運行。
  • 遷移的生成器保持其公共簽名、兩個信件頁面和五種原始字體。
  • 代理B的兩個xUnit測試對照代理A的輸出進行了檢查,包括檢查PDF簽名、提取的文本和頁數。
  • 一些步驟與頁面上運行的不同。 Quickstart程式已建構但未運行,因而一個單獨的檢查生成了它的單頁hello.pdf。 運行在瀏覽器任務之前添加了發票模板和渲染工作,頁面假設已經存在。CLI迭代並未暫停,因為只有在最終回應中,CSS編輯之後,才給出分割的解釋。 CLI生成了螢幕截圖,但沒有瀏覽器錄影。 發票任務編輯市場已有模板,而不是創建新模板。 代理B將測試放置在控制台項目中。 Linux容器提示未運行,因為此機器無Docker或WSL。

下面嵌入了來自瀏覽器任務的發票,樣式表修正之前和之後的樣子。

代理在修正之前渲染的發票,第09行在第1和第2頁之間掐開。

修正之後的相同發票,保持每行完整,總計正好在第09行下方。

這次運行的工具、模型和持續時間列在運行記錄中。

什麼讓這種搭配值得?

速度不及回傳的內容重要。 代理在工作之前交出計劃,工作完成後交出過程指導,並顯示渲染實際發生的螢幕截圖。 對於文件工作,一個乾淨的構建告訴您佈局是否正確,審核證據是整個差別。

此系列背後的可重現測試被完整運行並具发表的結果,存在於AI編碼助手指南。


疑難排解


問題?

如果您有任何疑問,請聯繫support@ironsoftware.com

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布