Comment utiliser IronPDF avec Google Antigravity

Curtis Chau
Curtis Chau
Mis à jour : 20 octobre 2026

La plupart des outils de codage IA s'arrêtent au fragment. Ils renvoient du code, et vous découvrez s'il fonctionne en l'exécutant vous-même. Cet écart importe plus que d'habitude pour la génération de PDF, car un PDF qui compile proprement peut encore être visuellement incorrect, et rien dans un log de construction ne vous dit que le logo manque ou que la table est divisée à travers une coupure de page.

Google Antigravity est une plateforme de développement agentique plutôt qu'un assistant de chat. Les agents travaillent à travers l'éditeur, le terminal et un navigateur, et ils rapportent avec des livrables au lieu de transcriptions. IronPDF rend du HTML en PDF en utilisant un moteur Chromium embarqué. Le jumelage est utile pour une raison spécifique: parce que les deux côtés de la comparaison sont un navigateur rendant le même HTML, un agent peut ouvrir une page, générer le PDF, regarder les deux, et continuer d'ajuster jusqu'à ce qu'ils correspondent. Ceci est une boucle de vérification, et c'est la partie autour de laquelle construire ce guide.

Une clarification avant de commencer, car deux sujets aux sons similaires sont souvent confondus. Ce guide concerne l'utilisation d'un outil de développement IA pour construire un logiciel avec IronPDF. Il ne s'agit pas d'utiliser des modèles d'IA pour lire ou analyser le contenu des fichiers PDF, ce qui est couvert séparément dans le tutoriel de traitement de PDF alimenté par IA. Problème différent, page différente.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPdf

Installez IronPDF en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un projet dans Antigravity et décrivez le document que vous souhaitez :

In this C# project, add IronPDF and create Program.cs that renders the HTML
string "<h1>Hello from IronPDF</h1>" to hello.pdf. Read the license key from
the IRONPDF_LICENSE_KEY environment variable, never hardcode it. Run
dotnet build, fix any errors, and show me the resulting file.
Text

L'agent d'Antigravity installe le package, écrit les quelques lignes qui construisent un ChromePdfRenderer et appelle RenderHtmlAsPdf, enregistre le fichier, et rend compte du résultat de la construction. Ce que vous examinez est le résultat, non une transcription.

Une courte note de sécurité pendant que vous êtes ici. Les agents dans un IDE agentique ont accès à l'écriture de fichiers et au terminal, donc une clé de licence doit être placée dans une variable d'environnement ou un fichier de configuration qui est exclu du contrôle de source, jamais collé dans une description de tâche ou engagé dans le dépôt. Le guide de la clé de licence couvre les options de configuration prises en charge.



Qu'est-ce que Google Antigravity, et en quoi est-il différent d'un assistant de chat?

Antigravity est une plateforme de développement axée sur les agents où des agents autonomes planifient et exécutent des travaux à travers l'éditeur, le terminal et le navigateur, puis rendent des résultats sous forme de livrables examinables. Google le décrit comme combinant une vue éditeur avec une surface de gestion pour déployer des agents qui planifient, exécutent et vérifient des tâches complexes.

Cinq caractéristiques importent pour le travail PDF.

Vue éditeur est la surface IDE familière, avec des complétions d'onglets et des commandes en ligne. Utilisez-la pour un travail de proximité sur un seul fichier, lorsque vous voulez déplacer le curseur et examiner chaque modification au fur et à mesure qu'elle se produit.

Surface de gestion est un contrôle de mission asynchrone. Générez des agents, faites la queue des tâches, regardez la progression, et exécutez des travaux en parallèle à travers un espace de travail plutôt que d'attendre une conversation à la fois.

Contrôle du navigateur permet à un agent de diriger un navigateur pour exercer une fonctionnalité et confirmer le résultat. Pour IronPDF, c'est la capacité phare, et elle a sa propre section ci-dessous.

