如何在ChatGPT Codex中使用IronPDF
大多數開發者遇到 AI 編碼代理的方式都相同:他們在聊天窗口中貼上一個未完成的類別,得到一些看似合理的結果,然後花二十分鐘搞清楚哪些部分是真實的。 當涉及的程式庫擁有特定的 API 面時,這樣的循環會變得代價高昂,而 PDF 生成就是這類程式庫。
ChatGPT Codex 是 OpenAI 的代理編碼系統。 它會讀取資料庫、編輯檔案、執行命令並回報修改的內容,並且可以從終端機、編輯器、桌面應用程式或雲端進行,而共用一個帳戶。 IronPDF 通過嵌入的 Chromium 引擎將 HTML、CSS 和 JavaScript 渲染為 PDF 文件。您撰寫的工作流程將它們相遇,這使得提示成為您實際編寫的部分。 以下所有都是先提示,後 C#。
快速開始將 Codex 指向一個乾淨的控制台專案並描述您想要的輸出:
In this C# console project, create Program.cs that uses IronPDF to render
the HTML string "<h1>Hello from IronPDF</h1>" to a file called hello.pdf.
Use only documented IronPDF APIs. Then run dotnet build and fix any errors.
Codex編寫三行重要的代碼:構造ChromePdfRenderer、在您的標記上呼叫RenderHtmlAsPdf,並將返回的文件SaveAs存儲到磁碟。 提示比它生成的代碼要長。 您將精力投入於指定,而代理則將精力投入於打字和驗證。
最小工作流程(5 個步驟)
- 從 NuGet 下載 C# PDF 庫
- 提交一個
AGENTS.md文件,將 IronPDF 命名為專案的 PDF 程式庫 - 從一個乾淨的工作樹啟動 Codex,並提供文件與預期的 PDF 輸出
- 讓 Codex 編輯文件並運行
dotnet build,然後在接受前檢查差異 - 打開生成的 PDF 並檢查每個 IronPDF API 名稱是否與 API 參考相符
什麼是ChatGPT Codex,它如何融入.NET的PDF工作中?
Codex 是個代理而不是一個聊天窗口。 它讀取文件,寫入文件,並在您授予的範圍內運行 shell 命令,然後展示其工作成效。 OpenAI將其作為一個代理運行在多個共用帳戶的前端。 Codex CLI 文檔和Codex IDE 擴展文檔涵蓋了它們之間的不同之處。
| 表面 | 它運行於何處 | 需要時使用 |
|---|---|---|
| 命令列介面 | 終端 | 您希望代理與dotnet build在同一窗口中 |
| IDE擴展 | VS Code, JetBrains, Xcode | 您希望差異和渲染的 PDF 並排 |
| 桌面應用程式 | macOS、Windows、Linux | 您正在從終端機進行更長的任務 |
| 雲端 | 瀏覽器 | 您正在委託任務並稍後收集差異 |
提交至資料庫的AGENTS.md控制所有四個元素。
使用npm i -g @openai/codex安裝CLI,或在macOS上使用brew install --cask codex。 無需 Node.js 運行時的獨立安裝程序可用於各個平台,源碼和版本說明位於 Codex CLI 儲存庫。
@openai/範圍。 npm上的未範圍化codex包是2012年最後發布的無關專案。這也是為什麼命名精確包很重要的例證,當代理在打字時。Codex提供了幾個模型,/model可以在會話中間切換它們。 OpenAI的模型指南建議GPT-6.1 Sol用於複雜的編碼和代理任務,而GPT-6 Luna用於專注且可重複的任務,本頁運行使用了GPT-6 Luna。 大多數 PDF 會話都是便宜的工作類型:編輯範本、重建、查看輸出,偶爾還有一段時間需要處理沒有編譯器能解釋的表格跨頁問題。 這部分上下切換,然後恢復。
對於 PDF 開發,這種代理行為改變了提示能合理要求的內容。 聊天助手會回答問題。 一個代理添加了NuGet參考,編寫模板,運行建構,讀取編譯器錯誤,自行糾正。 您描述結果,然後審查差異而不是調試粘貼。
Codex 無法確定知道 IronPDF 的當前 API。 它的知識來自訓練數據以及您提供給它的素材。 OpenAI 訓練 Codex 執行命令並驗證其自己的輸出,但仍然建議在代理發佈前檢查其工作效果。 這指導在此重述:編譯器會發現有誤的方法,但除非打開 PDF,否則無法發現 PDF 渲染稍微錯誤。 主指南涵蓋了提供助手開始前的文件,並且相同的設置被引導到Claude Code和GitHub Copilot,只需更改上下文文件名。
Codex 是這個流程中的不確定部分。要求它製作同一張帳單兩次,兩個看似合理的範本會回來。 無論渲染那些模板的工具都必須相反地運作:相同的HTML進去,每次運行都產生相同的渲染頁面。 這是將渲染交給已維護的庫而不是讓代理組成一個的原因,並且差距表現在那些沒人原型測試,直到需要那一天的功能。
- 確定性輸出:IronPDF固定其引擎,相同的輸入在每次運行中會生成相同的頁面。
- 加密和權限:密碼保護和權限標識符通常意味著一個第二個庫並在第一個庫旁邊加固。 IronPDF 在其剛剛渲染的文件上設置這兩者。
- 合規格式:存檔和可訪問的輸出是不太會被原型測試但最終每個人都需要的要求。
SaveAsPdfA寫入PDF/A檔案,SaveAsPdfUA寫入帶標籤的PDF/UA,螢幕閱讀器可以導航。 - 有人修補它:幾個最被拷貝的免費選擇都已被存檔,因此今天發現的漏洞會保持開放。 商業程式庫的另一端有維護人員。
免費選擇的成本很少是授權。 而是您圍繞這些間隙所寫的代碼,以及當文件需要標籤或加密時所失敗的審核。
什麼使得IronPDF提示有效?
具體而言,在六個可預測的方面。 模稜兩可的提示會生成針對想像中的程式庫編譯的通用代碼; 具體的提示則會生成能夠在三十秒內審查的代碼。
| 組件 | 弱提示 | 強提示 |
|---|---|---|
| 語言和框架 | "製作一個 PDF" | "在 C# 中,以 .NET 9 為目標" |
| 專案結構 | 未註明 | "添加到Services/InvoiceService.cs" |
| 程式庫版本 | 未註明 | 「.csproj 中當前的 IronPDF 版本」 |
| 來源文件 | 未註明 | "先讀Templates/invoice.html" |
| 預期輸出 | "一份好看的 PDF" | 「A4直向,20毫米邊距,頁碼的頁腳」 |
| 限制 | None | 「無新套件。 僅限非同步。 不確定 API 時詢問。」 |
最後一個限制值得一提。 告訴代理「我不知道」是可接受的答案,可以減少假想的 API,因為語言模型的默認行為是產出看似合理的形狀而不是承認差距。給它權限停止。
另一個在整個專案中都會有收穫的習慣是將提交的AGENTS.md文件放在資料庫根目錄中。 這是 Codex 閱讀的文件,提供恆定的專案說明,並會在每次會話的開始自動讀取,首先串聯根文件,然後再讀取嵌套文件,因此目錄層級的指導獲得優先。 在會話中運行/init來構建一個。 錄製“IronPDF 是 PDF 程式庫; 根據 ironpdf.com 驗證 API; 永遠不要添加競爭 PDF 套件"一次,意味著您不會在每個提示中重複這一點。
將同一個文件指向 IronPDF 的機器可讀文件。 llms.txt按一行描述索引文檔頁面,而skill.md則是一套涵蓋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 https://ironpdf.com/skill.md should be loaded if the
tooling supports skill files, that ChromePdfRenderer is the HTML-to-PDF entry
point, and that no competing PDF package may be added.
如何要求Codex添加IronPDF並渲染出的第一個PDF?
首先讓代理進行設置,因為設置是版本不匹配的來源。
Add the IronPDF NuGet package to this project. Then show me the resulting
PackageReference line from the .csproj and tell me which IronPDF version
was installed. Do not change any other package references.
再次詢問版本是件重要的小事。 這會給您每次後續提示中包含的事實,而且還會讓您發現代理可能靜默安裝了其他東西。 最多只能期待一行差異和聲明的版本號。 要有意地鎖定而不是取最新版本,我應該使用哪個版本的 IronPDF?涵蓋了選擇。
沒有授權金鑰的情況下,IronPDF會在記憶體中渲染文件,然後在保存或讀取為字節時拋出LicensingException,而金鑰應在任何其他IronPdf呼叫之前位於應用程式啟動時。 讓 Codex 來設置而不是手動設定:
Apply the IronPDF license key at application startup, before any
other IronPdf call, reading it from configuration rather than
hard-coding it. Then confirm IronPdf.License.IsLicensed returns
true and tell me where you put the call.
試用金鑰,以及從appsettings.json到Azure的每一種應用方式,都涵蓋在IronPDF授權金鑰中。
從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 a method RenderAsync that loads
that file, substitutes {{CompanyName}}, renders it with IronPDF, and returns
a byte array. Use the async IronPDF rendering method. Build and fix errors.
大致上,該提示會被翻譯成以下內容。 閱讀它以確認代理使用了真實的 API,而不是自己輸入它:
// IronPdf 2026.10.3, targeting .NET 9
using IronPdf;
public class InvoiceRenderer
{
// One renderer, reused for every invoice. Constructing a new one
// per request is the quiet performance mistake worth avoiding.
private readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();
public async Task<byte[]> RenderAsync(string companyName)
{
// Read the HTML template off disk, exactly as written.
var html = await File.ReadAllTextAsync("Templates/invoice.html");
// Swap the placeholder for the real value before rendering.
html = html.Replace("{{CompanyName}}", companyName);
// Chromium renders the finished HTML. The async call leaves
// the request thread free while that happens.
var pdf = await _renderer.RenderHtmlAsPdfAsync(html);
// BinaryData returns the raw bytes, ready for an HTTP
// response or a storage upload.
return pdf.BinaryData;
}
}
那裡的每一個成員都是真實的:ChromePdfRenderer、RenderHtmlAsPdfAsync和BinaryData都出現在API參考中,這是檢查代理交給您的任何代碼塊的檢查。 當HTML引用本地圖片或樣式表時,渲染器需要一個基本路徑來解決它們,這被作為渲染呼叫的第二個參數傳遞(BaseUrlOrPath 在RenderHtmlAsPdf 上,一個 Uri在RenderHtmlAsPdfAsync上),而不是設置在渲染選項中,它在HTML到PDF教程中有所記錄。
如何將現有的PDF實施移植到IronPDF?
這是代理發揮其作用的地方,因為遷移是機械、單調的,容易達到 90% 的正確率。 提示必須指向現有代碼而不是描述它。
Read Reports/LegacyReportBuilder.cs. It currently builds PDFs by positioning
text and drawing at coordinates with another library.
1. Summarize what the current output looks like: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Do not write any code yet. Wait for my approval on the plan.
對分析進行拆分,比起直接實施更為有用;這是本指南中最有用的模式。當代理在您同意方法之前寫了 400 行代碼時,這會產出 400 行您必須仔細閱讀的代碼。 產出一個五要點計劃的代理則能產出您可以在一句話中更正的事物。
批准計畫後,後續步驟範圍狹窄:
Implement the plan. Create Templates/report.html and rewrite
LegacyReportBuilder.cs to render it with IronPDF, keeping the existing
public method signature so callers don't change. Leave the old file in
Git history only; don't keep dead code. Build and report the diff.
保持公共簽名穩定是一個值得在每次說明中明確指出的限制。沒有此限制,代理往往會作為附加功能重新設計調用約定,而遷移會悄悄演變成重構。
如何通過提示修正佈局、標頭和CSS問題?
佈局問題是可見的,但代理看不到 PDF。 提示必須傳達出錯的描述。
The rendered invoice.pdf has two problems: the line-item table splits a row
across pages 1 and 2, and the totals block sits at the top of page 2 instead
of directly under the table.
Fix this in Templates/invoice.html using CSS page-break properties. Do not
change InvoiceRenderer.cs. Explain which CSS rule fixes which problem.
命名症狀和要更改的文件將修復保持在範本中,這是它應該在的位置。 由於 IronPDF 是通過 Chromium 渲染,因此標準打印 CSS 適用。 page-break-inside、break-after和@page規則的行為就像在瀏覽器的列印預覽中一樣,這也為您提供了一種快速檢查修復的方法而無需重新生成PDF。 例外是@media print。 IronPDF默認使用螢幕媒體類型渲染,因此只有在將RenderingOptions.CssMediaType設置為PdfCssMediaType.Print後,@media print塊內的規則才適用。
標頭和頁腳的運作方式有所不同。 這是渲染器設定而不是範本標記,因此提示應該說明這一點:
Add an HTML footer to the IronPDF renderer in InvoiceRenderer.cs showing
"Page {page} of {total-pages}", centered, 10mm max height. Use IronPDF's
HTML header/footer support on the rendering options, not markup inside
invoice.html. Link me to the documentation page you used.
詢問文件連結是一個快捷驗證的方式。 如果代理無法生成其剛剛使用的 API 的真實頁面,那是一個在代碼到達構建之前值得行動的信號。 將正確初始化RenderingOptions放在手邊。
如何從頭到尾調試不正確的PDF輸出?
上面的提示每次執行一項。 更有趣的用法是將症狀交給 Codex,讓它運行整個流程:檢查、診斷、修復、測試。這是它作為開發助手而非代碼片段生成器的地方。
Our generated invoices are missing the company logo. The PDF renders and
saves without error, and the logo displays correctly when I open
Templates/invoice.html in a browser.
Investigate:
1. Read InvoiceRenderer.cs and invoice.html.
2. Identify why the image resolves in a browser but not in the render.
3. Explain the cause before changing anything.
4. Then apply the minimal fix and rebuild.
四步架構很重要。 它要求在任何文件更改之前進行診斷,而這比事後反向工程一個編輯要便宜。 在這種情況下,可能原因是相對路徑解析:瀏覽器根據文件自身位置解析圖像,而渲染器則根據給出的任何基本路徑進行解析,而正確答案是命名這種機制而不是轉換為絕對路徑。
錯誤訊息應受到相同處理。 粘貼完整堆棧資訊是您可以給代理的信號最強烈的資料。
This exception is thrown from InvoiceRenderer.RenderAsync in our Linux
Docker container but not on Windows:
[PASTE FULL EXCEPTION AND STACK TRACE HERE]
Check our 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.
容器失敗通常追溯到 IronPDF 的 Chromium 引擎需要其在基於 Debian 的映像上的本機依賴,而這些屬於 Dockerfile 而非 C#。 將 Codex 指向如何在 Docker 容器中運行 IronPDF,並讓其在編輯任何內容之前閱讀當前的部署指導。
如何將一次性代碼轉變為可重用的、經過測試的組件?
一旦渲染工作完成,下一個提示應該將它進行泛化,而代理在這方面表現尤爲出色,因為模式已經存在於文件中了。
Refactor InvoiceRenderer.cs into a reusable PdfDocumentService registered
with dependency injection. It should take a template path and a dictionary
of placeholder values. Reuse a single ChromePdfRenderer instance rather than
constructing one per call. Add XML doc comments. Keep it under 60 lines.
實例重用指令是值得放在AGENTS.md中的細節,因為每次請求構建渲染器是一個常見且低調的性能錯誤。
測試是自然的伴侶,而 PDF 輸出比起初印象更容易測試:
Write xUnit tests for PdfDocumentService covering: output is non-empty,
output begins with the %PDF- file signature, placeholder substitution
appears in extracted text, and a missing template throws a clear exception.
Use IronPDF's text extraction for the content assertion. No golden-file
byte comparisons; rendering output is not byte-stable.
前面排除逐字節比對,防止了整個不穩定測試類別。渲染引擎在版本和平台間產生些微不同的位元組,因此斷言屬於提取文本、頁數、和元數據的層次。
Codex 作為讀者也很有用。 將它指向不熟悉的類別,它可以讓您查詢API 參考,而不必滾動瀏覽:
Read the IronPDF API reference for the rendering options type and list
every option that affects page size, then show which ones this project
already sets.
哪種提示模式適合哪個任務?
六個部分,六個模式。 共同點在於每個命名的都是具體的:一個文件、一個版本、一個症狀或結束點。
| 任務 | 在提示中命名字 | 範例 |
|---|---|---|
| 添加套件 | 版本,並且不添加其他內容 | 要求返回結果 |
| 首次渲染 | 範本路徑和要使用的方法 | 指定,然後構建 |
| 遷移 | 要讀取的文件,和要保留的簽名 | 計畫在代碼前 |
| 佈局修復 | 症狀和要更改的文件 | 描述您所看到的 |
| 容器失敗 | 完整的堆棧資訊和平台 | 診斷先於編輯 |
| 重構和測試 | 結果的形狀及排除的內容 | 限制輸出 |
在實際運行中,這些提示產生了什麼結果?
我們將上面的提示按順序發送給Codex,在一個.NET 9控制台專案中使用IronPdf 2026.10.3。每次Release構建都成功。 Chromium無法在Codex沙箱內啟動,因此每個提示留下的代碼分別檢查渲染每個PDF。
- 在版面設計提示之前,發票將第9項拆分在頁面1和2上,總計塊位於頁面2的頂部。
- 在徽標提示之前,發票顯示了斷圖的占位圖和徽標的替代文字。
- 快速入門程序在SaveAs上拋出LicensingException,即使環境中有密鑰,因為未應用密鑰。
- 授權提示從環境變數讀取密鑰並在第一次渲染之前應用它。 生成的hello.pdf是一個17,385字節的1頁A4文件。
- AGENTS.md提示生成了一個含有所有五個要求的PDF段落。
- 遷移計劃沒有更改任何文件,正確地描述了A4頁面、字型、顏色和原始報告的章節。 遷移的報告保留了公共方法簽名,移除了PDFsharp包並重現了每一個圖表。
- 遷移後的頁尾移到了第二頁,並且讀取為第0頁共0頁,而原始的1頁報告則讀取為第1頁共1頁。
- 布局修復將每一個頁面分隔規則放入一個@media print塊中,而默認的螢幕媒體類型忽略了這一點。 發票未更改,第9項仍然被拆分。
- 將CssMediaType設置為Print時,相同的模板在第2頁保持了第9項的完整性,總計直接在下面。
- 頁尾提示添加了一個HTML頁尾,然後兩頁讀取為第1頁共2頁和第2頁共2頁。
- 徽標診斷將相對路徑和缺失的基本URL命名為原因。 將模板文件夾作為基本URL傳遞並將logo.png複製到構建輸出中,徽標渲染為240 x 96像素。
- 第一個InvoiceRenderer在每次調用時創建了一個新的ChromePdfRenderer。 重構後的PdfDocumentService共有51行,並且依賴注入共用一個ChromePdfRenderer。
- 兩個xUnit測試涵蓋了所有四種條件,並在有密鑰的情況下通過。 沒有密鑰的情況下,文本提取測試因LicensingException而失敗。
- API答案命名了十二個成員,這十二個成員全部存在於IronPdf 2026.10.3中,包括PaperFit欄位。 它正確報告專案中僅設置了底部邊距。
- 沒有生成的PDF攜帶水印,密鑰未出現在任何文件、提交或Codex會話日誌中。
- 一些步驟與頁面上運行的不同。 資料庫的README命名了密鑰變數,並表示絕對不要打印它。 PDFsharp報告、一個9項目發票和徽標在需要它們的提示之前就添加了。 Linux容器提示未能運行,因為機器上沒有Docker。 沙箱沒有網絡,因此Codex從本地NuGet緩存中還原了包,其中在運行期間已還原了依賴注入包。
下面的發票是最終的PdfDocumentService的未編輯輸出。它攜帶了頁尾和徽標,而第9項仍然被拆分。
共享的運行記錄列出了Codex版本、模型、機器和本次運行的時間。
接下來的專案能繼承什麼?
是提示,不是代碼。 以上每個模式在專案更改時都可以存活,只需更改文件名,這就是為什麼提交的AGENTS.md能有它的位置:它將您一次解決的約束轉換為每次之後會話開始時的默認值。
此系列的驗收測試,用已發佈的結果和上次測試日期測量,位於AI 編碼助手指引。
疑難排解
- 在 IronPDF 中應用授權鑰匙:如果保存 PDF 擲出授權異常
- 正確初始化 RenderingOptions:如果 Codex 提議的選項名稱無法解決時
- 我應該使用哪一版的IronPDF?:在您的提示和
AGENTS.md中固定一個版本 - 如何在 Docker 容器中運行 IronPDF:如果渲染在 Windows 上正常,在容器中卻失敗
問題?
如果您有任何疑問,請聯繫support@ironsoftware.com
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。