GitHub Copilotを使用したIronPDFの使い方

Curtis Chau
Curtis Chau
更新日: 2026年10月26日

AI支援コーディングの多くのガイドは、エディタを変更する意欲があることを前提としています。 .NETの作業では、その前提はしばしば間違っています。 IronPDFのプロジェクトはVisual Studio内のソリューションに存在し、プロジェクト参照、NuGetの構成、移動したくないビルドパイプラインが含まれています。

GitHub Copilotはこれらのプロジェクトがすでに存在する場所で動作します。Visual Studio、VS Code、JetBrainsのIDEでこのワークフローを使用するには移行が不要です。 それはエディターオンリーアシスタントができないことも行います:GitHub自体の内部で動作します。 PDFの問題をイシューで説明し、それをCopilotのクラウドエージェントに割り当ててプルリクエストを受け取ることができます。IronPDFは埋め込みのChromiumエンジンを通じてHTML、CSS、およびJavaScriptをPDFにレンダリングしますが、2つの製品間に統合はありません。 それらをつなぐのはリポジトリであり、そこにコミットする規約です。

最初に1つの区別、なぜなら2つの類似したトピックが競争しているからです。 このガイドは、IronPDFを使用してソフトウェアを構築するためのAIコーディングアシスタントの使用についてです。 これは、AIモデルを使用してPDFコンテンツを読み取ったり分析したりすることについてではありません。「AI支援のPDF処理チュートリアル」で個別に説明されます。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronPdf

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronPDFをインストールします。

すでに存在するIDEでソリューションを開き、ドキュメントを要求してください:

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は重要な数行を書き、ChromePdfRendererを構築し、RenderHtmlAsPdfを呼び出し、結果をSaveAsで保存します。 その部分はさして目立ちませんし、そのためこのガイドがあるわけでもありません。 続くのは次の通りです:同じアシスタントが誰も見ていない状態で、ブランチで、プルリクエストとしてこの作業を行い、それがセットアップする必要のあるものを変えます。

2つの安全メモ、どちらも短いです。 ライセンスキーはプロンプトやコミット内にインラインで属することはなく; それは構成の中に存在し、ライセンスキーガイドが説明するように、環境変数やリポジトリシークレットにも存在します。 そしてリポジトリへの書き込み権限を持つエージェントが実際のプルリクエストを開くので、ブランチ保護とヒューマンレビューは引き続き重要な管理手段です。



Copilot は既に Visual Studio にあるプロジェクトにどのようにフィットしますか?

Copilotは3つの範囲で機能し、適切なものを選ぶことでどんなプロンプト技術よりも多くの時間を節約できます。

インライン補完とチャットは、文で説明できるものと単一ファイルに存在するものに対応:マージンの調整、既存のレンダラ呼び出しにフッターを追加、ヘルパーの名前変更。 変更を説明し、差分がその場で発生し、それを受け入れるかどうかを選択します。

エージェントモードは、いくつかのファイルにまたがる作業を処理し、Copilotが編集するファイルを決定し、ターミナルコマンドを実行し、出力を読み、エラーについて反復します。 これは移行やリファクタリングに最適な範囲です。

GitHub上のクラウドエージェントは、監視が全く必要ない作業を処理します。 issueを割り当て、計画し、ブランチを押し、プルリクエストを開く。これがCopilotをエディターバウンドアシスタントから区別するもので、このガイドの残りが注目しています。

Copilotも合理的な読者です。 レンダリングオプションのタイプを説明し、プロジェクトが現在設定しているものをリストするように頼むと、「APIリファレンス」がスクロールではなくクエリ可能なものに変化します。

注意してください: 3 つの範囲には異なる爆破半径があります。 インライン編集はそれが着地する前にレビューされ、エージェントモードは差分としてレビューされ、クラウドエージェントの作業はプルリクエストとして届き、誰かが読むまで1日座っていることがあります。 範囲が終了するときに保持したい量に合わせて範囲を選んでください。

どのようにしてすべての面に従った規範をコミットしますか?

リポジトリのカスタムインストラクションはリポジトリにコミットされており、これはエージェントが人に見られずに働く場合も含めて、IDEチャットや自律エージェントを統制することを意味します。 一度書いたら、プロンプトで繰り返すのを止めます。

ファイルは.github/copilot-instructions.mdです。 これは.NETチームにとってフォーマットを標準化する価値があり、Visual Studioのドキュメントでロードされる方法に記載され、VS Code、JetBrains、クラウドエージェント、およびCopilotコードレビューに沿ってあります。 Copilotは他のインストラクションファイルも読みますが、AGENTS.mdを含み、サポートはリリースごとに変わる方法でサーフェスごとに異なるため、Visual Studioショップにとって最も安全なデフォルトは製品の名前を持つファイルです。

# 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

不確実性を認める行はその場所にふさわしい。 モデルのデフォルトはギャップを認めるよりむしろ信じられる形を生成することであり、renderer.ConvertHtmlToPdfDocument()を発明することでコンパイラが異議を唱えるまで完璧に読み取られます。 止まることを許可することは安価で、それが機能します。

