Google AntigravityでのIronPDFの使用方法
ほとんどのAIコーディングツールはスニペットで止まります。 コードを返却され、自分で実行して動作を確認します。 このギャップはPDF生成において特に重要です。なぜなら、正常にコンパイルされるPDFでも、見た目が誤っている可能性があり、ビルドログにはロゴが欠落していることや、ページブレークでテーブルが分断されていることが示されないからです。
Google Antigravityは、チャットアシスタントではなくエージェンティックな開発プラットフォームです。 エージェントはエディタ、ターミナル、ブラウザ全体で動作し、転写ではなく成果物を報告します。IronPDFは埋め込まれたChromiumエンジンを使用してHTMLをPDFにレンダリングします。この組み合わせが有用なのは、比較対象の両側が同じHTMLをレンダリングするブラウザであるため、エージェントがページを開き、PDFを生成し、両方をチェックして一致するまで調整できるためです。 これは検証ループであり、このガイドを構築するに値する部分です。
始める前に、混同されやすい2つの類似のテーマについて明確にしておきます。 このガイドは、IronPDFを用いたソフトウェアを構築するためのAI開発ツールの使用に関するものです。 PDFファイルの内容を読み取ったり分析したりするためにAIモデルを使用することではなく、これは別途AI対応PDF処理チュートリアルでカバーされています。 別の問題、別のページです。
クイックスタートAntigravityでプロジェクトを開き、希望するドキュメントを記述してください。
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.
Antigravityのエージェントがパッケージをインストールし、ChromePdfRendererを構築してRenderHtmlAsPdfを呼び出す数行を書き、ファイルを保存し、ビルド結果と共に報告します。 確認するのは転写ではなく結果です。
ここにいるついでに、安全に関する短いメモを。 エージェンティックなIDEのエージェントはファイル書込みおよびターミナルアクセスを持っていますので、ライセンスキーはソース管理から除外された環境変数または設定ファイルに属し、タスクの説明に貼り付けたり、リポジトリにコミットしたりしてはいけません。 ライセンスキーガイドにはサポートされている構成オプションがカバーされています。
最小限のワークフロー(5ステップ)
- NuGetからC# PDFライブラリをダウンロード
- AntigravityのEditor Viewでプロジェクトを開いてビルドを確認します
- IronPDFを追加し、ライセンスキーをコードからではなく設定から適用します
- フレームワーク、ファイルパス、および期待されるPDF出力でタスクを説明してください
- エージェントをブラウザで実装して検証し、次にAPIの名前をAPIリファレンスと照合します
Google Antigravityとは何か、そしてチャットアシスタントとはどう違うのか?
Antigravityはエージェントファーストな開発プラットフォームで、自律的なエージェントがエディタ、ターミナル、ブラウザ全体で作業を計画・実行し、その結果をレビュー可能な成果物として報告します。 Googleは、複雑なタスクを計画、実行、検証するエージェントを展開するためのエディタビューとマネージャーサーフェスを組み合わせたものと説明しています。
PDF作業において重要な5つの特性があります。
Editor Viewは、タブ補 completions やインラインコマンドを備えた馴染みのあるIDEの表面です。 カーソルを操作して、変化が起こるたびに各変更をレビューしたいときに近距離で作業するためのものです。
Manager Surfaceは非同期のミッションコントロールです。 エージェントをスポーンし、タスクをキューに入れ、進捗を見守り、1つの会話を待つのではなく、ワークスペース全体で作業を並行して実行します。
ブラウザ制御により、エージェントはブラウザを駆動して機能を利用し、結果を確認できます。 IronPDFではこれは目玉の機能であり、以下に独自のセクションがあります。
アーティファクトは、生のツールログの代わりにエージェントが生成する成果物です:タスクリスト、実装プラン、ウォークスルー、スクリーンショット、およびブラウザ録画。 Googleのフレーミングは、これらによりエージェントのロジックを一目で確認できるようにし、アーティファクトに直接フィードバックを残すことができるとしています。これは、エージェントの実行を止めずに行われるドキュメントへのコメントのようなものです。
モデル選択性とは、エージェントが異なる基盤モデルで駆動され、タスクごとに選択されることを意味します。
チャットアシスタントとは、レビューするものが異なります。 チャットアシスタントは読むことで評価しなければならないテキストを生成します。 エージェントは計画、差分、実際のレンダリング出力のスクリーンショットを生成します。 PDFのタスクでは、ドキュメントがどのように見えるべきかを説明する段落よりも、ドキュメントのスクリーンショットが意味のある証拠です。
この検証ループが機能するのは、比較の片側が正直だからです。最初からドキュメントパイプラインを構築するように求められたエージェントは、喜んで即興で対応します:レンダリングライブラリを選択し、接続し、次に進みます。 そのパイプラインに含まれるものがリスクです。
- 敏感なドキュメントには安全なライブラリが必要です:企業が生成するPDFは、その契約書、請求書、法的文書です。 いくつかの広くコピーされたオープンソースのPDFツールは今日放棄されており、公に知られたセキュリティホールを持ち、誰もそれを修正しないので、それらに基づいくパイプラインは処理する文書を漏らす可能性があります。
- 決定論的出力はブラウザ比較を信頼できるものにします:エージェントの出力はランの間に変化しますが、レンダラーはそうではありません。さもなければ、このガイドのループは意味がありません。 IronPDFはChromiumエンジンを固定しているため、同じHTMLが毎回同じページをレンダリングします。
- コンプライアンス形式とは、誰もプロトタイプを作成しない要件です:
SaveAsPdfAはアーカイブ用のPDF/Aファイルを書き、SaveAsPdfUAはタグ付きでスクリーンリーダーでナビゲートできるアクセス可能なPDF/UAを書きます。 無料のレンダラーではどちらも滅多に提供されません。 - 推測よりも実際のパッケージが優れています:エージェントは時には正しいと思われる名前のパッケージをインストールしますが、これは「スロップスクワッティング」と呼ばれるほど一般的なトリックであり、攻撃者はこれらの名前を登録してそれにマルウェアを詰め込みます。 タスクの説明で1つの有名なパッケージを指定することが、そのドアを閉じます。
IronPDFをAntigravityに指示し、エージェントの仕事が確実に得意な部分に絞られます:テンプレートを書くこと、ブラウザを操作すること、結果を確認すること。 親ガイドには、エージェントが開始する前に渡すべき文書がカバーされており、同じセットアップがClaude CodeとChatGPT Codexにも引き継がれ、指示ファイル名のみが変わります。
エージェントから何が返却され、どのようにレビューするのか?
Antigravityエージェントの出力は転写ではありません。 それはアーティファクトを生成します:レビューするときのドキュメントのようにレビューされる名の付いた成果物です。 それらのうち3つは予測可能な順序で到着し、それぞれがPDFタスクについて異なる質問に答えます。
コードの前: タスクリスト
エージェントはいずれかに書かれる前に構造化された計画を書きます。 PDF作業において有用な質問は、それがどのレイヤーに触れるかということです。 ページまたぎでテーブルが分割される問題でもレンダラーを編集しようとする計画は、既に間違った方向に向かっています。これは、それを捉える最も安価な場所です。
中間: 実装プラン
エージェントが変更を設計する部分です:どのファイルが、どのメソッドが、どのレンダリングオプションが使われているか。 発明されたAPI名は、1行も書かれる前にここで見ることができ、これはビルドログよりもはるかに良い場所です。
実装後: ウォークスルー
実装が完了した後に一度書かれ、その変化内容とテスト方法を要約します。 ドキュメントタスクにとっては、ページ数とヘッダ、フッタが、信頼せざるを得ない主張ではなく検証可能なチェックとして表現されます。
スクリーンショットやブラウザの録画がこれらと一緒に蓄積され、チャットログをスクロールするのではなく補助ペーンに集まります。 このガイドの残りはそれに依存しています:以下のタスクのうちの二つは実際に作業が行われたことを確認するために開く価値のある一つのアーティファクトが続きます。
証拠はどこから来ますか?
ブラウザ制御は、プロンプトベースのアシスタントではなく、PDF作業にエージェンティックプラットフォームを使用する理由を正当化する組み合わせです。 IronPDFはChromiumエンジンでレンダリングし、Antigravityエージェントはブラウザを操作できます。 そのため、比較の両側が同じエンジンで同じHTMLをレンダリングしているため、比較が意味のあるものになり、近似にすぎないものではありません。
ループは次のようになります:エージェントがブラウザでテンプレートを開き、目にするものをキャプチャし、PDFを生成し、両者を比較し、CSSを調整し、一致するまで繰り返します。
本当の症状を追いかけさせます:
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.
そのタスクのデザインの選択が重要です。 変更の前に説明を求めると、逆エンジニアリングしなければならない修正ではなく、評価可能な診断を与えてくれます。 変更をCSSに絞ることは修正をその場所に保つことになります。なぜなら、ページブレークの挙動はスタイルシートの問題であり、制約されていないエージェントは、しばしばCSSをC#を再構築することで「解決」するためです。
アーティファクトがこれをレビュー可能にします。 生成されたPDFの隣にレンダリングされたページのスクリーンショットが直接的な証拠です。 レイアウトが今一致していると書かれた主張はそうではありません。 ジュニア開発者にとって、なぜブラウザとPDF出力が異なるのかを直感的に理解するにはこの方法が最も迅速です。それは理論ではなく、違いが可視化されるからです。
レイアウト問題に対するフィードバックは空間的です。これがレビューモデルを知る価値のあるものにしているのです。 間違ったブロックを文で説明するのではなく、スクリーンショットの間違った領域を選択し、ドキュメントへのコメントと同じように直接コメントを残します。 エージェントはその修正を作業に統合し、実行を中断して再開することなく進めます。
何にせよ、エージェントがページをレンダリングし、PDFを生成し、両方を見せるだけでも、ビルド、開く、目を細め、調整する手動サイクルよりも速いです。
なぜブラウザで正しく見えてPDFで間違って見えるのか?
そのループで拾われるもののほとんどは、ドキュメントが壊れて見えてエラーを出さない同じ問題に帰着します。そして、この症状は共通しています。 タスクで疑わしい原因を特定して名前を付けると、エージェントの推測ラウンドが節約されます。
| 症状 | なぜ二者は分岐するのか | これをタスクに入れてください |
|---|---|---|
| テキストが再配置されたり、ボックスをオーバーフローします | レイアウトが計算されたときにウェブフォントがまだロードされていなかったため、メジャーはフォールバックの顔から来ました | そのフォントを名前で呼び、置換されるのではなく埋め込まれていることの確認を求めます |
| ブラウザでは表示されているのに画像が欠けている | ブラウザはファイル自身の場所に対して相対パスを解決します; レンダラーは設定されたベースパスに対して解決します | ベースパスを明示的に設定し、ウォークスルーで名前を付けることを尋ねます |
| チャートやテーブルが空になる | レンダラーが実行する前に処理したJavaScriptによってコンテンツが生成されました | レンダーが待機したことの確認を求め、証拠としてスクリーンショットを添付するようにします |
| テーブル行が2ページに分割されています | 印刷CSSは適用されておらず、スクリーンCSSのみが適用されました | 修正をスタイルシートのページブレークプロパティに制限します |
各行は同じマークアップの2つのレンダリングの違いであり、それが前述の比較がそれらを見つけるためのものである理由です。
Antigravityで作業できるプロジェクトをどのように設定するのか?
エージェントに既にコンパイルされているプロジェクトを与えます。 選んだPDFライブラリを推測しなければならないエージェントや、本当のタスクを始める前に壊れたビルドをデバッグしなければならないエージェントは、間違った問題で実行を使い果たします。
まずプロジェクトを作成または開き、ビルドが成功することを確認します。 その後、セットアップタスク自体の委任が価値があるのは、インストールがバージョンの不一致の発生源だからです。
エージェントにセットアップタスクを直接渡します:
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.
バージョンを返すように依頼することで、後の各タスク記述に含める事実を取得できます。 .gitignore チェックを要求することで、キーを保持するコンフィグファイルがリポジトリの外にあります。
リポジトリルートでコミットされたワークスペース指示ファイルは、一度設定する価値があります。 AntigravityはAGENTS.mdを読み取ってプロジェクトの指示を立てます。同じファイルをChatGPT Codexも使用しています。 IronPDFがPDFライブラリであることを記録し、生成されたコードは文書化されたAPIのみを使用しなければならないことを記述し、ライセンスキーがインライン化されないことは、これらの制約を各タスクで繰り返すことを防ぎます。 1つのタスクがそれを書いてくれます。
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.
PDF生成と移行作業をどのように委任するのか?
生成タスクはドキュメントを説明する際に最善を尽くします。コードではなく、エージェントがHTMLで表現する方法を選ぶことができます。
実装ではなくドキュメントを求めます:
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.
移行は委任が最も報われるタスクタイプです。なぜなら、それは機械的で退屈で、ほぼ正しい状態に持っていくのが簡単だからです。 重要な動作は、分析を実装から分離することです。
エージェントに既存のコードを指示し、それを説明するのではなく:
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.
取り組む方法について合意する前に400行を書くエージェントは、慎重に読む必要がある400行を生成します。 計画アーティファクトは1文で修正でき、Antigravityのフィードバック機構により、ランを破棄せずに注釈を付けることができます。 承認されたら、フォローアップタスクは狭い範囲です:計画を実装し、呼び出し元が変わらないように既存の公開メソッド署名を保持し、差分を報告します。
ヘッダとフッタはテンプレートマークアップではなくレンダラー設定であるため、タスクはそのことを記述すべきです。 エージェントに使用したドキュメントページのリンクを求めることは安価な検証ステップです:今しがた呼び出したAPIのために実際のページを生成できないのであれば、それはシグナルです。 ヘッダーとフッターガイドがここでの参照資料であり、ページ区切りガイドは関連するレイアウト制御をカバーしています。
複数のエージェントを派遣するのはいつですか?
Manager Surfaceは、見守る必要のない作業のためのものです。 1つのタスクを1度に実行するのではなく、いくつかのエージェントを派遣し、それらのアーティファクトを完了したらレビューします。
PDF移行の現実的な分割:1つのエージェントがレガシーレポートジェネレーターをIronPDFに変換し、もう1つがそれが生成する出力周辺のテストスイートを書く。 2番目のエージェントは最初のエージェントが終了する必要はありません。なぜなら、テストは実装ではなく、ドキュメントに対してアサートするからです。
両方同時に派遣:
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.
バイト単位での比較を除外することが、一連の曖昧なテストを防ぎます。レンダリング出力はエンジンのバージョンにより異なるので、アサーションは抽出されたテキスト、ページカウント、メタデータのレベルに属します。
Antigravityのエージェントはまた、過去のタスクからのパターンやソリューションを知識ベースに保存し、後のタスクに反映します。 文書パイプラインが特定の方法で積み重なる場合:請求書用に考え出されたページブレークルールは、声明、梱包明細、支払いアドバイスがすべて必要とする同じルールなので、2番目のドキュメントは通常1番目よりも安価です。
Linux、Docker、Azureでのデプロイ失敗をどのようにデバッグしますか?
展開の問題は、答えが通常コードではなくコンテナに存在するため、ターミナルアクセスが役立つユニットです。
エージェントに直接失敗を渡してください:
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.
アプリケーションコードに触れない指示が重要です。 画像内の欠落した共有ライブラリは、C#の問題ではなく、エージェントに自由が与えられると、避けたいトライ/キャッチブロックを追加して失敗を隠すことがよくあります。 Dockerデプロイメントガイドには最新の依存関係要件が文書化されており、リリースごとに変更されるため、記憶するのではなく読むべきです。
エージェントはリーダーとしても役立ちます。 不慣れなクラスを指し、それに影響を与えるレンダリングオプションを一覧で表示するようにお願いし、プロジェクトが現在設定しているものを表示します。APIリファレンスをスクロールではなくクエリに使用できるようになります。
プロンプトが実運用で生成したものは何ですか?
上記の八つのプロンプトのうち七つが順番に実行され、無人で一会話内で行われました。 ツールはAntigravity CLI 1.4.0で、そのデフォルトモデルはGemini 4 Argon(ミディアム)でした。 プロジェクトは.NET 9コンソールアプリケーションであり、PDFsharpを使って既にレポートを作成していました。以下の数字は、実行によって残されたファイルの独立したチェックから来ています。
- ブラウザタスクの前に、請求書の行09がページ1と2に分割され、合計がページ2の上部にありました。
- IronPdf 2026.10.3のインストールは既存のビルドを壊しました。というのも、パッケージがグローバルusingを追加し、PdfDocumentがPDFsharpと曖昧になったからです。
- エージェントはレポートビルダー内で型エイリアスを用いてそのエラーを解決し、プロジェクトは警告やエラーなしでビルドされました。
- ブラウザタスク内で、エージェントはヘッドレスChromeを使ってテンプレートをキャプチャし、何も編集する前にPDFをレンダリングしました。
- 修正はスタイルシートだけを変更し、テーブル行と合計ブロックに破れ内(break-inside)回避ルールを追加しました。
- その後にレンダリングされた請求書は、すべての行を一つのままにし、行09と合計をページ2に一緒に保ちました。
- セットアップタスクが空のライセンスキーを含むappsettings.jsonを追加し、.gitignoreにリストしました。
- その空の値がIRONPDF_LICENSE_KEYよりも優先されます。 ファイルが存在する状態で、Quickstartプログラムと請求書ジョブの両方が「Production License Required」とスローしました。
- AGENTS.md はプロンプトの4つのルールをすべて保持しており、エージェントは請求書のコードを書く前にllms.txtを読みました。
- InvoiceRendererは、20 mmの余白と会社名が置換された2ページのA4 PDFを返しました。
- 移行プランは、Letterページサイズ、ページあたり32行および5つのフォントすべてを正しく報告し、ファイルを変更しませんでした。
- ディスパッチプロンプトは、エージェントAとエージェントBという2つのサブエージェントを開始し、並行して実行されました。
- 移行されたビルダーはその公共署名、2つの手紙ページおよび5つのオリジナルフォントを保持しました。
- エージェントBの2つのxUnitテストはエージェントAの出力に対して合格し、PDF署名、抽出されたテキストおよびページ数を確認しました。
- 一部のステップはページと異なる方法で実行されました。 Quickstartプログラムはビルドされたが実行されず、したがって別のチェックでその1ページのhello.pdfが生成されました。 実行は、請求書テンプレートとレンダージョブをブラウザタスクの前に追加しました。ページは既に存在すると想定していました。CLIの回転は止まらなかったので、分割の説明は、CSSの編集の後、最終的な回答でのみ行われました。 CLIはスクリーンショットを生成しましたが、ブラウザの録画はありませんでした。 請求書タスクは新しいテンプレートを作成する代わりに既存のテンプレートを編集しました。 エージェントBはテストをコンソールプロジェクト内に配置しました。 このマシンにはDockerやWSLがないため、Linuxコンテナプロンプトは実行されませんでした。
スタイルシートの修正前後のブラウザタスクからの請求書が下に埋め込まれています。
エージェントが修正前にレンダリングした請求書で、行09がページ1と2に分割されています。
修正後の同じ請求書では、すべての行が完全で、合計は行09の直下にあります。
実行のツール、モデル、期間は実行記録に記載されています。
このペアリングが価値あるものにするのは何ですか?
速度の速さよりも戻ってくるものが重要です。 エージェントは作業前にプランを手渡し、作業後にウォークスルーを行い、レンダリングが実際に行われたことを示すスクリーンショットを提供します。 レイアウトが正しいかどうかを何も教えてくれないクリーンなビルドの代わりに、レビュー可能な証拠がますます重要です。
このシリーズの再現可能なテストは、発表された結果とともに最初から最後まで実行され、AIコーディングアシスタントガイドで確認することができます。
トラブルシューティング
- IronPDFでのライセンスキーの適用: PDFの保存がライセンス例外をスローする場合
- RenderingOptionsを正しく初期化する方法:提案されたオプション名が解決されない場合
- IronPDFのどのバージョンを使用すればよいですか?:タスクと
AGENTS.mdにバージョンを固定するために - DockerコンテナでIronPDFを実行する方法:レンダリングがローカルで動作し、コンテナ内で失敗する場合
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。