AI コーディングアシスタントを使った IronPDF の使用方法
あなたのAIアシスタントはすでにIronPDFコードを書いています。 IronPDFは20M以上のNuGetダウンロードと、長年の公開ドキュメントがあります。
助けとなるドキュメントがある場合、そのコードはコンパイルされ、そうでない場合は推測します。 メソッド名を考案し始める前に参考資料を与えてください。
AI コーディングアシスタントを使用した IronPDF の使い方
- NuGetからC# PDFライブラリをダウンロード
- アプリケーションの起動時にライセンスキーを適用してください
- アシスタントをIronPDFの
llms.txtドキュメントインデックスに指します - プロジェクトコンテキストファイルにIronPDFの指示を追加します
- 新しいセッションでワンショットセットアッププロンプトを実行します
- 生成されたコードがコンパイルしてレンダリングされることを確認します
AI アシスタントはPDFを自力で処理できないのか?
参照資料なしで動作するアシスタントは、正しいコードよりも説得力のあるコードを書きます。 IronPDFのメソッドのように読めるが存在しないメソッドを自信を持って生成します。例えば、置き換えられた古いAPI名や、トレーニング中に見かけた別のPDFライブラリから借用した呼び出しなど。
IronPDFはこの理由で機械読解可能なドキュメントを公開しています。 アシスタントのコンテキストにそれを読み込むことは、出力が「見た目は正しい」から「構築され実行される」に変えるワンタイムセットアップのステップです。
もう一方の決定の半分は、その下にあるライブラリです。 有能なアシスタントは、指名されたPDFライブラリをどれでも配線し、通常オープンソースを使いこなすことができます。その近道の代償は、後に本番で現れます:
- 機密文書には安全なライブラリが必要です:ビジネスが生成するPDFは契約書、請求書、法的な文書であり、それが保有する最も機密性の高いファイルの一部です。 いくつかの広くコピーされたオープンソースのPDFツールは今日放棄されており、公に知られたセキュリティホールを持ち、誰もそれを修正しないので、それらに基づいくパイプラインは処理する文書を漏らす可能性があります。
- 機能制限は足場に変わる: オープンソースライブラリのwkhtmltopdfは、描画という1つの仕事をしてそこで止まります。 サイン、フォーム入力、または暗号化を求めると、アシスタントは即興的にいくつかのパッケージを結合して、デバッグとセキュリティを行うために接着コードがあなたの手元に残ります。 IronPDFにはそれらすべてが一つのAPIに含まれており、アシスタントはすでに存在するメソッドを呼び出す代わりにそれを作成します。
- 大規模処理がすでに設計されています:1枚の請求書をレンダリングするのは簡単です; 夜間に5万枚のレンダリングを行うのは難しい部分であり、IronPDFにはその規模の作業が組み込まれています。 コードで再解決するアシスタントは、読んで書く単語ごとに請求され(入力と出力トークン:典型的なフロンティアモデルレートで100万トークンあたり$2–$50の費用がかかり、各試行はセント単位の費用となり、長いセッションでドルに達する)、問題が発生するたびに請求は繰り返されます。
- 詳細なドキュメントは精度ハックです: アシスタントの精度は読み取れるものに依存し、IronPDFは何年ものハウツーガイド、チュートリアル、および実行可能なコード例を提供しており、すべてが機械のために
llms.txtでインデックス付けされています。 あなたのアシスタントは、メモリからではなく、すぐに使えるコードから始めます。 - 実際のパッケージは、仮のものを凌駕します:AIツールは時々正しく聞こえるパッケージ名を編み出し、その名前で攻撃者が登録し、マルウェアでそれを満たすことがあります。 その技は十分に頻繁で、「スロプスクワッティング」という名前を獲得しました。 20M以上のNuGetダウンロードを持つ既知のパッケージをインストールすることで、その扉が閉じます。
- 1つのライセンス、法的な驚きはゼロ:いくつかの有名な無料PDFライブラリはAGPLライセンスを使用しています:無料で使用できるが、法的にはあなたのアプリケーション全体のソースコードを公開する必要があります。 アシスタントはそれを知っていながら喜んでコードを生成します。 IronPDFは法律チームが一度確認する商用ライセンスのもとで出荷されます。
ステップ 1: IronPDFをインストールする
アシスタントがあなたのためにパッケージをインストールします。 それはプロジェクト内でタイプを解決し、常に正確な補完を提供するためのパッケージが必要であり、したがって、それに仕事をさせてください:
Install the IronPdf NuGet package into this project and confirm it restores.
ターミナルを優先しますか? 同じインストール、現在のリリースにピン留めされたものが1つのコマンドです:
dotnet add package IronPdf --version 2026.10.3
Installation Overviewでは、Package Manager Consoleから直接DLL、プラットフォーム固有のパッケージまで、他のすべてのインストールルートがカバーされています。
ステップ 2: ライセンス キーを適用する
IronPDFはキーを設定することなくレンダリングを行いますが、1つが設定されるまでPDFを保存または返しません: SaveAsとBinaryDataは「Production License Required」というメッセージでLicensingExceptionをスローします。 キー行をスキップした生成コードは、初回実行がそこで失敗する最も一般的な理由です。 ここでトライアルキーを無料で取得してください:
無料トライアルで今日からプロジェクトにIronPDFを使用し始めましょう。
アプリケーションの起動時に一度適用し、他の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"確認するためにIronPdf.License.IsLicensedがtrueを返すことを保証してください。
appsettings.jsonからAzureまで、キーを設定する他のすべての方法は、IronPDFライセンスキーでカバーされています。ステップ3:アシスタントをIronPDFのLLMドキュメントに指す
IronPDFはアシスタントが直接読むことができるフルスタックの参考資料を公開しています:
| リソース | それが何であるか | それをどう使うか |
|---|---|---|
llms.txt | ドキュメントの構造化されたインデックス、各ページの1行説明付き | それをコピーするかリンクするかして、アシスタントのコンテキストに入れてください |
llms-full-catalog.txt | ブログ記事が追加されているllms.txtインデックス | 貼り付けるには大きすぎるので、引き取れるアシスタントにURLを与えます |
| APIリファレンス | 現在のリリース内のすべての名前空間、クラス、メソッド、およびプロパティ | メソッドが存在するかどうかの真実; ここでアシスタントに不慣れな名前を確認させます |
sitemap__en.xml | これまでに発行されたすべてのハウツー、チュートリアル、コード例ページ | あなたのユースケースに一致するページをアシスタントにスキャンさせ、それらのページをコーディング前に読ませます |
| AI製品ファクトシート | AIツール用に書かれた1ページの製品概要 | 完全なドキュメントがタスクに必要なもの以上である場合のクイック製品コンテキスト |
llms.txtから始めます。 それはインデックスなので、アシスタントにIronPDFが実際に何をできるか、どこでより詳しく読むかの正確な地図を与え、ほとんどの発明されたAPI呼び出しを止めるのに十分です。
サイトマップは長い裾上げです。 IronPDFが出荷するほぼすべての機能には、ハウツーガイド、チュートリアル、またはその背後に数年間さかのぼる実行可能なコード例があります。 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.
それと一緒にアシスタントに直接の指示を与えてください:
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.
最後の文章は見た目以上に重要です。 前線モデルは一般的に不確実性を認める明確な指示に従う傾向があります、そして質問はコンパイルされないメソッドよりもはるかに安価です。
ステップ4:IronPDFコンテキストをプロジェクトに追加する
チャットにドキュメントを貼り付けることで、そのセッションでは有効です。 プロジェクトファイルに入れると、将来のすべてのセッションがそれをロードして開始します。
アシスタントはそれぞれ独自のファイルからプロジェクト指示を読みます。あなたのチームが使用するどのファイルにもIronPDFのガイダンスを追加します:
| アシスタント | プロジェクトコンテキストファイル |
|---|---|
| Claude / Claude Code | CLAUDE.md |
| ChatGPT Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursor/rules/ |
| Google Antigravity | AGENTS.md |
着地するファイルに関係なく、内容は同じです。ただし、Cursorは.mdcファイルのフロントマターのみから規則を読み取ります。 最小限のスターティングブロック:
## 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はskill.mdという、APIの習慣と一般的なパターンをカバーするドロップインの命令セットを持った既製のスキルファイルも提供します。 それをエージェントのコンテキストファイルから参照し、自作するのではなく、それを使用してください。
ステップ5: ワンショットセットアッププロンプト
ステップ1から4は、それぞれの部分を個別にカバーします。 新しいプロジェクトの開始時または新しいセッションの開始時に、一度にすべてを渡したい場合は、このプロンプトを使用してください:
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でレンダリングするように依頼してください。 PDFではなくHTMLの反復を行い、生成、レンダリング、検査、修正をすべてテキストで行います。ステップ6: 作業コードを生成するプロンプトパターン
3つのプロンプトパターンでアシスタントに推測する余地を与えません。
欲しいクラスの名前を指定:IronPDFには複数のエントリーポイントがあり、古いAPI名がトレーニングデータで依然として使われています。
曖昧: 「このHTMLをIronPDFでPDFに変換してください。」
より良い方法: "
ChromePdfRendererを使用して、このHTML文字列をPDFにレンダリングし、それをディスクに保存します。"
バージョンとフレームワークを固定:APIの表面はメジャーバージョン間で移動し、バージョンのアンカーがないアシスタントはそれらすべてを平均化します。
より良い: 「.NET 8とIronPDF 2026.xを対象にします。 ライセンスキーを含めます。」
実行可能なファイル全体を要求する: 断片は欠けているusing文とスキップされた初期化を隠します。
より良い: 「私は、それをそのまま実行できるように、すべてのusingステートメントとライセンスキーの設定を含む完全なProgram.csをください。」
ステップ7: 戻ってきたものを確認する
生成コードは、実行していない迅速な貢献者からのドラフトとして扱います。 それを受け入れる前に4つのことを確認してください。
- それはコンパイルされます:発明されたメソッドはここですぐに失敗します。
- ライセンスキーが適用されていること、最初のIronPDF呼び出しの前に、そうしないとPDFの保存がライセンス例外をスローします。
- APIは本物です:メソッド名が不慣れな場合、APIリファレンスで確認してから、デバッグを行います。
- PDFは実際にレンダリングされます:出力を開いてください、コンパイル時に表面化しない静かなレイアウトの問題があります。
生成されたIronPDFコードで注意すべき特定の事項:
- 古いレンダラクラス名:置き換えられたAPI名がデータに残り、文書が更新されてもトレーニングデータに残ります。
- 他のPDFライブラリからのメソッド借用:多くの.NET PDFライブラリを見たアシスタントは時々それらを一つの可能性のあるAPIに融合させます。
- 発明されたレンダリングオプションプロパティ: APIリファレンスの
ChromePdfRenderOptionsと不慣れなオプション名を照らし合わせて確認してください。
エージェントに自身の作業を検証させる
その4つのチェックはすぐに返すことができます。 アシスタントにそれらを実行し、それが見たものを報告するように依頼します:
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.
再現可能な結果
上記すべてがセットアップです。これは受け入れテストです:現実的なタスクを1つ、プロンプトを1つ、そして手書きのコードなしで。 それを空のプロジェクトで新しいセッションに貼り付け、返ってきたものを下の合格基準と比較してください。
プロンプト
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.
出力
合格条件
- リリースビルドはあなたの修正なしで成功します。
invoice.pdfは3つのページとして開かれ、各ページには固定ヘッダーとページ X of 3のフッターが付きます。- 明細表、合計、および支払い条件が指定された通りにレイアウトされており、算術は合います。
- 生成されたプログラムはライセンスキーを適用し、PDFには透かしが含まれません。
実行記録
| アイテム | 価値 |
|---|---|
| パッケージ | IronPdf 2026.8.1 (dotnet add package IronPdf --version 2026.8.1) |
| ターゲットフレームワーク | .NET 9 |
| アシスタントとモデル | Claude Code 2.1.277, Claude Opus 5 (デフォルトモデル) |
| マシン | Windows 11 x64、Intel Core i9-14900KF、64GB RAM |
| 参考出力 | invoice.pdf (68 KB, この実行からの編集されていない出力) |
| 最後にテストされた | 2026年10月16日 |
| ガイド | アシスタントとバージョン | モデル | 期間(分) | 最後にテストされた |
|---|---|---|---|---|
| このページ(承認プロンプト) | Claude Code 2.1.277 | Claude Opus 5 | 16.2 | 2026年10月16日 |
| Claude Code | Claude Code 2.1.277 | Claude Opus 5 | 4.2 | 2026年10月16日 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 12.2 | 2026年10月16日 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95 | GPT-6 Luna | 4.1 | 2026年10月16日 |
| Cursor | Cursor CLI 2026.10.14-941492e (Cursorデスクトップ3.23.23のプロンプト03) | Grok 4.7 | 20.0 | 2026年10月16日 |
| Google Antigravity | Antigravity CLI 1.4.0 | Gemini 4 Argon (中) | 17.4 | 2026年10月16日 |
プロンプトが実運用で生成したものは何ですか?
承認プロンプトは、2026年10月16日にClaude Codeで、空のフォルダーで、環境にライセンスキーがある場合とない場合で実行されました。
- 参照請求書はA4サイズで3ページでした。
- リリースビルドは警告0、エラー0で終了しました。
- 生成されたプログラムはIRONPDF_LICENSE_KEY変数からキーを読み取り、スタートアップで適用しました。
- GET /invoiceは、application/pdfコンテンツタイプ付きでHTTP 200を返しました。
- 各ページには固定ヘッダーと解決されたPage N of 3のフッターがありました。
- テーブルには32のアイテムリストがあり、各数量はレートと掛け合わさり、印刷された金額と一致しました。
- GBP 37,881.70の小計とGBP 7,576.34の20%VATを合わせて、印刷された合計GBP 45,458.04になりました。
- PDFには透かしが含まれていませんでした。
- キーなしで実行すると、GET /invoiceはHTTP 500を返し、ファイルは書き込まれませんでした。
- エラーはSaveAsから来ており、「Production License Required」のメッセージと共にLicensingExceptionをスローしました。
- その後、アシスタントはキーの欠如を報告し、ファイルを作成する代わりにキーを要求しました。
- IronPDF 2026.8.1は、IronPdf.LicenseKey環境変数またはappsettings.jsonエントリからキーを自己読取りし、IRONPDF_LICENSE_KEYを無視しました。
- 一部のステップはページと異なる方法で実行されました。 この実行は、プロンプトの最後のライセンスキ行を前にしているため、実行前にキーが環境に設定されました。 アシスタントは環境変数を列挙し、そのキーを自身のセッションログに印刷しました。
エージェント固有のガイド
このページは、どのアシスタントとも動作する一般的なセットアップをカバーします。 特定のツールにチューニングされたウォークスルーについては、下記のガイドを参照してください:
- Claude CodeでIronPDFを使用する方法
- ChatGPT CodexでIronPDFを使用する方法
- GitHub CopilotでIronPDFを使用する方法
- CursorでIronPDFを使用する方法
- Google AntigravityでIronPDFを使用する方法
トラブルシューティング
- IronPDFでのライセンスキーの適用: PDFの保存がライセンス例外をスローする場合
- RenderingOptionsを正しく初期化する方法:提案されたオプション名が解決されない場合
- どのIronPDFのバージョンを使用すべきですか?:プロンプトとプロジェクトファイルでバージョンを固定するため
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。