Artefacts sont les résultats qu'un agent produit au lieu de logs d'outils bruts: listes de tâches, plans d'implémentation, démonstrations, captures d'écran et enregistrements de navigateur. Selon Google, ceux-ci vous permettent de vérifier la logique d'un agent d'un coup d'œil, et vous pouvez laisser des commentaires directement sur un artefact, de la même manière que vous commenteriez sur un document, sans interrompre l'exécution de l'agent.

Optionnalité du modèle signifie que l'agent peut être alimenté par différents modèles sous-jacents, choisis par tâche.

La différence pratique d'un assistant de chat est ce que vous examinez. Un assistant de chat produit un texte que vous devez évaluer en lisant. Un agent produit un plan, un diff et une capture d'écran du rendu réel. Pour une tâche PDF, une capture d'écran du document est une preuve bien plus significative qu'un paragraphe décrivant à quoi le document devrait ressembler.

Cette boucle de vérification ne fonctionne que parce qu'un côté de la comparaison est honnête. Un agent chargé de construire un pipeline de document à partir de zéro improvisera volontiers : choisir une bibliothèque de rendu, la câbler, et passer à la suite. Ce qui est livré dans ce pipeline représente le risque.

  • Les documents sensibles ont besoin d'une bibliothèque sécurisée : les PDF qu'une entreprise génère sont ses contrats, factures, et dépôts légaux. 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.
  • La sortie déterministe est ce qui rend la comparaison de navigateur digne de confiance : la sortie d'un agent varie entre les exécutions, mais le renderer en dessous ne peut pas, sinon la boucle dans ce guide est insignifiante. IronPDF fixe son moteur Chromium, de sorte que le même HTML rend les mêmes pages à chaque exécution.
  • Les formats de conformité sont les exigences que personne ne prototype : SaveAsPdfA écrit un fichier PDF/A d'archivage, et SaveAsPdfUA écrit le PDF/UA étiqueté, accessible et navigable par un lecteur d'écran. Les moteurs de rendu gratuits offrent rarement l'un ou l'autre.
  • Un vrai package bat un deviné : les agents installent parfois des noms de packages qui semblent simplement corrects, un truc assez courant pour avoir reçu le nom de "slopsquatting" (squat de négligence), et les attaquants enregistrent ces noms et les remplissent de malwares. Nommer un package connu dans votre description de tâche ferme cette porte.

Pointer Antigravity vers IronPDF et le travail de l'agent se limite à ce dans quoi il excelle véritablement : écrire le modèle, diriger le navigateur et vérifier le résultat. Le guide parent couvre la documentation à fournir à tout agent avant qu'il ne commence, et la même configuration s'applique à Claude Code et ChatGPT Codex avec seulement le nom de fichier des instructions changeant.

Que remet l'agent, et comment l'examinez-vous?

La sortie d'un agent Antigravity n'est pas une transcription. Elle produit des artefacts: des livrables nommés que vous examinez de la manière dont vous examineriez un document. Trois d'entre eux arrivent dans un ordre prévisible, et chacun répond à une question différente sur une tâche PDF.

Avant le code: la liste des tâches

L'agent écrit un plan structuré avant d'écrire quoi que ce soit d'autre. Pour le travail sur PDF, la question utile à poser est quelle couche il a l'intention de toucher. Un plan qui propose de modifier le renderer lorsque le problème est une table divisée à travers des pages se dirige déjà dans la mauvaise direction, et c'est l'endroit le moins coûteux pour attraper cela.

Pendant : le plan d'implémentation

C'est là que l'agent architecte le changement : quels fichiers, quelles méthodes, quelles options de rendu. Un nom d'API inventé est visible ici avant qu'une seule ligne ne soit écrite, ce qui est un bien meilleur endroit pour en trouver un qu'un log de construction.

Après : le Walkthrough

