如何在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” |
| 库版本 | 未说明 | “IronPDF当前在.csproj中的版本” |
| 源文件 | 未说明 | “先阅读Templates/invoice.html” |
| 预期输出 | “一个不错的PDF” | “A4竖版,20mm边距,带页码的页脚” |
| 约束条件 | 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默认以屏幕媒体类型渲染,因此@media print块内的规则仅在RenderingOptions.CssMediaType被设置为PdfCssMediaType.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, 在一个包含IronPdf 2026.10.3的.NET 9控制台项目中,一次会话中。所有Release构建都成功。 由于Codex沙盒内无法启动Chromium,因此进行了单独检查,从每个提示后留下的代码中渲染每个PDF。
- 在布局提示之前,发票将项目9拆分在第1页和第2页之间,其中总计块在第2页顶部。
- 在徽标提示之前,发票显示了一个破损的图像占位符,替代了徽标。
- 即便密钥在环境中,Quickstart程序在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复制到构建输出中,徽标以240x96像素渲染。
- 第一个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。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。