Wie Sie IronPDF mit ChatGPT Codex verwenden
Die meisten Entwickler lernen einen KI-Coding-Agenten auf dieselbe Weise kennen: Sie fügen eine halb fertige Klasse in ein Chat-Fenster ein, erhalten etwas Plausibles zurück und verbringen die nächsten zwanzig Minuten damit, herauszufinden, welche Teile echt sind. Diese Schleife wird schnell teuer, wenn die beteiligte Bibliothek eine spezifische API-Oberfläche hat, und die PDF-Erstellung ist eine solche Bibliothek.
ChatGPT Codex ist das agentbasierte Codierungssystem von OpenAI. Es liest ein Repository aus, bearbeitet Dateien, führt Befehle aus und berichtet darüber, was es verändert hat, und das tut es von einem Terminal, einem Editor, einer Desktop-App oder aus der Cloud, während es ein Konto teilt. IronPDF rendert HTML, CSS und JavaScript in PDF-Dokumente mittels einer eingebetteten Chromium-Engine. Die beiden treffen sich durch einen Workflow, den Sie schreiben, was den Prompt zum Teil macht, den Sie tatsächlich erstellen. Alles unten ist zuerst ein Prompt und dann C#.
SchnellstartRichten Sie Codex auf ein sauberes Konsolenprojekt und beschreiben Sie das gewünschte Ergebnis:
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 schreibt die drei Zeilen, die zählen: erstellen Sie ein ChromePdfRenderer, rufen Sie RenderHtmlAsPdf in Ihrem Markup auf und speichern Sie das zurückgegebene Dokument auf der Festplatte mit SaveAs. Der Prompt ist länger als der Code, den er erzeugt. Sie verwenden Ihre Mühe, um zu spezifizieren, und der Agent verwendet seine Mühe, um zu tippen und zu überprüfen.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# PDF-Bibliothek von NuGet herunter
- Verpflichten Sie sich zu einer
AGENTS.md, die IronPDF als die PDF-Bibliothek des Projekts benennt. - Starten Sie Codex von einem sauberen Arbeitsbaum aus und geben Sie die Dateien und die erwartete PDF-Ausgabe vor.
- Lassen Sie Codex Dateien bearbeiten und
dotnet buildausführen, dann überprüfen Sie die Differenz, bevor Sie akzeptieren. - Öffnen Sie die generierte PDF und überprüfen Sie jeden IronPDF-API-Namen anhand der API Referenz.
Was ist ChatGPT Codex und wie passt es zu .NET PDF-Arbeiten?
Codex ist ein Agent und kein Chat-Fenster. Es liest Dateien, schreibt Dateien und führt Shell-Befehle aus innerhalb eines Bereichs, den Sie ihm gewähren, und zeigt dann seine Arbeit. OpenAI liefert es als einen Agenten hinter mehreren Vordertüren, die ein Konto teilen. Die Codex CLI-Dokumentation und die Codex IDE Erweiterungsdokumentation decken die Unterschiede zwischen ihnen ab.
| Oberfläche | Wo es läuft | Greifen Sie zu, wenn |
|---|---|---|
| CLI | Terminal | Sie möchten den Agenten im gleichen Fenster wie dotnet build haben |
| IDE-Erweiterung | VS Code, JetBrains, Xcode | Sie möchten die Diff und das gerenderte PDF nebeneinander haben |
| Desktop-App | macOS, Windows, Linux | Sie führen eine längere Aufgabe aus dem Terminal |
| Cloud | Browser | Sie delegieren eine Aufgabe und sammeln später die Differenz |
Ein AGENTS.md, das im Repository festgeschrieben ist, regelt alle vier.
Installieren Sie die CLI mit npm i -g @openai/codex oder brew install --cask codex auf macOS. Unabhängige Installer, die keine Node.js-Laufzeit benötigen, sind für jede Plattform verfügbar, und Quell- und Release-Notizen befinden sich im Codex CLI-Repository.
@openai/-Bereich bei dieser Installation bei. Das ungezielte codex-Paket auf npm ist ein nicht verwandtes Projekt, das zuletzt 2012 veröffentlicht wurde. Es ist auch eine gute Veranschaulichung dafür, warum die genaue Benennung von Paketen wichtig ist, wenn ein Agent den Text eingibt.Codex bietet mehrere Modelle, und /model wechselt während der Sitzung zwischen ihnen. OpenAI's Modellführer empfiehlt GPT-6.1 Sol für komplexe Codierung und agentische Arbeit und GPT-6 Luna für fokussierte, wiederholbare Aufgaben, und der Lauf auf dieser Seite verwendete GPT-6 Luna. Der Großteil einer PDF-Sitzung ist die preiswerte Art von Arbeit, ein Template zu bearbeiten, neu zu erstellen, die Ausgabe erneut anzusehen, manchmal mit einer Periode, in der eine Tabelle aus Gründen, die kein Compiler jemals erklären wird, über eine Seite bricht. Wechseln Sie für diesen Teil hoch und danach wieder runter.
Für die PDF-Entwicklung ändert dieses agentische Verhalten, was ein Prompt vernünftigerweise anfordern kann. Ein Chat-Assistent beantwortet eine Frage. Ein Agent fügt die NuGet-Referenz hinzu, schreibt die Vorlage, führt den Build aus, liest den Compilerfehler und korrigiert sich. Sie beschreiben das Ergebnis, überprüfen dann eine Differenz anstatt ein Einfügen zu debuggen.
Was Codex nicht tun kann, ist die aktuelle API von IronPDF mit Sicherheit zu kennen. Sein Wissen stammt aus den Trainingsdaten plus dem, was Sie ihm voranstellen. OpenAI trainiert Codex darauf, Befehle auszuführen und seine eigene Ausgabe zu verifizieren, und sagt Ihnen trotzdem, die Arbeit des Agenten zu überprüfen, bevor sie ausgeliefert wird. Diese Anleitung gilt hier doppelt: Ein Compiler fängt eine erfundene Methode ab, aber nichts fängt eine leicht falsch gerenderte PDF-Datei ab, außer sie zu öffnen. Der übergeordnete Leitfaden enthält die Dokumentation, um jedem Assistenten vor dem Start in die Hand zu geben, und dasselbe Setup wird auf Claude Code und GitHub Copilot übertragen, nur mit der Änderung des Kontextdateinamens.
Codex ist die nicht-deterministische Hälfte dieser Pipeline. Bitten Sie es um dieselbe Rechnung zweimal, und zwei plausible Templates kommen zurück. Alles, was diese Vorlagen rendert, muss umgekehrt funktionieren: identisches HTML rein, die gleichen gerenderten Seiten raus, bei jedem Lauf. Das ist der Fall, wenn man das Rendering einer gewarteten Bibliothek überlässt, anstatt einen Agenten einen zusammenbauen zu lassen, und die Lücke zeigt sich in den Funktionen, die niemand prototypisiert, bis sie benötigt werden.
- Deterministische Ausgabe: IronPDF fixiert seine Engine, und das gleiche Eingabematerial rendert bei jedem Lauf die gleichen Seiten.
- Verschlüsselung und Berechtigungen: Passwortschutz und Berechtigungsflags bedeuten normalerweise eine zweite Bibliothek neben der ersten. IronPDF setzt beides auf das Dokument, das es gerade gerendert hat.
- Compliance-Formate: archivierte und zugängliche Ausgaben sind die Anforderungen, die niemand prototypisiert und die schließlich jeder benötigt.
SaveAsPdfAschreibt eine PDF/A-Datei, undSaveAsPdfUAschreibt das getaggte PDF/UA, das ein Bildschirmleser navigieren kann. - Irgendjemand, der es patcht: mehrere der am häufigsten kopierten freien Optionen sind archiviert, sodass eine heute gefundene Sicherheitslücke offen bleibt. Eine kommerzielle Bibliothek hat einen Wartungsdienst auf der anderen Seite.
Die Kosten der kostenlosen Option sind selten die Lizenz. Es ist der Code, den Sie um diese Lücken herum schreiben, und das Audit, das Sie nicht bestehen, wenn ein Dokument getaggt oder verschlüsselt werden muss.
Was macht einen IronPDF-Prompt effektiv?
Spezifität, in sechs vorhersehbaren Dimensionen. Ein vager Prompt erzeugt generischen Code, der gegen eine imaginäre Bibliothek kompiliert; ein spezifischer Prompt erzeugt Code, den Sie in dreißig Sekunden überprüfen können.
| Komponente | Schwacher Prompt | Starker Prompt |
|---|---|---|
| Sprache und Framework | "Ein PDF erstellen" | "In C# mit Ziel auf .NET 9" |
| Projektstruktur | Nicht angegeben | "Zu Services/InvoiceService.cs hinzufügen" |
| Bibliotheksversion | Nicht angegeben | "IronPDF-Version, die derzeit im .csproj ist" |
| Quelldateien | Nicht angegeben | "Templates/invoice.html zuerst lesen" |
| Erwartete Ausgabe | "Ein schönes PDF" | "A4 Hochformat, 20mm Ränder, Fußzeile mit Seitenzahlen" |
| Einschränkungen | None | "Keine neuen Pakete. Nur async. Fragen, wenn Sie sich bei einer API unsicher sind." |
Die letzte Einschränkung verdient eine eigene Anmerkung. Einem Agenten zu sagen, dass "Ich weiß nicht" eine akzeptable Antwort ist, reduziert erfundene APIs, weil ein Sprachmodell standardmäßig etwas Plausibles erzeugt, anstatt eine Lücke zuzugeben. Geben Sie ihm die Erlaubnis, aufzuhören.
Eine zweite Gewohnheit, die sich im gesamten Projekt auszahlt, ist eine festgeschriebene AGENTS.md-Datei im Stammverzeichnis des Repositories. Das ist die Datei, die Codex für laufende Projektanweisungen liest, und es liest sie automatisch zu Beginn jeder Sitzung, indem es erst die Root-Datei und dann verschachtelte Dateien zusammenfügt, sodass die Anleitung auf Verzeichnisebene gewinnt. Führen Sie /init in einer Sitzung aus, um eine Grundstruktur zu erstellen. "IronPDF ist die PDF-Bibliothek; überprüfen Sie die APIs gegen ironpdf.com; nie ein konkurrierendes PDF-Paket hinzufügen" einmal bedeutet, dass Sie es nicht in jedem Prompt wiederholen müssen.
Verweisen Sie dieselbe Datei auf die maschinenlesbare Dokumentation von IronPDF. llms.txt indiziert Dokumentationsseiten mit einer einzeiligen Beschreibung, und skill.md ist ein Einsatzset, das API-Konventionen und gängige Muster abdeckt. Ein einziger Prompt schreibt beide in das Projekt:
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.
Wie bitten Sie Codex, IronPDF hinzuzufügen und ein erstes PDF zu rendern?
Beginnen Sie damit, dass der Agent das Setup übernimmt, da Diskrepanzen in der Version hier ihren Ursprung haben.
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.
Nach der Version zu fragen ist der kleine Schritt, der zählt. Es gibt Ihnen eine Tatsache, die in jedem späteren Prompt enthalten ist, und es zeigt den Fall, in dem der Agent heimlich etwas anderes installiert hat. Erwarten Sie maximal einen einzeiligen Unterschied und eine angegebene Versionsnummer. Um bewusst zu fixieren, anstatt die neueste zu nehmen, behandelt Welche Version von IronPDF soll ich verwenden? die Auswahl.
Ohne Lizenzschlüssel rendert IronPDF das Dokument im Speicher und wirft dann eine LicensingException, wenn es gespeichert wird oder als Bytes gelesen wird, und der Schlüssel gehört zum Anwendungsstart vor jedem anderen IronPdf-Aufruf. Lassen Sie Codex ihn platzieren, anstatt es von Hand zu tun:
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.
Testschlüssel und jede andere Möglichkeit, einen anzuwenden, von appsettings.json zu Azure, werden in IronPDF-Lizenzschlüssel behandelt.
Vom HTML-Format anstelle einer eingebetteten Zeichenfolge zu rendern, ist der realistische nächste Schritt, da echte Templates auf der Festplatte leben.
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.
Grob gesagt, übersetzt sich dieses Prompt in das Folgende. Lesen Sie es, um zu bestätigen, dass der Agent auf echte APIs gestoßen ist, anstatt es selbst abzutippen:
// 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;
}
}
Jedes Mitglied dort ist real: ChromePdfRenderer, RenderHtmlAsPdfAsync und BinaryData erscheinen alle in der API-Referenz, die der Check ist, der auf jeden Block angewendet wird, den Ihnen ein Agent übergibt. Wenn das HTML auf lokale Bilder oder Stylesheets verweist, benötigt der Renderer einen Basis-Pfad, um diese aufzulösen, der als zweites Argument des Render-Aufrufs übergeben wird (BaseUrlOrPath auf RenderHtmlAsPdf, ein Uri auf RenderHtmlAsPdfAsync) anstatt in den Rendering-Optionen festgelegt zu werden, und ist im HTML-to-PDF-Tutorial dokumentiert.
Wie migrieren Sie eine bestehende PDF-Implementierung zu IronPDF?
Hier verdient ein Agent sein Geld, da die Migration mechanisch, ermüdend und einfach zu 90 % richtig ist. Der Prompt muss auf den vorhandenen Code zeigen, anstatt ihn zu beschreiben.
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.
Die Analyse von der Implementierung zu trennen ist das nützlichste Schema in diesem Leitfaden. Ein Agent, der 400 Zeilen schreibt, bevor Sie sich auf den Ansatz geeinigt haben, erzeugt 400 Zeilen, die Sie sorgfältig lesen müssen. Ein Agent, der einen Fünf-Punkte-Plan produziert, erzeugt etwas, das Sie in einem Satz korrigieren können.
Nach Genehmigung des Plans ist das Follow-up eng begrenzt:
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.
Die öffentliche Signatur stabil zu halten, ist eine Einschränkung, die es wert ist, jedes Mal ausdrücklich gesagt zu werden. Ohne sie neigen Agents dazu, die Aufrufkonvention als Bonus neu zu gestalten, und die Migration wächst leise zu einem Refactoring.
Wie beheben Sie Layout-, Header- und CSS-Probleme durch Prompts?
Layout-Probleme sind visuell, und ein Agent kann das PDF nicht sehen. Der Prompt muss die Beschreibung dessen, was falsch ist, tragen.
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.
Sowohl das Symptom als auch die zu ändernde Datei zu benennen, hält die Korrektur im Template, wo sie hingehört. Da IronPDF durch Chromium rendert, gelten Standard-Druck-CSS. page-break-inside, break-after und die @page-Regel verhalten sich alle so, wie sie es in der Druckvorschau eines Browsers tun, die Ihnen auch eine schnelle Möglichkeit bietet, eine Korrektur zu überprüfen, ohne das PDF neu zu generieren. Die Ausnahme ist @media print. IronPDF rendert standardmäßig mit dem Medientyp Bildschirm, sodass Regeln innerhalb eines @media print-Blocks nur angewendet werden, nachdem RenderingOptions.CssMediaType auf PdfCssMediaType.Print gesetzt ist.
Header und Fußzeilen funktionieren anders. Sie sind eine Renderer-Einstellung anstelle von Template-Markup, also sollte der Prompt es sagen:
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.
Nach dem Dokumentationslink zu fragen, ist eine Verifikationsabkürzung. Wenn der Agent keine echte Seite für die API, die er gerade verwendet hat, liefern kann, ist das ein Signal, auf das es sich lohnt, zu handeln, bevor der Code einen Build erreicht. Behalten Sie Richtige Initialisierung der RenderingOptions zur Hand.
Wie debuggen Sie falsche PDF-Ausgabe von Anfang bis Ende?
Die oben genannten Prompts machen jeweils eine Sache. Der interessantere Gebrauch ist, Codex ein Symptom zu übergeben und es die ganze Schleife abarbeiten zu lassen: inspizieren, diagnostizieren, beheben, testen. Hier verhält es sich wie ein Entwicklungsassistent und nicht wie ein Snippet-Generator.
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.
Der vierstufige Rahmen ist wichtig. Es fordert eine Diagnose, die Sie bewerten können, bevor Änderungen an den Dateien vorgenommen werden, was billiger ist, als eine Bearbeitung im Nachhinein zu reverse-engineeren. In diesem Fall ist die wahrscheinlichste Ursache die Auflösung relativer Pfade: Der Browser löst das Bild relativ zum eigenen Standort der Datei auf, während der Renderer relativ zum gegebenen Basis-Pfad auflöst, und eine korrekte Antwort benennt diesen Mechanismus, anstatt einen absoluten Pfad einzusetzen.
Fehlermeldungen verdienen dieselbe Behandlung. Die vollständige Stack-Trace einzufügen ist das informationsreichste, was Sie einem Agenten geben können.
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.
Container-Ausfälle sind in der Regel auf die nativen Abhängigkeiten zurückzuführen, die IronPDFs Chromium-Engine auf einem Debian-basierten Image benötigt, und diese gehören in eine Dockerfile anstelle von C#. Weisen Sie Codex auf Wie man IronPDF in einem Docker-Container ausführt und lassen Sie es die aktuellen Bereitstellungsrichtlinien lesen, bevor es etwas bearbeitet.
Wie wandeln Sie einmalige Codes in wiederverwendbare, getestete Komponenten um?
Sobald ein Rendering funktioniert, sollte der nächste Prompt es verallgemeinern, und ein Agent ist dafür außergewöhnlich gut, weil das Muster bereits in der Datei vorhanden ist.
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.
Die Anweisung zur Wiederverwendung von Instanzen ist die Art von Detail, die in AGENTS.md mitgeführt werden sollte, da das Konstruieren eines Renderers pro Anfrage ein häufiger und stiller Leistungsfehler ist.
Tests sind der natürliche Begleiter, und PDF-Ausgaben sind testbarer als sie auf den ersten Blick erscheinen:
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.
Ein Byte-für-Byte-Vergleich vorab auszuschließen, verhindert eine ganze Klasse von instabilen Tests. Rendering-Engines erzeugen geringfügig unterschiedliche Bytes über Versionen und Plattformen hinweg, sodass Assertions auf der Ebene des extrahierten Textes, der Seitenanzahl und der Metadaten stattfinden sollten.
Codex ist auch nützlich als Leser. Weisen Sie es auf eine unbekannte Klasse hin, und es verwandelt die API-Referenz in etwas, das Sie abfragen können, anstatt zu scrollen:
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.
Welches Prompt-Muster passt zu welcher Aufgabe?
Sechs Abschnitte, sechs Muster. Das Gemeinsame ist, dass jeder von ihnen etwas Spezifisches benennt: eine Datei, eine Version, ein Symptom oder einen Endpunkt.
| Aufgabe | Benennen Sie dieses im Prompt | Muster |
|---|---|---|
| Das Paket hinzufügen | Die Version und dass nichts anderes hinzugefügt werden darf | Bitten Sie um das Ergebnis zurück |
| Erste Render | Der Template-Pfad und die zu verwendende Methode | Spezifizieren, dann bauen |
| Migration | Die zu lesende Datei und die zu bewahrende Signatur | Planen vor dem Codieren |
| Layoutkorrektur | Das Symptom und die zu ändernde Datei | Beschreiben, was Sie sehen |
| Containerfehler | Der vollständige Stack-Trace und die Plattform | Diagnostizieren, bevor Sie bearbeiten |
| Refaktorisierung und Tests | Die Form des Ergebnisses und was ausgeschlossen werden muss | Einschränken der Ausgabe |
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Wir haben die obigen Prompts in der Reihenfolge an Codex gesendet, in einer Sitzung, in einem .NET 9 Konsolenprojekt mit IronPdf 2026.10.3. Jeder Release-Build war erfolgreich. Chromium konnte in der Codex-Sandbox nicht gestartet werden, daher hat eine separate Überprüfung jedes PDF aus dem Code gerendert, das jeder Prompt hinterlassen hat.
- Vor dem Layout-Prompt spaltete die Rechnung den Posten 9 auf den Seiten 1 und 2, wobei der Gesamtblock oben auf Seite 2 war.
- Vor dem Logo-Prompt zeigte die Rechnung einen Platzhalter für ein fehlendes Bild und den alternativen Text anstelle des Logos.
- Das Quickstart-Programm warf eine LicensingException bei SaveAs, selbst mit dem Schlüssel in der Umgebung, weil nichts den Schlüssel angewendet hat.
- Der Lizenz-Prompt las den Schlüssel aus einer Umgebungsvariablen aus und wandte ihn vor dem ersten Rendern an. Das resultierende hello.pdf war eine 1-seitige A4-Datei mit 17.385 Bytes.
- Der AGENTS.md-Prompt erzeugte einen PDF-Abschnitt, der alle fünf Anforderungen enthielt.
- Der Migrationsplan änderte keine Datei und beschrieb die A4-Seite, Schriften, Farben und Abschnitte des ursprünglichen Berichts korrekt. Der migrierte Bericht behielt die öffentliche Methodensignatur bei, entfernte das PDFsharp-Paket und reproduzierte jede Grafik.
- Der migrierte Fußzeile wurde auf eine zweite Seite verlegt und zeigte Seite 0 von 0 an, wo der ursprüngliche 1-seitige Bericht Seite 1 von 1 anzeigte.
- Die Layout-Korrektur platzierte jede Seitenumbruch-Regel innerhalb eines @media print-Blocks, den der standardmäßige Medientyp Bildschirm ignoriert. Die Rechnung blieb unverändert, und Posten 9 war immer noch aufgespalten.
- Mit dem CssMediaType auf Print gesetzt, hielt dieselbe Vorlage Posten 9 ganz auf Seite 2, mit den Summen direkt darunter.
- Der Fußzeilen-Prompt fügte eine HTML-Fußzeile hinzu, und die beiden Seiten zeigten dann Seite 1 von 2 und Seite 2 von 2.
- Die Logo-Diagnose nannte den relativen Pfad und die fehlende Basis-URL als Ursache. Mit dem Vorlagenordner als Basis-URL übergeben und logo.png in das Build-Output kopiert, wurde das Logo mit 240 mal 96 Pixeln gerendert.
- Der erste InvoiceRenderer erstellte bei jedem Aufruf einen neuen ChromePdfRenderer. Der umgestaltete PdfDocumentService hatte 51 Zeilen, und die Abhängigkeitsinjektion teilte sich einen ChromePdfRenderer.
- Die beiden xUnit-Tests deckten alle vier Bedingungen ab und sind mit dem Schlüssel erfolgreich verlaufen. Ohne den Schlüssel schlug der Text-Extraktionstest mit LicensingException fehl.
- Die API-Antwort nannte zwölf Mitglieder, und alle zwölf existieren in IronPdf 2026.10.3, einschließlich des PaperFit-Feldes. Es wurde korrekt gemeldet, dass das Projekt nur den unteren Rand unter ihnen festsetzte.
- Kein gerendertes PDF trug ein Wasserzeichen, und der Schlüssel erschien in keiner Datei, keinem Commit oder Codex-Sitzungsprotokoll.
- Einige Schritte liefen anders als die Seite. Die README des Repositories nannte die Schlüsselvariable und sagte, sie niemals zu drucken. Der PDFsharp-Bericht, eine Rechnung mit 9 Posten und das Logo wurden hinzugefügt, bevor die Prompts, die sie benötigten. Der Linux-Container-Prompt wurde nicht ausgeführt, weil der Computer kein Docker hatte. Die Sandbox hatte kein Netzwerk, also stellte Codex Pakete aus dem lokalen NuGet-Cache wieder her, wo das Abhängigkeitsinjektionspaket während des Laufs wiederhergestellt worden war.
Die unten stehende Rechnung ist die unveränderte Ausgabe des endgültigen PdfDocumentService. Sie enthält die Fußzeile und das Logo, und Posten 9 ist immer noch aufgespalten.
Das gemeinsame Laufprotokoll listet die Codex-Version, das Modell, die Maschine und die Zeitangaben für diesen Lauf auf.
Was wird auf das nächste Projekt übertragen?
Die Prompts, nicht der Code. Jedes oben genannte Muster überlebt eine Projektänderung mit nur den ausgetauschten Dateinamen, weshalb ein festgelegtes AGENTS.md seine Berechtigung erhält: Es verwandelt die von Ihnen einmal ausgearbeiteten Einschränkungen in den Standard, von dem jede spätere Sitzung ausgeht.
Der Akzeptanztest, gegen den diese Serie gemessen wird, läuft von Anfang bis Ende mit einem veröffentlichten Ergebnis und einem zuletzt getesteten Datum und ist im Leitfaden zu KI-Coding-Assistenten zu finden.
Fehlerbehebung
- Einen Lizenzschlüssel in IronPDF anwenden: wenn das Speichern des PDFs eine Lizenz-Exception wirft
- RenderingOptions korrekt initialisieren: wenn Codex Optionsnamen vorschlägt, die sich nicht auflösen lassen
- Welche Version von IronPDF sollte ich verwenden?: um eine Version in Ihren Prompts und in
AGENTS.mdfestzulegen - Wie man IronPDF in einem Docker-Container ausführt: wenn ein Rendering auf Windows funktioniert und in einem Container fehlschlägt
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.