IronWordをGoogle Antigravityと一緒に使う方法

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

フィールドエンジニアは、検査報告書をWordファイルとして提出し、埋め込まれた写真がその証拠です。 写真を削除したり、テーブル内の画像を省略したり、間違ったキャプションを付けたり、不正確な写真サイズを報告したりすると、エラーなくビルドされたレビュー ページでも失敗します。 ビルドログにはこれらの失敗は記録されません。

Google Antigravityはレビュアーと同じ方法でページをテストできます。 サンドボックス化されたブラウザーサブエージェントは、/browser コマンドで起動され、ページを開き、ファイルコントロール内の各レポートを選択し、その結果のスクリーンショットを撮ります。 サーバー上では、IronWordがアップロードされたDOCXファイルを開き、Microsoft OfficeのインストールなしにExtractImagesを通じてそれらの写真を返します。 以下のレビュー ページは、両方のツールで構築され、既知の写真数、キャプション、ピクセルサイズを持つ6 つのレポートに対してテストされています。

このガイドは、AIエージェントがWordドキュメントを読み取る.NETコードを作成する開発者向けです。 AIモデルを使用してレポート自体を生成することは範囲外です。

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

PM > Install-Package IronWord

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

AntigravityのBlazorプロジェクトが開いているときに/planプロンプトでレビューページを説明します。

/plan Add a report review page at /photos to this Blazor Web App on .NET 9.
The app uses the Interactive Server render mode.

Here's what the page needs:

- A reviewer picks a site inspection report (.docx) with InputFile.
- The server opens it with IronWord and calls ExtractImages.
- Add the IronWord package from NuGet, pinned to 2026.10.4. Its namespace is IronWord.
- Each photo appears as a thumbnail with its width and height in pixels and its image format.
- The page also shows how many photos the report holds.
- Link the page from NavMenu.

Read IRONWORD_LICENSE_KEY from the environment once at startup into IronWord.License.LicenseKey.
The app reads that variable itself.
Only check that it's set and how long it is.
Never print, log or store its value.
Don't list environment variables either.

Answer these in the Implementation Plan:

- which render mode the page gets
- how the upload stream reaches IronWord
- the size limit passed to OpenReadStream

You're done when dotnet build reports no errors.
Text

成功したビルドは、計画がカバーしなければならない3つの質問のいずれにも答えません。 Microsoftのレンダーモードガイドは、ページが対話型になるタイミングを説明し、Blazorファイルアップロードガイドはアップロードハンドリングとサイズ制限をカバーします。

エージェントに変数名を提供しますが、その値は共有しないでください。 IronWord は、アプリ設定.jsonのIronWord.LicenseKeyエントリも読み取り、間違ってコミットされるファイルです。 ライセンスキーガイドには、IronWordがキーチェックするすべての場所が一覧表示されています。



Google Antigravityとは何か、そしてチャットアシスタントとはどう違うのか?

Googleの概要では、Antigravity アプリを、エージェントのチームを起動、編成、検査するデスクトップ アプリケーションとして説明しています。 エージェントはコマンドを実行し、ファイルを読み書きし、sandboxed Chromeブラウザを制御します。 チャットアシスタントはテキストで応答し、エージェントはアーティファクトを返します。例えば、実装計画。

slopsquatting攻撃では、誰かが公開されたことがないライブラリのためにAIエージェントが生成する名前のパッケージを登録し、その名前を要求するエージェントは攻撃者のコードをインストールします。 パッケージを含むすべてのタスクでIronWordパッケージに名前を付けます。 ハブのAIコードアシスタントガイドには、エージェント向けのIronWordのドキュメントファイルのリストと、ワンプロンプト受け入れテストが含まれています。

計画、コード変更、ウォークスルーで何を確認すべきですか?

Quickstartプロンプトで要求された3つの回答の他に、実装計画は写真のないレポートに対して生成されたメッセージを述べるべきです。 コードの変更の中で、ピクセル サイズを計算する行を見つけ、API リファレンスに従って各IronWordメンバーをチェックします。

