Comment utiliser IronPDF avec GitHub Copilot

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

La plupart des guides sur la programmation assistée par IA supposent que vous êtes prêt à changer d'éditeur. Pour le travail en .NET, cette hypothèse est souvent erronée. Les projets IronPDF qui vivent dans Visual Studio se trouvent à l'intérieur de solutions avec des références de projet, une configuration NuGet et un pipeline de build que personne ne veut relocaliser juste pour essayer un assistant.

GitHub Copilot fonctionne là où ces projets se trouvent déjà, dans Visual Studio, VS Code et les IDE JetBrains, donc ce flux de travail n'a pas besoin de migration. Il fait aussi quelque chose qu'aucun assistant intégré à un éditeur ne peut faire : il fonctionne à l'intérieur même de GitHub. Vous pouvez décrire un problème PDF dans une issue, l'assigner à l'agent cloud de Copilot, et recevoir une pull request en retour. IronPDF rend HTML, CSS et JavaScript en PDF grâce à un moteur Chromium intégré, et il n'y a pas d'intégration entre les deux produits. Ce qui les connecte est le dépôt et les conventions auxquelles vous vous engagez.

D'abord une distinction, car deux sujets similaires sont en concurrence. Ce guide porte sur l'utilisation d'un assistant de codage IA pour construire des logiciels avec IronPDF. Il ne s'agit pas d'utiliser des modèles d'IA pour lire ou analyser le contenu PDF, ce que le tutoriel de traitement PDF à base d'IA couvre séparément.

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 la solution dans l'IDE où elle se trouve déjà, et demandez le document :

In this C# console project, create Program.cs that uses IronPDF to render
"<h1>Hello from IronPDF</h1>" to hello.pdf. Read the license key from the
IRONPDF_LICENSE_KEY environment variable, never inline. Then build and fix
any errors.
Text

Copilot écrit les quelques lignes qui comptent, en construisant un ChromePdfRenderer, en appelant RenderHtmlAsPdf, et en enregistrant le résultat avec SaveAs. Cette partie n'a rien d'extraordinaire, et ce n'est pas la raison de l'existence de ce guide. Ce qui suit l'est : le même assistant fera ce travail sans que personne ne regarde, sur une branche, en tant que pull request, ce qui change ce que vous devez configurer.

Deux notes de sécurité, toutes deux brèves. Une clé de licence ne doit jamais être incluse en ligne dans une invite ou un commit ; il réside dans la configuration, comme le décrit le guide des clés de licence, ou dans une variable d'environnement ou un secret de dépôt. Et un agent avec un accès en écriture au dépôt ouvre de véritables pull requests, donc la protection des branches et la révision humaine restent les contrôles qui comptent.



Où Copilot s'intègre-t-il dans un projet déjà présent dans Visual Studio ?

Copilot fonctionne à trois portées, et choisir la bonne permet de gagner plus de temps que toute technique d'invite.

Complétions en ligne et chat gèrent tout ce que vous pourriez décrire en une phrase et qui réside dans un seul fichier : ajuster une marge, ajouter un pied de page à un appel de rendu existant, renommer un assistant. Vous décrivez le changement, vous obtenez un diff sur place, vous acceptez ou vous ne le faites pas.

Le mode agent gère le travail s'étendant sur plusieurs fichiers, où Copilot décide quels fichiers modifier, exécute des commandes terminales, lit le résultat et itère sur les erreurs. C'est la bonne portée pour une migration ou un refactor.

L'agent cloud sur GitHub gère le travail qui n'a besoin d'aucune supervision. Vous attribuez une issue, il planifie, pousse une branche et ouvre une pull request. C'est ce qui différencie Copilot d'un assistant lié à un éditeur, et c'est là que le reste de ce guide concentre son attention.

Copilot est aussi un lecteur raisonnable. Lui demander d'expliquer le type d'options de rendu et de lister celles que le projet définit actuellement tourne la référence API en quelque chose que vous pouvez interroger plutôt que faire défiler.

Veuillez noter: Les trois plages ont des rayons d'explosion différents. Une modification en ligne est révisée avant d'atterrir, le mode agent est révisé comme un diff, et le travail de l'agent cloud arrive sous forme de pull request qui peut attendre un jour avant que quelqu'un la lise. Associez la plage à la quantité que vous souhaitez avoir lorsque cela se termine.

Comment engagez-vous des conventions que chaque surface suit ?

Les instructions personnalisées du dépôt sont engagées dans le dépôt, ce qui signifie qu'elles régissent le chat IDE et l'agent autonome de la même manière, y compris lorsque l'agent travaille sans personne pour observer. Écrivez-les une fois, puis arrêtez de vous répéter dans les invites.