.github/instructions/**/*.instructions.md内のパス固有のインストラクションは、該当するファイルへの指針を構成し、PDFに関連しない要求からPDF規約を排除します。

エージェントが実際に行動できる問題とは?

ここで重要なのはプロンプト作成ではありません。 イシューのライティングです。GitHubによると、エージェントはイシューのタイトル、説明、および既存のコメントから作業を行い、割り当て後に追加されたコメントは見えません。 それを明確にするために誰も存在しません。

弱いissueはこのように見えます:

Title: PDF looks wrong

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

エージェントは開くためのファイルがなく、どのPDFが意図されているのかまったくわからず、正しい出力の説明もなく、作業するエラーもありません。 それは探索し、推測し、まったく間違ったことをアドレスするプルリクエストを生成する可能性があります。

強いissueには、同僚が必要とするすべてが含まれています:

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

2番目のものと最初のものを分けるのは6つのこと:名前付きファイル、フレームワークとライブラリのバージョン、具体的に述べられた期待される出力、実際の動作が何もしないことを含むことを述べる、厳しい制約、完了の定義。

例外がスローされていないという詳細は実際の作業をします。 それはエージェントに、これはクラッシュではなくレンダリングの問題であることを伝え、開始前に調査の全カテゴリーを除外します。 ロゴがChromeでレンダリングされるがPDFではないという観察は、さらに詳しくします。生のHTML文字列にはドキュメントの位置が含まれていないため、相対画像パスはプロセス作業ディレクトリに対して解決されますが、ブラウザはページがどこから来たかを知っています。

割り当てられると、エージェントは計画し、ブランチを押し、プルリクエストを開き、レビューをリクエストします。 作業を見るのではなく、差分をレビューします。

なぜエージェントのテストがIronPDFプロジェクトで失敗するのですか?

これは一般的なCopilotガイドが書かないセクションであり、最も午後を節約する可能性があります。

クラウドエージェントはその独自の短命な環境でビルドおよびテストを行います。 ほとんどのプロジェクトでは、ソースプラスパッケージの復元が十分です。 IronPDFプロジェクトにはもっと必要で、レンダリングにはネイティブプラットフォーム依存関係を持つChromiumエンジンが依存します。 それらがエージェントのLinuxランナーに欠けている場合、PDFをレンダリングするすべてのテストが失敗します。それはエージェントが書いたばかりのコードとは無関係です。

その結果は赤いビルドよりも悪いです。 失われた依存関係を自ら見つけ出してインストールするままにして、エージェントは試行錯誤によって作業します。これをGitHubのドキュメントは遅くて信頼性がないと呼びます。

修正は.github/workflows/copilot-setup-steps.ymlで環境を事前に設定することです。 通常のGitHub Actionsワークフローのように見えますが、見逃しやすい2つのルールがあります:ジョブはcopilot-setup-stepsと名付けなければならず、ファイルがリポジトリのデフォルトブランチに存在しない限り全くトリガーしません。

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

2つの詳細がこれが機能するかどうかを決定します。

まず、ライセンスキーはエージェントに自動的に利用可能ではありません。 GitHub Actions、Codespaces、Dependabotの秘密はエージェントセッションでは使用できないため、キーハーにリポジトリまたは組織設定内のエージェントの秘密として別に追加する必要があります。

2つ目、これが混乱を引き起こす症状を生むものです:セットアップステップが失敗した場合、Copilotは停止しません。 残りのステップをスキップし、環境がどんな状態であれ作業を始めます。 静かに失敗した依存関係のインストールは、コード問題とまったく同じように見えます。 それを頼る前に、アクションタブからワークフローを手動で実行してください。

ヒント: 実用的なルール:クラウドエージェントのプルリクエストでIronPDFプロジェクトのレンダリングテストが失敗している場合、環境を確認してから変更が間違っていると仮定してください。 Docker デプロイメントガイドは、リリース間で変わる依存関係を文書化しており、記憶に頼るのではなく読んで確認すべきです。

マージする前に何を確認すべきですか?

プルリクエストはレビュー面であり、同じ基準が他の同僚のブランチにも適用されます。 Copilot自体のコードレビューはエージェントの出力の2番目のパスとして実行され、人間が差分を読む前に機械的な問題を捕捉します。

特にIronPDFの変更に対して重要な3つのチェックがあります:

  1. API名がすべてドキュメントに表示されますか、 それとも信じられそうなものが通り抜けましたか?
  2. 生成されたPDFは実際に正しく表示されていますか? クリーンなビルドはレイアウトについて何も示しません。
  3. 変更はイシューが設定した制約内で行われましたか?

同じプルリクエストでテストを要求することは標準として価値があります:

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

バイト比較を排除することによって、通常午後を費やすフレークテストのクラスを防ぎます。なぜなら、同じHTMLの2つのレンダリングは個別のプロセスでのタイムスタンプとドキュメントIDが異なるためです。

それはコードであり、それはコンテナですか?