各レポートには、Walkthrough に結果テーブルの隣に独自のスクリーンショットが必要です。 Antigravity は画像アーティファクトとして スクリーンショットを保存し、リーダーはそれらのどれでもコメントできます。 間違った写真の下にキャプションがあるスクリーンショットへのコメントは、エージェントに修正すべき画像を教えます。

本物のブラウザでIronWord のレビュー ページをどのようにテストしますか?

/browser には、そのセルが各ファイルのアップロードのみで埋まれた結果テーブルを提供します。

/browser Start the site with dotnet run and open /photos.
Its http profile listens on http://localhost:5036.

Take each .docx file in TestData/reports through the page's file picker, one at a time:

1. Pick the file.
2. Wait for the photo list or an error message.
3. Take a screenshot.

TestData/reports/expected.csv lists each report's site photos in document order.
It gives their number, captions and pixel sizes, with | between entries.

Build a table in the Walkthrough with these columns:

- file
- bytes
- photos expected
- thumbnails shown
- pixel sizes expected
- pixel sizes shown
- pass or fail

For a failed row, quote the server log entry or browser console error behind it.
Do that before you change any code.
If neither recorded one, write that down.
After a fix, restart the app and put all six reports through the page again.
Stop the app when you finish.
Text

6つのレポートは、写真ページが処理しなければならないレイアウトをカバーしています。 1つはPNG、JPEG、およびGIFを含み、1つはテーブルセルに写真を保存します。 別のものにはページヘッダーにロゴが含まれ、1つは同じ画像を2回配置し、1つは写真を含まず、1つは4つの12MP写真を含む7.7MBのレポートです。

注意してください: 画面全体の解像度レポートのスクリーンショットを最初に確認します。なぜなら、制限が引き上げられたかどうかを確認するからです。

欠落しているか間違った写真の原因は何ですか?

私たちのテストでは、失敗したすべての行が3つの原因のいずれかに該当しました。 それらを特定するために、IronWordの画像抽出ガイドから抽出コードを新しい.NET 9 Blazor プロジェクト内のアップロードハンドラーにコピーし、6つのレポートをヘッドレス Chrome を通じて処理しました。

ページに表示される内容原因修正
どのレポートにも出力はありません静的レンダリング@rendermode InteractiveServer
出力がなく、サーバーログは空のままですドキュメントコンストラクターがアップロードストリームを同期的に読み取りますアップロードストリームでLoadAsync
フル解像度レポートのみのエラー512,000バイトのデフォルトアップロード制限最大のレポートを超える制限

2 番目の行は診断が最も困難です。 コンストラクターは「同期読み取りはサポートされていません」というメッセージでNotSupportedExceptionをスローしました。例外はハンドラーがそれをキャッチしてログを記録したときにのみ目に見えるようになりました。

Antigravityで作業できるプロジェクトをどのように設定するのか?

Antigravityに、既にページをビルドして提供するリポジトリを与えます。 テストプロジェクトはdotnet new blazor -int Server -f net9.0から来て、プロンプトの前に0エラーでビルドされました。 テンプレートは、Properties/launchSettings.json のhttpプロファイルにランダムポートを書き込むため、そのURLを/browserプロンプトにコピーします。

次のタスクはパッケージとライセンス キーを監査します。

Which IronWord version does this project reference? Quote its PackageReference line.
Then point me to the line that applies the license key.

Check the project against these key rules:

- The key reaches the app only through IRONWORD_LICENSE_KEY at startup.
- Neither appsettings.json nor appsettings.Development.json has an IronWord.LicenseKey entry.
- Properties/launchSettings.json doesn't carry the key.
- A missing variable at startup gets one logged warning that names it and shows no value.

Edit Program.cs only if that warning doesn't exist yet.
Leave every other file as it is.
Tell me which rules pass and which fail.
Text