Le fichier est .github/copilot-instructions.md. Pour une équipe .NET, c'est le format qui vaut la peine d'être standardisé, car c'est celui que Visual Studio documente pour le chargement, aux côtés de VS Code, JetBrains, l'agent cloud, et la revue de code Copilot. Copilot lit aussi d'autres fichiers d'instructions, AGENTS.md parmi eux, mais le support varie en fonction de la surface de manière à changer d'une version à l'autre, donc le défaut le plus sûr pour un atelier Visual Studio est le fichier nommé d'après le produit.

# Copilot instructions

## PDF generation

- Use IronPDF for all PDF generation. Use ChromePdfRenderer for HTML conversion.
- Target the IronPDF version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONPDF_LICENSE_KEY environment variable.
- Prefer the shared PdfDocumentService helper over constructing a renderer per
  call. A ChromePdfRenderer instance is reusable.
- Use the async rendering methods in web request paths.
- Do not invent IronPDF API names. If a method is uncertain, say so and cite the
  documentation rather than guessing.

## Testing

- Assert on extracted text, page count and the %PDF- signature.
- Never use golden-file byte comparisons; rendering output is not byte-stable.
Text

La phrase concernant l'admission de l'incertitude mérite sa place. Le modèle par défaut est de produire quelque chose de plausible plutôt que d'admettre un écart, et inventer renderer.ConvertHtmlToPdfDocument() semble très bien jusqu'à ce que le compilateur ne soit pas d'accord. Donner la permission d'arrêter est bon marché, et ça fonctionne.

Les instructions spécifiques au chemin dans .github/instructions/**/*.instructions.md ciblent les fichiers correspondants, ce qui empêche les conventions PDF de s'immiscer dans les requêtes qui n'ont rien à voir avec les PDF.

Qu'est-ce qui rend une issue que l'agent peut réellement traiter ?

Ici, la compétence qui compte n'est pas l'écriture d'invites. C'est de l'écriture d'issue, car, selon GitHub, l'agent travaille à partir du titre de l'issue, de la description et des commentaires existants, et ne voit pas les commentaires ajoutés après l'assignation. Personne n'est présent pour le clarifier.

Une issue faible ressemble à cela :

Title: PDF looks wrong

The invoice PDF doesn't look right. Can we fix the layout?
Text

L'agent n'a pas de fichier à ouvrir, aucune idée duquel de plusieurs PDF est visé, pas de description du résultat correct, et aucune erreur à partir de laquelle travailler. Il explorera, devinera et produira une pull request qui pourra traiter complètement la mauvaise chose.

Une strong issue contient tout ce qu'un collègue aurait besoin :

Title: Invoice PDF splits table rows across pages and drops the logo

**Files:** Services/InvoiceRenderer.cs, Templates/invoice.html
**IronPDF version:** as pinned in Directory.Packages.props
**Framework:** .NET 8

**Expected:** A4 portrait, 20mm margins. Line-item table rows stay intact
across page breaks. Company logo renders in the header.

**Actual:** A table row splits between pages 1 and 2. The logo area is blank
in the PDF but renders correctly when Templates/invoice.html is opened in
Chrome. No exception is thrown.

**Constraints:** Fix page-break behavior in CSS, not in C#. Keep the public
signature of InvoiceRenderer.RenderAsync unchanged. No new packages.

**Acceptance:** Existing tests pass, plus a new test asserting page count for
the fixture in TestData/invoice-12-items.json.
Text

Six choses séparent la deuxième de la première : fichiers nommés, la version du framework et de la bibliothèque, le résultat attendu concrètement énoncé, le comportement réel y compris ce qui ne se passe pas, les contraintes strictes et une définition de fin.

Ce détail sur le fait qu'aucune exception n'est levée fait un vrai travail. Cela indique à l'agent qu'il s'agit d'un problème de rendu plutôt que d'un crash, ce qui exclut toute une catégorie d'enquête avant qu'elle ne commence. L'observation que le logo s'affiche dans Chrome mais pas dans le PDF la précise davantage : une chaîne HTML brute ne porte pas de localisation de document, donc les chemins d'image relatifs se résolvent par rapport au répertoire de travail du processus au lieu du dossier du modèle, tandis qu'un navigateur sait d'où vient la page.

Une fois attribué, l'agent planifie, pousse une branche, ouvre une pull request et demande une révision. Vous examinez le diff plutôt que de regarder le travail.

Pourquoi les tests de l'agent échouent-ils sur un projet IronPDF?

C'est la section qu'aucun guide général de Copilot n'écrira, et c'est celle qui est la plus susceptible de vous faire gagner un après-midi.

