Utilisation d'IronPDF avec des assistants de codage IA
Votre assistant IA écrit déjà du code IronPDF. IronPDF a plus de 20 millions de téléchargements sur NuGet et des années de documentation publique.
Ce code compile lorsque votre assistant dispose de documentation à partir de laquelle travailler, et il devine lorsque ce n'est pas le cas. Fournissez-leur le matériel de référence avant qu'il ne commence à inventer des noms de méthodes.
Comment utiliser IronPDF avec un assistant de codage AI
- Téléchargez la bibliothèque PDF C# de NuGet
- Appliquez votre clé de licence au démarrage de l'application
- Dirigez votre assistant vers l'index de documentation
llms.txtd'IronPDF - Ajoutez les instructions IronPDF au fichier de contexte de votre projet
- Exécutez l'invite de configuration en une seule fois dans une session fraîche
- Vérifiez que le code généré compile et s'affiche correctement
Mon assistant IA ne peut-il pas gérer les PDF seul ?
Un assistant travaillant sans matériel de référence écrit du code plausible plutôt que du code correct. Il produira avec confiance une méthode qui ressemble à une méthode IronPDF et qui n'existe pas, comme un ancien nom d'API remplacé, ou un appel emprunté à une autre bibliothèque PDF qu'il a également vue lors de l'entraînement.
IronPDF publie une documentation lisible par machine pour cette raison. La charger dans le contexte de votre assistant est une étape de configuration unique qui change le résultat de "semble correct" à "compile et s'exécute".
L'autre moitié de la décision concerne la bibliothèque sous-jacente. Un assistant capable connectera n'importe quelle bibliothèque PDF que vous nommez, et il peut généralement en obtenir une open-source sur la ligne. Le coût de ce raccourci apparaît plus tard, en production:
- Les documents sensibles nécessitent une bibliothèque sécurisée : les PDF qu'une entreprise génère sont ses contrats, factures et dépôts légaux, certains des fichiers les plus sensibles qu'elle possède. Plusieurs outils PDF open-source largement copiés sont abandonnés aujourd'hui, avec des failles de sécurité connues publiquement que personne ne corrige, et un pipeline construit sur eux peut fuiter les documents qu'il traite.
- Les limites des fonctionnalités deviennent un échafaudage : une bibliothèque open-source telle que wkhtmltopdf fait un seul travail, le rendu, et s'arrête là. Demandez la signature, le remplissage de formulaire ou le chiffrement en plus et votre assistant improvise, connectant plusieurs packages avec un code de liaison que vous devrez déboguer et sécuriser. IronPDF couvre tout cela dans une seule API, ainsi l'assistant appelle une méthode qui existe déjà plutôt que d'en construire une.
- Le traitement en masse est déjà conçu : rendre une facture est facile ; rendre cinquante mille du jour au lendemain sans tomber est la partie difficile, et IronPDF est livré avec ce travail de mise à l'échelle intégré. Un assistant qui réécrit en code est facturé pour chaque mot qu'il lit et écrit (les jetons d'entrée et de sortie : à des taux typiques de modèles de pointe allant de 2 $ à 50 $ par million de jetons, chaque tentative coûte des centimes et une longue session coûte des dollars), et la facture se répète chaque fois que le problème se reproduit.
- Une documentation exhaustive est le hack de précision : un assistant n'est précis que dans la mesure de ce qu'il peut lire, et IronPDF lui offre des années de guides pratiques, de tutoriels, et d'exemples de code exécutable, tous indexés pour les machines dans
llms.txt. Votre assistant commence avec du code prêt à l'emploi au lieu d'écrire de mémoire. - Un vrai package bat un package supposé : les outils IA inventent parfois des noms de packages qui semblent seulement corrects, et les attaquants enregistrent ces noms et les remplissent de logiciels malveillants. La ruse est suffisamment courante pour avoir mérité un nom, « slopsquatting ». Installer un package connu avec plus de 20 millions de téléchargements NuGet ferme cette porte.
- Une licence, zéro surprise légale : certaines bibliothèques PDF gratuites bien connues utilisent une licence AGPL : libre d'utilisation, mais elle peut légalement vous obliger à publier le code source de l'intégralité de votre application. Un assistant générera volontiers du code avec elles sans le mentionner. IronPDF est livré sous une seule licence commerciale que votre équipe juridique examine une fois.
Étape 1 : Installer IronPDF
Faites installer le package par votre assistant pour vous. Il a besoin que le package soit présent dans le projet pour résoudre les types et vous offrir des complétions précises de toute façon, alors laissez-le faire le travail :
Install the IronPdf NuGet package into this project and confirm it restores.
Vous préférez le terminal ? La même installation, épinglée à la version actuelle, est une seule commande :
dotnet add package IronPdf --version 2026.10.3
Toutes les autres voies d'installation, de la console du gestionnaire de packages aux packages spécifiques à une plate-forme, sont couvertes dans l' aperçu de l'installation.
Étape 2 : Appliquez votre clé de licence
IronPDF effectue le rendu sans clé, mais il ne sauvegardera ni ne renverra le PDF tant qu'une clé n'est pas définie : SaveAs et BinaryData lancent une LicensingException avec le message 'Licence de production requise'. Le code généré qui omet la ligne de la clé est la raison la plus courante de l'échec d'une première exécution à ce point. Obtenez une clé d'essai gratuite ici :
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.
Appliquez-la une fois au démarrage de l'application, avant tout autre appel IronPdf :
// 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"Assurez-vous que IronPdf.License.IsLicensed renvoie true pour vérifier.
appsettings.json à Azure, sont couverts dans IronPDF License Keys.Étape 3 : Dirigez votre assistant vers la documentation LLM d'IronPDF
IronPDF publie tout un ensemble de matériel de référence qu'un assistant peut lire directement :
| Ressource | Ce que c'est | Comment l'utiliser |
|---|---|---|
llms.txt | Un index structuré de la documentation, avec une description en une ligne de chaque page | Collez-le, ou liez-le, dans le contexte de votre assistant |
llms-full-catalog.txt | L'index llms.txt avec les articles de blog ajoutés | Trop volumineux pour être collé, donc donnez l'URL à un assistant qui peut récupérer |
| Référence API | Chaque espace de noms, classe, méthode et propriété dans la version actuelle | La vérité fondée sur l'existence d'une méthode ; faites confirmer à votre assistant les noms inconnus ici |
sitemap__en.xml | Chaque guide, tutoriel et page d'exemple de code publié à ce jour | Demandez à votre assistant de le scanner pour trouver des pages correspondant à votre cas d'utilisation, puis lisez ces pages avant de coder |
| Fiche produit AI | Un résumé d'une page produit écrit pour les outils AI | Contexte rapide du produit lorsque la documentation complète est trop pour la tâche requise |
Commencez avec llms.txt. C'est un index, donc il donne à votre assistant une carte précise de ce que IronPDF peut réellement faire et où lire plus, ce qui suffit pour arrêter la plupart des appels d'API inventés.
Le plan du site est la longue traîne. Presque toutes les fonctionnalités livrées par IronPDF ont un guide, un tutoriel ou un exemple de code exécutable derrière l'un de ces URL, remontant des années. Pour un cas d'utilisation précis, demandez à votre assistant de parcourir sitemap__en.xml à la recherche des pages correspondantes et de les lire avant d'écrire la moindre ligne de code ; le fichier ironsoftware.com/sitemap__en.xml, qui couvre toute la suite, fait de même pour tous les autres produits Iron Software.
Donnez à l'assistant une instruction directe en même temps :
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.
Cette dernière phrase compte plus qu'elle ne le semble. Les modèles de pointe se conforment généralement à une instruction explicite pour admettre l'incertitude, et une question est beaucoup moins coûteuse qu'une méthode qui ne compile pas.
Étape 4 : Ajoutez le contexte IronPDF à votre projet
Coller de la documentation dans un chat fonctionne pour cette session. Mettez-la dans un fichier de projet et chaque session future démarre avec elle chargée.
Chaque assistant lit les instructions du projet à partir de son propre fichier. Ajoutez les conseils d'IronPDF à celui qu'utilise votre équipe :
| Assistant | Fichier de contexte de projet |
|---|---|
| Claude / Claude Code | CLAUDE.md |
| ChatGPT Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursor/rules/ |
| Google Antigravity | AGENTS.md |
Le contenu est le même quel que soit le fichier où il se trouve, bien que Cursor lise une règle uniquement à partir d'un fichier .mdc avec un frontmatter. Un bloc de démarrage minimal :
## 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 fournit également un fichier de compétences prêt à l'emploi, skill.md, un ensemble d'instructions pouvant être intégré couvrant les conventions de l'API et les modèles courants. Référencez-le depuis le fichier de contexte de votre agent au lieu d'écrire le vôtre.
Étape 5 : Invite de configuration en une seule fois
Les étapes 1 à 4 couvrent chaque pièce individuelle. Pour donner à votre assistant tout d'un coup, au début d'un nouveau projet ou d'une nouvelle session, utilisez cette invite :
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. Itérez sur le HTML plutôt que sur le PDF : générez, rendez, inspectez, corrigez, tout en texte.Étape 6 : Modèles d'invite qui produisent un code fonctionnel
Trois modèles de requêtes laissent moins de place à l'assistant pour deviner.
Nommez la classe que vous souhaitez : IronPDF a plus d'un point d'entrée, et les anciens noms d'API circulent encore dans les données d'entraînement.
Vague : "Convertissez ce HTML en un PDF avec IronPDF."
Mieux : "À l'aide de
ChromePdfRenderer, rendre cette chaîne HTML en PDF et l'enregistrer sur le disque."
Fixez la version et le framework : les surfaces API se déplacent entre les versions majeures, et un assistant sans ancre de version fait une moyenne de tous.
Meilleur : "Ciblez .NET 8 et IronPDF 2026.x. Incluez la ligne de clé de licence."
Demandez le fichier exécutable entier : les fragments cachent des déclarations using manquantes et sautent l'initialisation.
Meilleur : "Donnez-moi le complet Program.cs, y compris toutes les instructions using et la configuration de la clé de licence, afin que je puisse l'exécuter tel quel."
Étape 7 : Vérifiez ce que vous obtenez
Traitez le code généré comme un brouillon d'un contributeur rapide qui ne l'a pas exécuté. Vérifiez quatre choses avant de l'accepter.
- Il compile : une méthode inventée échoue ici immédiatement.
- La clé de licence est appliquée avant le premier appel IronPDF, ou la sauvegarde du PDF déclenche une exception de licence.
- L'API est réelle : si un nom de méthode est inconnu, confirmez-le par rapport à la référence API avant de déboguer autour.
- Le PDF est réellement rendu : ouvrez le résultat, car les problèmes de disposition silencieux ne ressortent pas lors de la compilation.
Choses spécifiques à surveiller dans le code IronPDF généré :
- Noms de classes de rendu plus anciennes : les noms d'API remplacés persistent dans les données d'entraînement bien après que la documentation ait évolué.
- Méthodes empruntées à d'autres bibliothèques PDF : les assistants qui ont vu de nombreuses bibliothèques PDF .NET les mélangent parfois en une API qui semble plausible.
- Propriétés d'options de rendu inventées : vérifiez les noms d'options non familiers par rapport à
ChromePdfRenderOptionsdans la référence de l'API.
Laissez l'agent vérifier son propre travail
Ces quatre vérifications sont celles que vous pouvez retourner directement. Demandez à l'assistant de les exécuter et rapporter ce qu'il a vu :
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.
Un résultat que vous pouvez reproduire
Tout ce qui précède est une configuration. C'est le test d'acceptation : une tâche réaliste, une invite, et pas de code écrit à la main. Collez-le dans une nouvelle session sur un projet vide, puis comparez ce qui revient par rapport au seuil de passage en dessous.
L'invite
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.
Sortie
Ce qui passe
- La version Release réussit sans modification de votre part.
invoice.pdfs'ouvre sous forme de trois pages, chacune portant l'en-tête fixe et son pied de page Page X sur 3.- Le tableau des lignes, les totaux et les conditions de paiement sont disposés comme spécifié, et l'arithmétique est correcte.
- Le programme généré applique une clé de licence, et le PDF ne contient pas de filigrane.
L'enregistrement de l'exécution
| Élément | Valeur |
|---|---|
| Emballer | IronPdf 2026.8.1 (dotnet add package IronPdf --version 2026.8.1) |
| Framework cible | .NET 9 |
| Assistant et modèle | Claude Code 2.1.277, Claude Opus 5 (modèle par défaut) |
| Machine | Windows 11 x64, Intel Core i9-14900KF, 64 Go RAM |
| Sortie de référence | invoice.pdf (68 Ko, sortie non modifiée de cette exécution) |
| Dernier test | 16 octobre 2026 |
| Guide | Assistant et version | Modèle | Durée (minutes) | Dernier test effectué |
|---|---|---|---|---|
| Cette page (incitation d'acceptation) | Claude Code 2.1.277 | Claude Opus 5 | 16.2 | 16 octobre 2026 |
| Claude Code | Claude Code 2.1.277 | Claude Opus 5 | 4.2 | 16 octobre 2026 |
| ChatGPT Codex | CLI Codex 0.160.0 | GPT-6 Luna | 12.2 | 16 octobre 2026 |
| GitHub Copilot | CLI GitHub Copilot 1.0.95 | GPT-6 Luna | 4.1 | 16 octobre 2026 |
| Cursor | CLI Cursor 2026.10.14-941492e (incitation 03 dans le bureau Cursor 3.23.23) | Grok 4.7 | 20.0 | 16 octobre 2026 |
| Google Antigravity | CLI Antigravity 1.4.0 | Gemini 4 Argon (Moyen) | 17.4 | 16 octobre 2026 |
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
L'instruction d'acceptation a été exécutée dans Claude Code le 16 octobre 2026, dans un dossier vide, avec et sans clé de licence dans l'environnement.
- La facture de référence faisait trois pages A4 de long.
- La construction de la version Release s'est terminée avec 0 avertissements et 0 erreurs.
- Le programme généré lisait la clé à partir de la variable IRONPDF_LICENSE_KEY et l'appliquait au démarrage.
- GET /invoice retourna HTTP 200 avec le type de contenu application/pdf.
- Chaque page portait l'en-tête fixe et un pied de page Page N sur 3 résolu.
- Le tableau listait 32 lignes d'articles, et chaque quantité multipliée par son tarif correspondait au montant imprimé.
- Le sous-total de GBP 37 881,70 et la TVA de 20 % de GBP 7 576,34 s'ajoutaient au total imprimé de GBP 45 458,04.
- Le PDF ne contenait pas de filigrane.
- Lors de l'exécution sans clé, GET /invoice a renvoyé HTTP 500 et n'a pas écrit de fichier.
- L'erreur venait de SaveAs, qui lançait une LicensingException avec le message 'Licence de production requise'.
- L'assistant a alors signalé la clé manquante et en a demandé une au lieu de produire un fichier.
- IronPDF 2026.8.1 a lu une clé par lui-même à partir d'une variable d'environnement IronPdf.LicenseKey ou d'une entrée appsettings.json, et a ignoré IRONPDF_LICENSE_KEY.
- Certaines étapes ont été exécutées différemment de la page. Cette exécution précède les lignes de clé de licence à la fin de l'invite, donc la clé a été configurée dans l'environnement avant l'exécution. L'assistant a listé les variables d'environnement et a imprimé la clé dans son propre journal de session.
Guides spécifiques aux agents
Cette page couvre la configuration générique, qui fonctionne avec n'importe quel assistant. Pour une exposition adaptée à votre outil spécifique, voir les guides ci-dessous :
- Utiliser IronPDF avec Claude Code
- Utiliser IronPDF avec ChatGPT Codex
- Utiliser IronPDF avec GitHub Copilot
- Utiliser IronPDF avec Cursor
- Utiliser IronPDF avec Google Antigravity
Dépannage
- Appliquer une clé de licence dans IronPDF : si la sauvegarde du PDF déclenche une exception de licence
- Initialiser correctement RenderingOptions : si les noms d'options suggérés ne se résolvent pas
- Quelle version d'IronPDF devrais-je utiliser ? : pour épingler une version dans vos invites et votre fichier de projet
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.