後のタスクで報告されたバージョンを引用します。 IronWord 2026.10.4 はすべてのレポートを開き、すべての写真をライセンスキーなしで抽出しました。 保存は「Production License Required」を読み込むLicensingExceptionをスローしました。 したがって、鍵の欠如は、アプリが最初にファイルを記述するまで明らかになりません。この読み取り専用ページではそれを行いません。

ページのルールを後続のタスクにどのように適用しますか?

6 つの行がすべて合格した後、セッションが決定した内容を記録します。 Antigravityの規則ドキュメントは、エージェントがファイルを読み取ったり編集したりするたびに、それが見つけられた各フォルダーでワークスペース ルートの上にあるGEMINI.md や AGENTS.md をロードすると記載しています。 /learnでは、フィードバックをセッションから永続的なプロジェクトルールに変換します。

/learn Create AGENTS.md at the root of the repository and record what this session settled.
Put the notes under the heading "Inspection report photos". They should cover:

- the render mode the /photos page needs
- the upload limit, with the reason for its value
- how the upload reaches IronWord without a synchronous read
- where a photo's pixel size comes from
- that IRONWORD_LICENSE_KEY stays out of every file
- that no page change is done until all six reports in TestData/reports pass the /browser table
Text

ファイルが存在すると、レンダーモードとアップロード制限は、すべてのタスクが読み取る1 か所に記録されます。 エージェントはそれを自動的に更新しません。 値を変更する同じタスクで更新を要求します。

IronWord を使用してアップロードされたレポートをどのように読み込みますか?

結果と証拠を指定し、エージェントにコードの構造を任せます。

/plan Write the Implementation Plan Artifact before you edit anything.

Move the IronWord code out of the page into Services/ReportPhotoService.cs.
Register it as a singleton.

The service works like this:

- It opens the upload with WordDocument.LoadAsync, straight from OpenReadStream with a 30 MB limit.
- It checks the file's Size first and turns away anything larger before it opens a stream.
- A refused file gets a clear message that the page shows.
- A second public method takes an already loaded WordDocument.
- Tests can call that method without a browser.

For each photo, the service returns:

- the pixel size
- the size the photo is placed at in the report, in inches
- the format
- a JPEG thumbnail no wider than 320 pixels
- the caption

A caption is the first paragraph with text after the photo's own paragraph.
For a photo inside a table cell, it's the text of the cell directly below.

Show each caption under its thumbnail.
Then repeat the /browser table with a captions column checked against expected.csv.
Text

この例に似たサービスを期待してください。 IronWord 2026.10.4 とともにコンパイルされ、それを使用する校正テスト ページは、すべての6つのレポートの写真数、キャプション、およびピクセル サイズを正しく一覧表示しました。

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Components.Forms;

public sealed record ReportPhoto(int PixelWidth, int PixelHeight, double WidthPoints, double HeightPoints, string Format, string Caption, string ThumbnailDataUrl);

public sealed class ReportPhotoService
{
    public const long MaxUploadBytes = 30 * 1024 * 1024;

    public async Task<List<ReportPhoto>> ReadAsync(IBrowserFile file)
    {
        if (file.Size > MaxUploadBytes)
            throw new IOException($"{file.Name} is {file.Size:N0} bytes, over the {MaxUploadBytes:N0} byte limit.");
        await using var upload = file.OpenReadStream(MaxUploadBytes);
        var doc = await WordDocument.LoadAsync(upload);
        return Read(doc);
    }