Écrit une fois l'implémentation terminée, résumant ce qui a changé et comment le tester. Pour une tâche de document, cela signifie le nombre de pages, l'en-tête et le pied de page, exprimés comme des vérifications que vous pouvez exécuter plutôt que des affirmations auxquelles vous devez faire confiance.

Les captures d'écran et les enregistrements du navigateur s'accumulent à côté de ceux-ci, et se rassemblent dans le panneau auxiliaire plutôt que de défiler dans un journal de chat. Le reste de ce guide s'appuie là-dessus : deux des tâches ci-dessous sont suivies par l'unique Artifact qui vaut la peine d'être ouvert pour confirmer que le travail a réellement eu lieu.

D'où provient la preuve ?

Le contrôle du navigateur est le jumelage qui justifie l'utilisation d'une plateforme agentique pour le travail PDF plutôt qu'un assistant basé sur des invites. IronPDF rend avec un moteur Chromium, et les agents Antigravity peuvent piloter un navigateur. Les deux côtés de la comparaison sont donc le même moteur rendant le même HTML, ce qui rend la comparaison significative plutôt qu'approximative.

La boucle ressemble à ceci : l'agent ouvre le modèle dans le navigateur, capture ce qu'il voit, génère le PDF, compare les deux, ajuste le CSS, et répète jusqu'à ce qu'ils correspondent.

Donnez-lui un véritable symptôme à poursuivre :

Templates/invoice.html renders correctly in a browser but the PDF output is
wrong: the line-item table splits a row across pages and the totals block
lands at the top of page 2 instead of under the table.

1. Open the template in the browser and capture a screenshot.
2. Run the renderer to produce invoice.pdf.
3. Compare the two and explain the difference before changing anything.
4. Fix it in the CSS using page-break properties. Do not change the C#.
5. Re-render, capture both again, and attach them as Artifacts.
Text

Deux choix de conception dans cette tâche importent. Demander une explication avant un changement vous donne un diagnostic à évaluer plutôt qu'une correction que vous devez rétro concevoir. Contraindre le changement au niveau du CSS maintient la correction là où elle appartient, car le comportement de coupure de page est une préoccupation du feuille de style et un agent non contraint "résoudra" souvent cela en restructurant le C#.

Les artefacts sont ce qui rend cela examinable. Une capture d'écran de la page rendue à côté du PDF généré est une preuve directe; une affirmation écrite que la mise en page correspond maintenant ne l'est pas. Pour un développeur junior, c'est aussi la façon la plus rapide de développer une intuition pour pourquoi la sortie du navigateur et du PDF divergent du tout, car les différences deviennent visibles plutôt que théoriques.

Veuillez noter: Vérifiez les captures d'écran. Si l'agent n'a jamais réellement ouvert le modèle, il n'a rien vérifié, et les captures d'écran montrent cela.

Le retour sur un problème de mise en page est spatial, ce qui rend le modèle d'examen intéressant à connaître. Plutôt que de décrire quel bloc est incorrect dans une phrase, sélectionnez la région de la capture d'écran qui est incorrecte et commentez dessus directement, comme vous le feriez sur un document. L'agent intègre cette correction dans le travail sans que le cycle soit démantelé et redémarré.

Même utilisé pour rien d'autre, avoir un agent qui rend une page, génère le PDF et vous montre les deux est plus rapide que le cycle manuel de construction, d'ouverture, de plissement des yeux, et d'ajustement.

Pourquoi cela semble-t-il correct dans le navigateur et incorrect dans le PDF?

La plupart de ce que cette boucle attrape tombe dans un petit ensemble de causes, et elles partagent un symptôme inutile : un document qui semble cassé et ne lance aucune erreur. Nommer la cause soupçonnée dans la tâche évite à l'agent un tour de devinettes.

