Verwendung von IronPDF mit AI-Kodierungs-Assistenten
Ihr AI-Assistent schreibt bereits IronPDF-Code. IronPDF hat über 20 Millionen NuGet-Downloads und viele Jahre öffentliche Dokumentation.
Dieser Code kompiliert, wenn Ihr Assistent über Dokumentation verfügt, von der er ausgehen kann, und er rät, wenn nicht. Geben Sie ihm das Referenzmaterial, bevor er beginnt, Methodennamen zu erfinden.
Erfahren Sie, wie Sie IronPDF mit einem AI-Kodierungs-Assistenten verwenden
- Laden Sie die C# PDF-Bibliothek von NuGet herunter
- Wenden Sie Ihren Lizenzschlüssel beim Start der Anwendung an
- Weisen Sie Ihren Assistenten auf das
llms.txtDokumentationsverzeichnis von IronPDF hin - Fügen Sie IronPDF-Anweisungen zu Ihrer Projekt-Kontextdatei hinzu
- Führen Sie den einmaligen Einrichtungsaufforderung in einer neuen Sitzung aus
- Überprüfen Sie, ob der generierte Code kompiliert und rendert
Kann mein AI-Assistent PDFs nicht eigenständig bearbeiten?
Ein Assistent, der ohne Referenzmaterial arbeitet, schreibt plausiblen Code anstelle von korrektem Code. Es wird mit Sicherheit eine Methode erzeugen, die sich liest wie eine IronPDF-Methode und nicht existiert, wie z. B. ein älterer API-Name, der ersetzt wurde, oder ein Aufruf, der von einer anderen PDF-Bibliothek übernommen wurde, die es ebenfalls im Training gesehen hat.
IronPDF veröffentlicht aus diesem Grund maschinenlesbare Dokumentationen. Das Laden in den Kontext Ihres Assistenten ist ein einmaliger Einrichtungsschritt, der die Ausgabe von 'sieht richtig aus' in 'baut und läuft' ändert.
Die andere Hälfte der Entscheidung ist die darunterliegende Bibliothek. Ein fähiger Assistent wird jede PDF-Bibliothek, die Sie benennen, einbinden, und er kann normalerweise eine Open-Source-Lösung bereitstellen. Was dieser Shortcut kostet, zeigt sich später, in der Produktion:
- Sensible Dokumente benötigen eine sichere Bibliothek: die PDFs, die ein Unternehmen erzeugt, sind seine Verträge, Rechnungen und rechtlichen Dokumente, einige der sensibelsten Dateien, die es besitzt. Mehrere weit verbreitete Open-Source-PDF-Tools sind heute verlassen, mit öffentlich bekannten Sicherheitslücken, die niemand schließt, und eine darauf basierende Pipeline kann die Dokumente selbst, die sie verarbeitet, leaken.
- Funktionsbeschränkungen werden zu Gerüsten: Eine Open-Source-Bibliothek wie wkhtmltopdf erledigt eine Aufgabe, das Rendering, und endet dort. Bitten Sie um Signieren, Formularausfüllung oder Verschlüsselung und Ihr Assistent improvisiert, indem er mehrere Pakete mit Hilfscode verbindet, der Ihre Aufgabe ist, zu debuggen und zu sichern. IronPDF deckt all diese in einer API ab, sodass der Assistent eine Methode aufruft, die bereits existiert, anstatt eine zu entwickeln.
- Bulkverarbeitung ist bereits konzipiert: eine Rechnung zu rendern ist einfach; 50.000 über Nacht zu rendern, ohne abzustürzen, ist der schwierige Teil, und IronPDF wird mit dieser Leistung in großem Umfang geliefert. Ein Assistent, der es im Code erneut löst, wird für jedes Wort abgerechnet, das er liest und schreibt (Eingabe- und Ausgabetoken: zu typischen Frontier-Modell-Raten von 2 bis 50 $ pro Million Token kostet jeder Versuch Cent und eine lange Sitzung beläuft sich auf Dollar), und die Rechnung wiederholt sich jedes Mal, wenn das Problem auftritt.
- Umfangreiche Dokumentation ist der Genauigkeitstrick: Ein Assistent ist nur so genau wie das, was er lesen kann, und IronPDF bietet ihm jahrelange Anleitungen, Tutorials und lauffähige Codebeispiele, die alle in
llms.txtfür Maschinen indexiert sind. Ihr Assistent beginnt mit sofort einsatzbereitem Code, anstatt aus dem Gedächtnis zu schreiben. - Ein echtes Paket schlägt ein geratenes: AI-Tools erfinden manchmal Paketnamen, die nur richtig klingen, und Angreifer registrieren diese Namen und füllen sie mit Malware. Der Trick ist häufig genug, um sich einen Namen zu verdienen, 'Slopsquatting'. Das Installieren eines bekannten Pakets mit über 20M NuGet-Downloads schließt diese Tür.
- Eine Lizenz, keine rechtlichen Überraschungen: einige bekannte kostenlose PDF-Bibliotheken verwenden AGPL-Lizenzierung: kostenlos zu nutzen, aber es kann rechtlich erforderlich sein, den gesamten Quellcode Ihrer Anwendung zu veröffentlichen. Ein Assistent erzeugt gerne Code gegen sie, ohne darauf hinzuweisen. IronPDF wird unter einer kommerziellen Lizenz geliefert, die Ihr Rechtsteam einmal überprüft.
Schritt 1: Installieren von IronPDF
Lassen Sie Ihren Assistenten das Paket für Sie installieren. Es benötigt das Paket im Projekt, um Typen aufzulösen und Ihnen dennoch akkurate Vervollständigungen zu geben, also lassen Sie es die Arbeit erledigen:
Install the IronPdf NuGet package into this project and confirm it restores.
Bevorzugen Sie das Terminal? Die gleiche Installation, auf die aktuelle Version fixiert, besteht aus einem Befehl:
dotnet add package IronPdf --version 2026.10.3
Jeder andere Installationsweg, vom Paketmanager-Konsolenbefehl bis zu direkten DLL- und plattformspezifischen Paketen, ist in der Installationsübersicht abgedeckt.
Schritt 2: Anwenden des Lizenzschlüssels
IronPDF rendert ohne Schlüssel, aber es wird das PDF nicht speichern oder zurückgeben, bis einer gesetzt ist: SaveAs und BinaryData werfen eine LicensingException mit der Nachricht 'Produktionslizenz erforderlich'. Der generierte Code, der die Schlüssellinie überspringt, ist der häufigste Grund dafür, dass ein erster Lauf an diesem Punkt fehlschlägt. Holen Sie sich hier einen kostenlosen Testschlüssel:
Beginnen Sie noch heute, IronPDF in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden.
Wenden Sie ihn einmal beim Start der Anwendung an, bevor Sie einen weiteren IronPdf-Aufruf durchführen:
// Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"Stellen Sie sicher, dass IronPdf.License.IsLicensed true zurückgibt, um dies zu überprüfen.
appsettings.json bis Azure, wird in IronPDF License Keys behandelt.Schritt 3: Weisen Sie Ihren Assistenten auf die LLM-Dokumentation von IronPDF hin
IronPDF veröffentlicht einen vollständigen Stapel von Referenzmaterial, den ein Assistent direkt lesen kann:
| Ressource | Was es ist | Wie es zu benutzen ist |
|---|---|---|
llms.txt | Ein strukturierter Index der Dokumentation mit einer einzeiligen Beschreibung jeder Seite | Fügen Sie es in den Kontext Ihres Assistenten ein oder verlinken Sie es |
llms-full-catalog.txt | Der llms.txt Index mit den hinzugefügten Blog-Artikeln | Zu groß, um ihn einzufügen, daher geben Sie die URL an einen Assistenten weiter, der ihn abrufen und abrufen kann |
| API Referenz | Jeder Namespace, jede Klasse, jede Methode und jede Eigenschaft in der aktuellen Freigabe | Die endgültige Wahrheit darüber, ob eine Methode existiert; lassen Sie Ihren Assistenten hier unbekannte Namen bestätigen |
sitemap__en.xml | Jede bisher veröffentlichte Seite mit Anleitungen, Tutorials und Codebeispielen | Lassen Sie Ihren Assistenten nach Seiten suchen, die zu Ihrem Anwendungsfall passen, und diese Seiten lesen, bevor Sie programmieren |
| Produktdatenblatt für KI | Eine Ein-Seiten-Produktübersicht, die für AI-Tools geschrieben wurde | Kurzer Produktkontext, wenn die vollständigen Dokumente mehr sind, als die Aufgabe benötigt |
Starten Sie mit llms.txt. Es ist ein Index, der Ihrem Assistenten eine genaue Übersicht darüber gibt, was IronPDF tatsächlich leisten kann und wo mehr zu lesen ist, was ausreicht, um die meisten erfundenen API-Aufrufe zu stoppen.
Die Sitemap ist der lange Schwanz. Hinter fast jeder Funktion, die IronPDF liefert, verbirgt sich ein Leitfaden, ein Tutorial oder ein ausführbares Codebeispiel hinter einer dieser URLs und reicht Jahre zurück. For a specific use case, ask your assistant to scan sitemap__en.xml for matching pages and read them before it writes a line of code; the suite-wide ironsoftware.com/sitemap__en.xml does the same for every other Iron Software product.
Geben Sie dem Assistenten eine direkte Anweisung:
Before writing any IronPDF code, read https://ironpdf.com/llms.txt
and use only APIs documented there. Check anything you are not sure about
against the API reference at https://ironpdf.com/object-reference/api/.
If you are still unsure whether a method exists, say so instead of guessing.
Dieser letzte Satz ist wichtiger, als er aussieht. Moderne Modelle werden im Allgemeinen einer expliziten Anweisung Folge leisten, Unsicherheiten zuzugeben, und eine Frage ist viel billiger als eine Methode, die nicht kompiliert.
Schritt 4: Fügen Sie IronPDF-Kontext zu Ihrem Projekt hinzu
Das Einfügen von Dokumentation in einen Chat funktioniert für diese Sitzung. Legen Sie es in eine Projektdatei, und jede zukünftige Sitzung beginnt mit geladenem Dokument.
Jeder Assistent liest Projekteinstruktionen aus eigener Datei. Fügen Sie IronPDFs Anleitung demjenigen hinzu, das Ihr Team verwendet:
| Assistent | Projektkontextdatei |
|---|---|
| Claude / Claude Code | CLAUDE.md |
| ChatGPT Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursor/rules/ |
| Google Antigravity | AGENTS.md |
Der Inhalt ist derselbe, unabhängig davon, in welcher Datei er landet, obwohl Cursor eine Regel nur aus einer .mdc Datei mit Frontmatter liest. Ein minimaler Startblock:
## PDF generation with IronPDF
This project uses IronPDF for all PDF generation.
- Reference: https://ironpdf.com/llms.txt
- Use `ChromePdfRenderer` for HTML-to-PDF. Do not use older or alternative renderer classes.
- Apply the license key at application startup before any IronPDF call.
- Do not substitute another PDF library. If IronPDF cannot do something, say so.
IronPDF liefert auch eine fertige Skill-Datei, skill.md, eine komplette Instruktionsreihe, die API-Konventionen und allgemeine Muster abdeckt. Verweisen Sie darauf aus Ihrer Agenten-Kontextdatei anstelle eigene zu schreiben.
Schritt 5: Einmaliger Einrichtungsaufforderung
Die Schritte 1–4 decken jeden Teil einzeln ab. Um Ihrem Assistenten alles auf einmal bereitzustellen, am Anfang eines neuen Projekts oder einer frischen Sitzung, verwenden Sie diese Aufforderung:
Use IronPDF for all PDF work in this project.
1. Install the IronPdf NuGet package.
2. Apply your license key at application startup, before any other IronPdf call:
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
3. Read https://ironpdf.com/llms.txt before writing PDF code and work only from
APIs documented there, checking the API reference when a member is unfamiliar.
4. Load IronPDF's skill file if your tooling supports one.
5. Keep these instructions for future sessions in this project.
ChromePdfRenderer zu rendern. Iterieren Sie über das HTML, nicht das PDF: generieren, rendern, inspizieren, reparieren, alles im Text.Schritt 6: Aufforderungsmuster, die funktionierenden Code produzieren
Drei Aufforderungsmuster lassen dem Assistenten weniger Raum zum Raten.
Nennen Sie die gewünschte Klasse: IronPDF hat mehr als einen Einstiegspunkt, und ältere API-Namen zirkulieren immer noch in den Trainingsdaten.
Vage: "Konvertieren Sie dieses HTML mit IronPDF in ein PDF."
Besser: "Mit
ChromePdfRenderer, rendern Sie diesen HTML-String zu einem PDF und speichern Sie es auf der Festplatte."
Fixieren Sie die Version und das Framework: API-Oberflächen verschieben sich zwischen Hauptversionen, und ein Assistent ohne Versionsanker mittelt über alle.
Besser: "Zielen Sie auf .NET 8 und IronPDF 2026.x. Fügen Sie die Lizenzschlüsselzeile hinzu."
Bitten Sie um die komplette lauffähige Datei: Fragmente verbergen fehlende using-Anweisungen und übersprungene Initialisierung.
Besser: "Geben Sie mir das vollständige Program.cs, einschließlich aller using-Angaben und Lizenzschlüssel-Einrichtung, damit ich es wie es ist ausführen kann."
Schritt 7: Verifizieren Sie, was Sie zurückbekommen
Behandeln Sie generierten Code als Entwurf eines schnellen Beitrags, der nicht ausgeführt wurde. Überprüfen Sie vier Dinge, bevor Sie es akzeptieren.
- Es kompiliert: eine erfundene Methode scheitert hier sofort.
- Der Lizenzschlüssel wird angewendet, bevor der erste IronPDF-Aufruf erfolgt, ansonsten wird beim Speichern des PDFs eine Lizenzierungs-Exception geworfen.
- Die API ist real: wenn ein Methodenname unbekannt ist, überprüfen Sie ihn gegen die API-Referenz, bevor Sie ihn umgehen.
- Das PDF rendert tatsächlich: Öffnen Sie die Ausgabe, da stille Layoutprobleme zur Kompilierungszeit nicht auftreten.
Spezielle Dinge, auf die man bei generiertem IronPDF-Code achten sollte:
- Ältere Renderer-Klassennamen: überholte API-Namen bleiben in Trainingsdaten bestehen, lange nachdem die Dokumentation weitergezogen ist.
- Methoden aus anderen PDF-Bibliotheken entlehnt: Assistenten, die viele .NET PDF-Bibliotheken gesehen haben, manchmal mischen sie sie zu einer scheinbar plausiblen API.
- Erfundene Rendering-Optionseigenschaften: Überprüfen Sie unbekannte Optionsnamen gegen
ChromePdfRenderOptionsin der API-Referenz.
Lassen Sie den Agenten seine eigene Arbeit überprüfen
Diese vier Überprüfungen sind die, die Sie direkt zurückgeben können. Bitten Sie den Assistenten, sie auszuführen und zu berichten, was er gesehen hat:
Build and run this project in Release. Confirm that every IronPDF member you used
appears in the documentation, that IronPdf.License.IsLicensed returns true, and
that the rendered PDF opens. Report the build result, page count, and file size
from the run itself.
Ein Ergebnis, das Sie reproduzieren können
Alles oben Genannte ist eine Einrichtung. Dies ist der Akzeptanztest: eine realistische Aufgabe, eine Aufforderung und kein handgeschriebener Code. Fügen Sie es in eine frische Sitzung in einem leeren Projekt ein und vergleichen Sie, was zurückkommt, mit der Erfolgsgrenze darunter.
Die Aufforderung
Build a .NET 9 minimal API with one endpoint, GET /invoice, returning a three-page PDF invoice. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable to the project root.
1. Install the IronPdf NuGet package pinned to version 2026.8.1.
2. Read from https://ironpdf.com/llms.txt and the pages it links to, using only APIs documented there.
3. Generate the invoice yourself as one self-contained HTML string with inline CSS and any logo as inline SVG.
4. Style it as an invoice from a company you invent: header band with company identity, metadata block with invoice number, issue date, and due date, bill-to block, a ruled line-item table of twenty or more realistic items whose quantities, rates, and totals sum correctly, right-aligned subtotal, tax, and total, then payment terms. Use a system font stack, two or three sizes, neutrals with one accent, generous whitespace, consistently formatted money columns, and page-break-inside: avoid on table rows. Fill pages two and three with continued items and terms.
5. Render with ChromePdfRenderer: a fixed text header and a footer reading Page {page} of {total-pages} on every page, using those exact merge fields.
6. Return the PDF as application/pdf and save it as invoice.pdf.
7. Build in Release, call the endpoint, and count the pages; if not exactly three, adjust content or page-break CSS until it is.
8. Finish with a short report: build result, page count, file size, and assumptions made.
Handle the IronPDF license key this way:
- Read IRONPDF_LICENSE_KEY at startup and assign it to IronPdf.License.LicenseKey.
- Never print, log or store the key.
- Don't list or enumerate environment variables.
Ausgabe
Was besteht
- Der Release-Build gelingt ohne Ihre Bearbeitung.
invoice.pdfwird als drei Seiten geöffnet, jede enthält die feste Kopfzeile und sein Fußzeile Page X von 3.- Die Positions-Tabelle, die Summen und die Zahlungsbedingungen sind wie angegeben angeordnet, und die Arithmetik stimmt.
- Das generierte Programm wendet einen Lizenzschlüssel an, und das PDF enthält kein Wasserzeichen.
Der Laufaufzeichnung
| Item | Wert |
|---|---|
| Paket | IronPdf 2026.8.1 (dotnet add package IronPdf --version 2026.8.1) |
| Ziel-Framework | .NET 9 |
| Assistent und Modell | Claude Code 2.1.277, Claude Opus 5 (Standardmodell) |
| Maschine | Windows 11 x64, Intel Core i9-14900KF, 64 GB RAM |
| Referenzausgabe | invoice.pdf (68 KB, unveränderte Ausgabe dieses Laufs) |
| Zuletzt getestet | 16. Oktober 2026 |
| Anleitung | Assistent und Version | Modell | Dauer (Minuten) | Zuletzt getestet |
|---|---|---|---|---|
| Diese Seite (Akzeptanzaufforderung) | Claude Code 2.1.277 | Claude Opus 5 | 16.2 | 16. Oktober 2026 |
| Claude Code | Claude Code 2.1.277 | Claude Opus 5 | 4.2 | 16. Oktober 2026 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 12.2 | 16. Oktober 2026 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95 | GPT-6 Luna | 4.1 | 16. Oktober 2026 |
| Cursor | Cursor CLI 2026.10.14-941492e (Aufforderung 03 in Cursor-Desktop 3.23.23) | Grok 4.7 | 20.0 | 16. Oktober 2026 |
| Google Antigravity | Antigravity CLI 1.4.0 | Gemini 4 Argon (Medium) | 17.4 | 16. Oktober 2026 |
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Die Akzeptanzaufforderung lief am 16. Oktober 2026 in Claude Code in einem leeren Ordner, mit und ohne Lizenzschlüssel in der Umgebung.
- Die Referenzrechnung war drei A4-Seiten lang.
- Der Release-Build hat mit 0 Warnungen und 0 Fehlern abgeschlossen.
- Das generierte Programm las den Schlüssel aus der IRONPDF_LICENSE_KEY-Variable und wendete ihn beim Start an.
- GET /invoice gab HTTP 200 mit dem Inhaltstyp application/pdf zurück.
- Jede Seite trug die feste Kopfzeile und eine aufgelöste Fußzeile Page N von 3.
- Die Tabelle listete 32 Positionen auf, und jede Menge multipliziert mit ihrem Satz entsprach dem gedruckten Betrag.
- Die Zwischensumme von GBP 37.881,70 und die 20% MwSt. von GBP 7.576,34 ergaben zusammen die gedruckte Gesamtsumme von GBP 45.458,04.
- Das PDF enthielt kein Wasserzeichen.
- Beim Lauf ohne Schlüssel gab GET /invoice HTTP 500 zurück und schrieb keine Datei.
- Der Fehler stammte von SaveAs, das eine LicensingException mit der Nachricht "Product License Required" geworfen hat.
- Der Assistent meldete dann den fehlenden Schlüssel und fragte stattdessen nach einem, anstatt eine Datei zu produzieren.
- IronPDF 2026.8.1 las einen Schlüssel selbst aus einer IronPdf.LicenseKey Umgebung oder appsettings.json-Eintrag und ignorierte IRONPDF_LICENSE_KEY.
- Einige Schritte liefen anders als die Seite. Dieser Lauf liegt vor den Lizenzschlüssellinien am Ende der Aufforderung, sodass der Schlüssel vor dem Lauf in der Umgebung eingestellt wurde. Der Assistent listete die Umgebungsvariablen auf und druckte den Schlüssel in sein eigenes Sitzungsprotokoll.
Agentenspezifische Anleitungen
Diese Seite behandelt die allgemeine Einrichtung, die mit jedem Assistenten funktioniert. Für eine ausführliche Anleitung abgestimmt auf Ihr spezifisches Tool, sehen Sie sich die folgenden Anleitungen an:
- Verwendung von IronPDF mit Claude Code
- Verwendung von IronPDF mit ChatGPT Codex
- Verwendung von IronPDF mit GitHub Copilot
- Verwendung von IronPDF mit Cursor
- Verwendung von IronPDF mit Google Antigravity
Fehlerbehebung
- Einen Lizenzschlüssel in IronPDF anwenden: wenn das Speichern des PDFs eine Lizenz-Exception wirft
- Initialisieren von RenderingOptions richtig: wenn vorgeschlagene Optionsnamen nicht aufgelöst werden
- Welche Version von IronPDF sollte ich verwenden?: um eine Version in Ihren Aufforderungen und Projektdateien zu fixieren
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.