L'agent cloud construit et teste dans son propre environnement éphémère. Pour la plupart des projets, la source plus une restauration de package suffisent. Un projet IronPDF nécessite plus, car le rendu dépend d'un moteur Chromium avec des dépendances natives de la plate-forme. Si elles sont absentes de l'exécuteur Linux de l'agent, chaque test qui rend un PDF échoue, pour des raisons qui n'ont rien à voir avec le code que l'agent vient d'écrire.

La conséquence est pire qu'une construction rouge. Laissant l'agent trouver et installer lui-même les dépendances manquantes, il fonctionne par essais et erreurs, ce que la documentation de GitHub qualifie de lent et peu fiable.

La solution est de préconfigurer l'environnement avec .github/workflows/copilot-setup-steps.yml. Cela ressemble à un workflow GitHub Actions ordinaire avec deux règles faciles à manquer : le job doit être nommé copilot-setup-steps, et le fichier ne se déclenchera pas du tout à moins qu'il n'existe sur la branche par défaut de votre dépôt.

name: "Copilot Setup Steps"
on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  # The job MUST be called `copilot-setup-steps` or Copilot will not pick it up.
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '8.0.x'
      # Install the native dependencies IronPDF's Chromium engine needs on
      # Debian-based images. Take the current package list from the Docker
      # and Linux deployment guide rather than copying one from anywhere else,
      # because it changes between releases.
      - name: Install IronPDF native dependencies
        run: |
          sudo apt-get update
          sudo apt-get install -y <packages from the IronPDF Linux guide>
      - run: dotnet restore
Text

Deux détails décident si cela fonctionne.

Premièrement, une clé de licence n'est pas automatiquement disponible pour l'agent. Les Actions GitHub, Codespaces et les secrets Dependabot ne sont pas disponibles pour une session d'agent, donc la clé doit être ajoutée séparément comme un secret d'agents dans les paramètres du dépôt ou de l'organisation.

Deuxièmement, et c'est celui qui produit le symptôme déroutant : si une étape de configuration échoue, Copilot ne s'arrête pas. Il saute les étapes restantes et commence à travailler avec l'état actuel de l'environnement. Une installation de dépendance échouée silencieusement ressemble donc exactement à un problème de code. Exécutez le workflow manuellement depuis l'onglet Actions une fois avant de vous y fier.

Conseils: La règle pratique : lorsqu'une demande de tirage d'un agent cloud présente des tests de rendu échoués sur un projet IronPDF, vérifiez l'environnement avant de supposer que la modification est erronée. Le guide de déploiement Docker documente les dépendances, qui changent entre les versions et doivent être lues plutôt que rappelées.

Que faut-il vérifier avant de fusionner ?

La pull request est la surface de révision, et les mêmes normes s'appliquent qu'à la branche de n'importe quel collègue. La propre révision de code de Copilot peut s'exécuter en tant que seconde passe sur la production de l'agent, ce qui attrape les problèmes mécaniques avant qu'un humain ne lise le diff.

Trois vérifications comptent spécifiquement pour les changements IronPDF :

  1. Chaque nom d'API apparaît-il dans la documentation, ou quelque chose de plausible a-t-il glissé ?
  2. Le PDF généré a-t-il vraiment l'air correct ? Une build propre ne dit rien sur la mise en page.
  3. Le changement est-il resté dans les limites définies par l'issue ?

Demander des tests dans la même pull request vaut mieux en faire une norme :

Add xUnit tests for this change: output is non-empty, begins with the %PDF-
signature, extracted text contains the bound company name, and page count
matches the fixture. No golden-file byte comparisons.
Text

Écarter la comparaison de bytes évite une classe de test instable qui coûterait autrement un après-midi, car deux rendus du même HTML dans des processus séparés diffèrent dans leurs horodatages et l'ID du document.

Quand est-ce le code, et quand est-ce le conteneur ?

Trois causes documentées de différences de rendu entre le navigateur et le PDF sont une feuille de style écrite pour le média écran plutôt que pour l'impression, une police web qui ne s'est pas chargée lorsque la mise en page a été calculée, et du contenu produit par JavaScript qui a été capturé trop tôt. Les trois sont côté code, et les trois valent la peine d'être nommés dans la demande :

Templates/report.html renders correctly in Chrome but the PDF splits a table
row across pages and the totals block lands on the next page alone.

Explain the cause before changing anything, then fix it in the CSS using page
break properties. Do not modify ReportRenderer.cs.
Text

Demander un diagnostic avant un changement vous offre quelque chose à évaluer plutôt qu'une solution à rétroconcevoir. Le comportement de coupure de page appartient à la feuille de style, et le guide sur les coupures de page couvre les propriétés pertinentes. Limiter le changement au CSS empêche un agent de résoudre un problème de mise en page en restructurant le C#.