    public static List<ReportPhoto> Read(WordDocument doc)
    {
        var photos = new List<ReportPhoto>();
        var body = doc.Paragraphs.Where(p => p.Parent is DocumentSection).ToList();
        for (int i = 0; i < body.Count; i++)
        {
            foreach (var img in body[i].ExtractImages())
            {
                var caption = body.Skip(i + 1).Select(p => p.ExtractText().Trim()).FirstOrDefault(t => t.Length > 0) ?? "";
                photos.Add(Make(img, caption));
            }
        }
        foreach (var table in doc.Tables)
            for (int r = 0; r < table.Rows.Count; r++)
                for (int c = 0; c < table.Rows[r].Cells.Count; c++)
                    foreach (var img in ((TableCell)table.Rows[r].Cells[c]).ExtractImages())
                    {
                        var caption = r + 1 < table.Rows.Count && c < table.Rows[r + 1].Cells.Count
                            ? ((TableCell)table.Rows[r + 1].Cells[c]).ExtractText().Trim() : "";
                        photos.Add(Make(img, caption));
                    }
        return photos;
    }

    static ReportPhoto Make(ImageContent img, string caption)
    {
        var bmp = (AnyBitmap)img.Image;
        int tw = Math.Min(320, bmp.Width);
        int th = Math.Max(1, bmp.Height * tw / bmp.Width);
        using var thumb = new AnyBitmap(bmp, tw, th);
        var jpg = thumb.ExportBytes(AnyBitmap.ImageFormat.Jpeg, 80);
        return new ReportPhoto(bmp.Width, bmp.Height, img.Width, img.Height, img.Type.ToString(), caption,
            "data:image/jpeg;base64," + Convert.ToBase64String(jpg));
    }
}
C#

サイズチェックは、ブラウザーによって報告された値を使用するため、ストリームが開く前にオーバーサイズのファイルが失敗します。 Microsoftのアップロードガイドでは、このクライアント提供の値にのみ頼ることを勧めておらず、OpenReadStreamで設定された制限が実際のキャップを強制します。フル解像度のレポートの読み取りには、2回の校正で1,118 msおよび1,280 msを要しました。 大量のデータ転送を回避するために、サービスはフルサイズ画像をブラウザに送信するのではなく、スケールされたサムネイルを生成します。

IronWord がドキュメントから抽出するのはどの画像ですか?

メソッドExtractImagesはドキュメントボディおよびテーブルセルにある写真を返します。 ページのヘッダーにあるロゴをスキップするため、レターヘッドはサイトの写真としてはカウントされません。 1つの写真が複数回表示される場合、各配置ごとに一度返され、それぞれに独自のサイズがあります。

各結果には、その幅と高さがポイントで含まれています。 たとえば、幅が3インチの写真は、解像度に関係なく216ポイントとして報告されます。 サンプルサービスはこれらのポイント値を保持します。 インチに変換するには、72で割るか、エージェントによって説明されたようにGetWidth(MeasurementUnit.Inch)を使用します。 ピクセルサイズは、ImageプロパティをAnyBitmapにキャストするか、ImageDataのBase64文字列をデコードすることで取得されます。

段落リストには読み順でテーブルセル内の段落が含まれているため、テキストのある次の段落を選択すると、最初の写真のキャプションが2番目のテーブル写真に割り当てられます。 ドキュメントのExtractTextはテーブルテキストも省略するため、その出力にはテーブルキャプションが含まれません。

複数のエージェントを派遣するのはいつですか?

それらのテストを2つのエージェントで分けます。 1つはコードでサービスをテストします。 もう1つはブラウザでレビュアーのアップロードを再生します。

Agent A: add an xUnit project named InspectionPhotos.Tests.
Its tests take each report in TestData/reports through these steps:

1. Load the report from disk with WordDocument.
2. Pass it through the extraction code in ReportPhotoService.
3. Assert the photo count, pixel sizes and captions that expected.csv lists, in document order.

Add one more test proving a file above the upload limit is refused before IronWord opens it.
expected.csv quotes any field that holds a comma, so parse it as CSV.
The web project is at the repository root, so keep the test folder out of its compile items.
Run the tests with dotnet test InspectionPhotos.Tests.

Agent B: wait until Agent A's tests are green on the current code.
Then put the six reports through /photos with /browser.
Attach one screenshot per report to the Walkthrough.
Note there that the tests ran first.
Text