ブラウザとPDF間のレンダリングの違いの3つの原因が文書化されています:画面ではなく印刷メディア用に書かれたスタイルシート、レイアウトが計算される際に読み込まれなかったWebフォント、および早すぎる段階でキャプチャされたJavaScriptによって生成されたコンテンツです。 すべて3つはコードサイドであり、要求内で名指しする価値があります:

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

変更の前に診断を要求することで、逆エンジニアリングするための修正ではなく評価するための何かを手に入れます。 ページブレーク動作はスタイルシートに入れ、ページブレークガイドが関連するプロパティをカバーしています。 変更をCSSに制約することで、エージェントがレイアウト問題をC#の構造変更で解決することを防ぎます。

質問のもう半分は、前のセクションが回答したものです:同じコードがローカルでレンダリングされ、コンテナやランナーで失敗する場合、それは通常コードではありません。 全文の例外をパラフレーズせずに貼り付け、要求をアプリケーションではなくDockerfileに向けます。 欠けている共有ライブラリはC#の問題ではありません。

プロンプトが実運用で生成したものは何ですか?

このページの3つのプロンプトと2つのイシュー本文は順に実行され、未監視でGitHub Copilot CLI 1.0.95でそれぞれのターンをGPT-6 Lunaにルーティングしました。 インストラクションファイルとセットアップ手順ワークフローは書かれたままコミットされました。 以下の数字は実行が残したファイルの独自のチェックから得たものです。

  • クイックスタートプロンプトは、IRONPDF_LICENSE_KEYからキーを読み取り、エラーや警告なしでビルドされた13行のProgram.csを生成しました。
  • エージェントはプログラムを実行しませんでした。
  • キーを使って実行された場合、プログラムは1ページのhello.pdfを17,385バイト保存しました。
  • イシューが実行される前、請求書は1と2ページに行アイテムを分け、画像を含みませんでした。
  • 強いイシューでは、すべての行アイテムが完全であり、ロゴが1ページ目にある二ページの請求書を生成しました。
  • エージェントはC#でのデータURIとしてロゴを埋め込み、CSSでページ区切りを修正しました。
  • InvoiceRenderer.RenderAsyncの公開署名は変更されず、パッケージも追加されませんでした。
  • 新しいテストでは12アイテムフィクスチャの2ページをアサートし、すべての3つのテストが合格しました。
  • エージェントはテーブルのヘッダーを繰り返すルールを追加し、それが繰り返されたと報告しました。 レンダリングされた請求書のページ2にはヘッダ行が含まれていませんでした。
  • 弱いイシューもまた両方の欠陥を修正しましたが、ファイルや特定の症状を指定しませんでした。
  • 同じ変更はスタイルシート全体を再構築し、本文の文字を13ピクセルから11ピクセルに減少させました。
  • テストプロンプトは既存のテストに非空チェックと会社名のチェックを追加し、カウントは3のままで、バイト比較は行われませんでした。
  • レポートプロンプトはCSSを編集する前に合計前の強制ページ区切りと欠落した行ルールを原因として挙げました。
  • 修正されたレポートは3ページではなく2ページに収まり、行が分割されず、合計は最後の4つのサイトの下にありました。 ReportRenderer.csは変更されませんでした。
  • エージェントは環境変数をリストしなかったし、キーはトランスクリプトやコミット、Copilotセッションファイルに現れませんでした。
  • 一部のステップはページと異なる方法で実行されました。 リポジトリにはGitHubのリモートがなかったため、CLIがクラウドエージェントの代わりを務め、各イシューが新しいセッションを開始しました。 テストリクエストは、プルリクエストコメントではなく、強いイシューのセッションに送られました。 このマシンにはGitHub ActionsランナーもLinux環境もないため、セットアップ手順ワークフローは実行されませんでした。

強いイシュー後の請求書は、実行のInvoiceRendererが12アイテムフィクスチャからレンダリングしました。

レポートプロンプトからのCSS修正後のレポートは、実行のReportRendererによってレンダリングされました。

この実行のCopilot CLIバージョン、モデル、タイミングは実行記録に記載されています。

誰も見ていないときに動作し続けるものは何ですか?

2つのタイミングで、最初に設定する価値のあるものです。.github/copilot-instructions.mdにコミットされた指示は、あなたのIDEを正午に支配するのと同様に、真夜中にブランチ上のエージェントを支配します。 IronPDFのネイティブ依存性をインストールするcopilot-setup-steps.ymlが、同じエージェントが試行錯誤でそれを見つけ出しインストールするのを免れます。 他のすべては、これら2つが存在することによってより良く動作する通常のアシスタントの使用法です。

検証習慣は範囲によって変わりません:早期に構築し、PDFを開き、送信する前にAPI名をドキュメントと照らし合わせて確認してください。 そのチェックの再現可能なバージョンは、公開された結果を伴って初めから終わりまで実行され、AIコーディングアシスタントのガイドにあり、Claude Code、ChatGPT Codex、Cursorのガイドと並んでいます。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 22,198,312バージョン:2026.11ちょうどリリースされました