L'autre moitié de la question est celle à laquelle la section précédente a répondu : lorsque le même code se rend localement et échoue dans un conteneur ou sur un exécuteur, ce n'est généralement pas le code du tout. Collez l'exception complète plutôt que de la paraphraser, et orientez la demande vers le Dockerfile plutôt que vers l'application. Une bibliothèque partagée manquante n'est pas un problème C#.

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

Les trois invites et les deux corps de issues sur cette page ont été exécutés dans l'ordre, sans surveillance, avec GitHub Copilot CLI 1.0.95, qui a routé chaque tour vers GPT-6 Luna. Le fichier d'instructions et le workflow des étapes de configuration ont été engagés tels quels. Les chiffres ci-dessous proviennent de vérifications indépendantes des fichiers laissés par l'exécution.

  • L'invite de démarrage rapide a produit un Program.cs de 13 lignes qui lit la clé à partir de IRONPDF_LICENSE_KEY et s'est construit sans erreurs ni avertissements.
  • L'agent n'a pas exécuté le programme.
  • Exécuté avec la clé, le programme a enregistré un hello.pdf d'une page de 17 385 octets.
  • Avant l'exécution des issues, la facture a réparti un élément sur les pages 1 et 2 et ne contenait pas d'image.
  • L'issue forte a produit une facture de deux pages avec chaque ligne complète et le logo sur la page 1.
  • L'agent a intégré le logo en tant qu'URI de données en C# et a corrigé les sauts de page dans le CSS.
  • La signature publique de InvoiceRenderer.RenderAsync est restée inchangée, et aucun package n'a été ajouté.
  • Le nouveau test a affirmé deux pages pour le fixture de 12 éléments, et les 3 tests ont réussi.
  • L'agent a ajouté une règle pour répéter l'en-tête de tableau et a rapporté qu'il se répétait. La page 2 de la facture rendue ne comportait pas de ligne d'en-tête.
  • L'issue faible a également corrigé les deux défauts, bien qu'elle n'ait nommé aucun fichier ni symptôme spécifique.
  • Le même changement a réécrit toute la feuille de style et réduit le texte du corps de 13 à 11 pixels.
  • La demande de tests a ajouté un contrôle non vide et un contrôle du nom de l'entreprise aux tests existants, donc le compte est resté à 3, et aucun n'a comparé les bytes.
  • L'invite de rapport a nommé le saut de page forcé avant les totaux et la règle de ligne manquante comme les causes avant de modifier le CSS.
  • Le rapport corrigé tenait sur 2 pages au lieu de 3, sans fractionner la ligne et les totaux sous les quatre derniers sites. ReportRenderer.cs est resté inchangé.
  • L'agent n'a jamais listé les variables d'environnement, et la clé n'apparaissait dans aucune transcription, commit ou fichier de session Copilot.
  • Certaines étapes ont été exécutées différemment de la page. Le dépôt n'avait pas de remote GitHub, donc la CLI a remplacé l'agent cloud et chaque issue a démarré une nouvelle session. La demande de tests s'est adressée à la session de l'issue forte au lieu d'un commentaire de pull request. Le workflow des étapes de configuration n'a pas été exécuté, car cette machine ne dispose pas d'un exécuteur GitHub Actions ni d'un environnement Linux.

La facture après l'issue forte, rendue par le InvoiceRenderer de l'exécution à partir du fixture de 12 éléments.

Le rapport après la correction CSS de l'invite de rapport, rendu par le ReportRenderer de l'exécution.

La version Copilot CLI, le modèle et le timing pour cette exécution sont listés dans l'enregistrement de l'exécution.

Qu'est-ce qui continue de fonctionner quand personne ne regarde ?

Deux choses, et ce sont les deux qui valent la peine d'être mises en place en premier. Les instructions engagées dans .github/copilot-instructions.md régissent l'agent sur une branche à minuit exactement comme elles régissent votre IDE à midi. Un copilot-setup-steps.yml qui installe les dépendances natives d'IronPDF est ce qui évite à cet agent d'avoir à les trouver et les installer par essais et erreurs. Tout le reste est une utilisation ordinaire de l'assistant qui fonctionne mieux une fois que ces deux éléments existent.

L'habitude de vérification ne change pas avec l'étendue : construisez tôt, ouvrez le PDF, et vérifiez les noms d'API par rapport à la documentation avant que quoi que ce soit ne soit expédié. La version reproductible de cette vérification, exécutée du début à la fin avec un résultat publié, se trouve sur le guide des assistants de codage IA, aux côtés des guides pour Claude Code, ChatGPT Codex, et Cursor.


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é