ディスクからレポートを開くテストではブラウザも実行中のアプリケーションも必要ないので、/browser実行前にキャプションの回帰を検出します。

注意してください: デスクトップアプリでは、各エージェントは別のタスクとして実行できます。 統合前に2つのWalkthroughを比較してください。

ページをLinuxコンテナにデプロイするにはどうすればよいですか?

IronWord 2026.10.4 には、Windows (x64 および x86)、linux-x64、および macOS 用にビルドされたネイティブなレイアウトライブラリが含まれています。

This page will run in a linux-x64 container based on mcr.microsoft.com/dotnet/aspnet:9.0.
Leave the C# untouched.
Docker is missing on this machine, so don't run docker build.

Work through these steps:

1. Write a Dockerfile whose build stage publishes a linux-x64 build.
2. Have the image take IRONWORD_LICENSE_KEY from the container environment when it starts.
3. Run dotnet publish -c Release -r linux-x64 --self-contained false -o out/linux.

Then list every native library (.so) in out/linux with the NuGet package that supplied it.
If there's none, say so.
Text

Docker はネイティブファイルを一覧表示するために必要ありません。なぜなら、Windows 上の発行フォルダーにはイメージが受信するファイルと同じものが含まれているからです。 linux-x64 用に校正アプリを発行したところ、ネイティブファイルが1 つ生成されました: libLayoutEngineInterop.so (8,303,240 バイト)。 そのファイルは glibc にのみリンクし、パッケージには musl や linux-arm64 ビルドがないため、Alpine や ARM64 Linux イメージにはネイティブライブラリがありません。 Windows上では、写真の読み込みと抽出はネイティブライブラリをロードしませんでした。 IronWordのDockerガイドでは、Ubuntu、Debian、またはRHELイメージを使用することを推奨しています。

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

1つのAntigravity CLIセッションがすべての7つのプロンプトを無人で実行し、すべての権限プロンプトをスキップしました。 アプリはIRONWORD_LICENSE_KEYからのみライセンスキーを読み取りました。 Chrome上で、各レポートをヘッドレスで2回アップロードし、最初のプロンプトのコードと最終コードを使用しました。

  • 写真とピクセルサイズは、両方のChromeチェックで全6レポートに対して正しかったです。
  • キャプションは、写真を求めなかった最初のプロンプトの後、写真12のキャプションから正しいキャプションになります。
  • アプリケーションとテストプロジェクトのリリースビルドは、警告0件、エラー0件を報告しました。
  • 7つのxUnitテストすべてが合格しました。
  • linux-x64発行に1つのネイティブライブラリが含まれていました。
  • 3つのブラウザパスのそれぞれがファイルピッカーを通じてすべての6つのレポートを処理しました。
  • 一部のステップはページと異なる方法で実行されました。 Quickstartプロンプトはすでに30MBの制限を設定し、各アップロードをメモリにコピーしたため、上記の3つの原因はいずれも現れませんでした。 各/planプロンプトは承認が到着するまでそのプランを停止します。 エージェントAとエージェントBは、同じ会話の1ターンで走りました。 サムネイルは、IronWordの依存関係であるSixLabors.ImageSharpを使用してリサイズされました。 エージェントは、最初のブラウザパスのスクリーンショットとout/linuxの発行フォルダーをコミットしました。
  • /learnはAGENTS.mdを書きませんでした。 そのアーティファクトには、すべての6つのポイントがリストされており、最初に確認を求めていました。

ChatGPT Codexガイドは、フォルダ全体のWordドキュメントを同時に処理し、このページが1つのアップロードのみを取り扱います。 Claude Codeガイドは、プラン無しプロンプトがここで行うように、ファイル変更の前に計画モードでの設計を承認します。

この実行のためのAntigravity CLIバージョン、モデル、期間、およびテストマシンは、ハブの実行記録にあります。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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