SymptomPourquoi les deux divergentMettez cela dans la tâche
Le texte se redistribue ou déborde de sa boîteUne police web n'avait pas encore fini de se charger lorsque la mise en page a été calculée, donc les mesures provenaient d'une face de secoursNommez la police et demandez confirmation qu'elle est intégrée plutôt que substituée
Les images manquantes, bien que le navigateur les afficheLe navigateur résout les chemins relatifs par rapport à l'emplacement du fichier lui-même; le renderer résout par rapport à tout chemin de base qui lui a été donnéDemandez à ce que le chemin de base soit défini explicitement et nommé dans la démonstration
Les graphiques ou tableaux sortent videsLe contenu a été produit par du JavaScript que le renderer a capturé avant qu'il n'ait fonctionnéDemandez à l'agent de confirmer que le rendu a attendu, et qu'il attache la capture d'écran comme preuve
Une ligne de tableau se divise sur deux pagesLe CSS d'impression n'a jamais été appliqué, seulement le CSS écranSaisissez la correction sur les propriétés de coupure de page dans la feuille de style

Chaque ligne est une différence entre deux rendus du même balisage, c'est exactement pourquoi la comparaison ci-dessus est ce qui les trouve.

Comment configurez-vous un projet dans lequel Antigravity peut travailler?

Vous donnez à l'agent un projet qui compile déjà. Un agent qui doit deviner quelle bibliothèque PDF vous avez prévue, ou déboguer une construction cassée avant de démarrer la tâche réelle, passe son exécution sur le mauvais problème.

Créez ou ouvrez d'abord le projet et confirmez que la construction passe. Ensuite, la tâche de configuration elle-même vaut la peine d'être déléguée, car l'installation est l'endroit où apparaissent les incompatibilités de version.

Confiez directement la tâche de configuration à l'agent :

Add the IronPDF NuGet package to this project. Then tell me which version was
installed and show me the PackageReference line. Configure the license key to
be read from configuration rather than hardcoded, and add the config file to
.gitignore if it isn't already. Don't change other package references.
Text

Demandée pour la version en retour vous donne un fait à inclure dans chaque description de tâche ultérieure. Demander la vérification .gitignore garde le fichier de configuration qui contient la clé hors du dépôt.

Veuillez noter: Vérifiez le journal du terminal. Il enregistre la version du package qui a réellement été résolue, ce qui est le fait valable à coller dans chaque tâche suivante.

Un fichier d'instructions d'espace de travail, engagé à la racine du dépôt, vaut la peine d'être configuré une fois. Antigravity lit AGENTS.md pour les instructions permanentes du projet, le même fichier utilisé par ChatGPT Codex. Enregistrer qu'IronPDF est la bibliothèque PDF, que le code généré doit utiliser uniquement des APIs documentées, et que la clé de licence n'est jamais insérée en ligne signifie que vous cessez de répéter ces contraintes dans chaque tâche. Une tâche l'écrit pour vous :

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 ChromePdfRenderer is the HTML to PDF entry point, and
that no competing PDF package may be added.
Text

Comment déléguer le travail de génération et de migration de PDF?

Les tâches de génération fonctionnent mieux lorsque vous décrivez le document plutôt que le code, et laissez l'agent choisir comment l'exprimer en HTML.

Demandez le document, pas l'implémentation:

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 an async RenderAsync method that
loads the template, substitutes {{CompanyName}}, renders it with IronPDF, and
returns a byte array. A4 portrait, 20mm margins. Build and fix errors.
Text

La migration est le type de tâche où la délégation est la plus payante, car elle est mécanique, fastidieuse, et facile à presque bien réaliser. Le mouvement clé est de séparer l'analyse de l'implémentation.

Dirigez l'agent vers le code existant plutôt que de le décrire :

Read Reports/LegacyReportBuilder.cs. It builds PDFs by positioning text at
coordinates with another library.

1. Summarize the current output: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Produce this as a plan Artifact. Do not write code yet.
Text

Un agent qui écrit quatre cents lignes avant que vous n'ayez convenu de l'approche produit quatre cents lignes que vous devez lire attentivement. Un artefact de plan est quelque chose que vous pouvez corriger en une phrase, et le mécanisme de retour d'Antigravity signifie que vous pouvez l'annoter sans jeter l'exécution. Une fois approuvé, la tâche de suivi est étroite : implémentez le plan, gardez la signature de méthode publique existante pour que les appelants ne changent pas, et signalez le diff.

Les en-têtes et pieds de page sont un paramètre de renderer plutôt qu'un balisage de gabarit, donc la tâche devrait le préciser. Demander à l'agent de lier la page de documentation qu'il a utilisée est une étape de vérification peu coûteuse : s'il ne peut produire une page réelle pour l'API qu'il vient d'appeler, c'est un signal. Le guide des en-têtes et pieds de page est la référence ici, et le guide des coupures de page couvre les contrôles de mise en page connexes.

Quand devriez-vous dépêcher plus d'un agent ?

La surface de gestion est pour le travail qui n'a pas besoin que vous surveilliez. Plutôt que d'exécuter une tâche à la fois, envoyez plusieurs agents et examinez leurs artefacts à mesure qu'ils finissent.

Une division réaliste pour une migration de PDF : un agent convertit le générateur de rapport hérité vers IronPDF tandis qu'un second rédige la suite de tests autour de la sortie qu'il produira. Le deuxième agent n'a pas besoin que le premier termine, car les tests portent sur le document, pas l'implémentation.

Envoyez les deux à la fois :

Agent A: migrate Reports/LegacyReportBuilder.cs to IronPDF per the approved
plan. Keep the public method signature unchanged.

Agent B: write xUnit tests for the migrated output. Assert that the result is
non-empty, begins with the %PDF- signature, contains the substituted company
name in extracted text, and has the expected page count. Do not use
golden-file byte comparisons; rendering output is not byte-stable.
Text

Exclure la comparaison octet par octet évite toute une classe de tests instables. Le rendu des sorties diffère selon les versions et plateformes des moteurs, donc les assertions appartiennent au niveau du texte extrait, du compte de pages et des métadonnées.

Veuillez noter: Artefact à vérifier: les deux démonstrations. Les tests de l'Agent B ne signifient quelque chose que s'ils sont assermentés contre le document que l'Agent A a réellement produit.

Les agents d'Antigravity enregistrent également des modèles et solutions des tâches passées dans une base de connaissances qui informe les suivantes. Pour un pipeline documentaire qui s'accumule d'une manière spécifique : la règle de coupure de pages résolue pour la facture est la même règle dont l'état, le bordereau d'expédition et l'avis de remise ont tous besoin, donc le deuxième document coûte généralement moins cher que le premier.

Comment déboguiez-vous les échecs de déploiement sur Linux, Docker, ou Azure ?

Les problèmes de déploiement sont là où l'accès au terminal fait sa valeur, car la réponse réside généralement dans le conteneur plutôt que dans le code.

Remettez directement l'échec à l'agent :

Rendering works locally on Windows but fails in our Linux container with:

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Inspect the 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.
Text

L'instruction de ne pas toucher au code d'application importe. Une bibliothèque partagée manquante dans une image n'est pas un problème C#, et un agent ayant toute latitude ajoutera parfois des blocs try/catch défensifs qui masquent l'échec plutôt que de le corriger. Le guide de déploiement Docker documente les besoins de dépendance actuels, qui changent entre les versions et doivent être lus plutôt que rappelés.

Les agents sont également utiles simplement comme lecteurs. Pointez-en un sur une classe inconnue, puis demandez-lui de lister les options de rendu qui affectent la taille de page et montrez lesquelles le projet définit actuellement, et la référence API devient quelque chose que vous pouvez interroger au lieu de faire défiler.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Sept des huit invites ci-dessus se sont exécutées dans l'ordre, sans surveillance, en une seule conversation. L'outil était Antigravity CLI 1.4.0 sur son modèle par défaut, Gemini 4 Argon (Medium). Le projet était une application console .NET 9 qui construisait déjà un rapport avec PDFsharp. Les chiffres ci-dessous proviennent de vérifications indépendantes des fichiers laissés par l'exécution.

  • Avant la tâche du navigateur, la ligne 09 de la facture était divisée entre les pages 1 et 2, avec les totaux en haut de la page 2.
  • L'installation de IronPdf 2026.10.3 a cassé la construction existante, car le package a ajouté un 'using' global qui rendait PdfDocument ambigu avec PDFsharp.
  • L'agent a résolu cette erreur avec un alias de type dans le générateur de rapports, et le projet a été construit sans avertissements ni erreurs.
  • Dans la tâche du navigateur, l'agent a capturé le modèle avec Chrome en mode sans tête et a rendu le PDF avant de modifier quoi que ce soit.
  • La correction n'a modifié que la feuille de style, en ajoutant des règles break-inside avoid aux lignes de tableau et au bloc de totaux.
  • La facture rendue gardait ensuite chaque ligne entière, avec la ligne 09 et les totaux ensemble sur la page 2.
  • La tâche de configuration a ajouté un appsettings.json avec une clé de licence vide et l'a listé dans .gitignore.
  • Cette valeur vide a pris le pas sur IRONPDF_LICENSE_KEY. Avec le fichier présent, le programme Quickstart et le travail de facturation ont tous deux déclenché 'Production License Required'.
  • AGENTS.md contenait les quatre règles de l'invite, et l'agent a lu llms.txt avant d'écrire le code de la facture.
  • InvoiceRenderer a retourné un PDF A4 de deux pages avec des marges de 20 mm et le nom de l'entreprise substitué.
  • Le plan de migration a rapporté la taille de la page Letter, les 32 lignes par page et toutes les cinq polices correctement, et n'a changé aucun fichier.
  • L'invite de distribution a démarré deux sous-agents, Agent A et Agent B, qui ont fonctionné en parallèle.
  • Le constructeur migré a conservé sa signature publique, ses deux pages Letter et les cinq polices d'origine.
  • Les deux tests xUnit de l'Agent B ont été passés contre la sortie de l'Agent A, vérifiant la signature PDF, le texte extrait et le nombre de pages.
  • Certaines étapes ont été exécutées différemment de la page. Le programme Quickstart a été construit mais non exécuté, donc une vérification séparée a produit son hello.pdf d'une page. L'exécution a ajouté le modèle de facture et un travail de rendu avant la tâche du navigateur, que la page suppose déjà existants. Le tour CLI ne s'est pas arrêté, donc l'explication de la division n'a été donnée que dans la réponse finale, après l'édition CSS. Le CLI a produit des captures d'écran mais aucun enregistrement de navigateur. La tâche de facture a modifié le modèle existant au lieu d'en créer un nouveau. L'Agent B a placé les tests à l'intérieur du projet console. L'invite du conteneur Linux ne s'est pas exécutée, car cette machine n'a ni Docker ni WSL.

La facture de la tâche du navigateur, avant et après la correction de la feuille de style, est intégrée ci-dessous.

La facture telle que l'agent l'a rendue avant la correction, avec la ligne 09 divisée entre les pages 1 et 2.

La même facture après la correction, avec chaque ligne entière et les totaux directement sous la ligne 09.

L'outil, le modèle et la durée de cette exécution sont listés dans le registre de l'exécution.

Qu'est-ce qui rend ce jumelage intéressant?

La vitesse importe moins que ce qui revient. L'agent remet un plan avant le travail, une visite guidée après, et des captures d'écran montrant que le rendu a réellement eu lieu. Pour le travail documentaire, où une construction propre ne vous dit rien sur la pertinence de la mise en page, des preuves vérifiables font toute la différence.

Le test reproductible derrière cette série, exécuté du début à la fin avec un résultat publié, réside sur le guide des assistants de codage IA.


Dépannage


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.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 22,198,312Version :2026.11tout juste publié