IronPPTをGoogle Antigravityと併用する方法
プロジェクト管理オフィスは毎週月曜日にすべてのプロジェクトのステータスデッキを公開します。 StatusDeskというオフィスのWebアプリで、プロジェクトマネージャがプロジェクトの行で『ステータスデッキをダウンロード』をクリックすると、その直前にサーバーで作成されたPowerPointファイルを受け取ります。 デッキはエラーなくダウンロードすることができ、最初のスライドが空白だったり、テキストボックスが重なっていたり、別のプロジェクトのスライドが表示されたりすることがあります。 これらの欠陥はいずれもビルドログには現れません。
Google Antigravityは、プロジェクトマネージャがページを使う方法を確認することができます。 その /browser コマンドは、サンドボックス化されたブラウザサブエージェントを起動し、各ダウンロードボタンをクリックしてスクリーンショットをキャプチャします。 IronPPTは、サーバー上で、IronPPTのスライド要素チュートリアルで扱われているテキスト、図形、画像からデッキを構築します。 このガイドは、両方のツールでページを構築し、事前に知られている6つのプロジェクトのデッキと比較します。
このガイドは.NETコードを使用してWebサーバー上でPowerPointファイルを生成するAIエージェントを使用する開発者向けです。 スライドデザインや企業テンプレートには対応していません。
クイックスタートAntigravityでStatusDeskプロジェクトを開いて、ステータスページを説明してください。
/plan Give StatusDesk, the PMO's .NET 9 MVC site, a /Status page.
Each project row gets a Download status deck button.
The nav bar gets a Status link.
Install IronPPT 2026.10.1. Its namespace is IronPPT.
App_Data/projects.json holds the projects and the report week.
Each deck has these slides, in order:
1. Title: project name, "Status report, week of" plus the week, owner.
2. Status: status word, status-colored rectangle, summary, logo.
3. Milestones: name, due date and state, at most five per slide.
4. Risks: every risk, only if there are any.
Follow these rules too:
- Status colors: Green 00B050, Amber FFC000, Red C00000.
- Logo: App_Data/logos/<Id>.png, skipped if missing or unreadable.
- Text boxes don't overlap, and nothing runs off the slide IronPPT creates.
- Download name: status-<Id>.pptx, with the PowerPoint content type.
- If a deck fails, the page shows one plain sentence, never exception text.
Startup code reads IRONPPT_LICENSE_KEY itself and sets IronPPT.License.LicenseKey once.
Never print, log or store the key, or list environment variables.
Answer these in the Implementation Plan:
- What does a new PresentationDocument hold, and how big is its slide?
- Where does AddText put a text box, and what unit do Position, Width and Height use?
- How do the deck's bytes get into the HTTP response?
Show me the plan, then build until dotnet build shows zero errors.
合格したビルドは3つの回答のいずれも証明しないため、計画を承認する前にそれらを確認してください。
IronPPTは独自にIRONPPT_LICENSE_KEYを読みません。 調査では、その変数だけを設定した場合、License.IsLicensedはfalseのままであり、IronPPT.LicenseKeyという名前の環境変数がコードなしでプロセスをライセンスしました。 起動時にLicense.LicenseKeyを割り当てると、変数名はアプリケーションの制御下に置かれます。 ライセンスキーガイドにはキーを適用する他の方法が記載されています。
最小限のワークフロー(5ステップ)
- NuGetからC# PowerPointライブラリをダウンロード
- 既にページをビルドして提供しているASP.NET Coreプロジェクトから始めてください。
- すべてのテキストボックス、形状、画像に独自のポイント位置を与えます。
- /browserで各デッキをダウンロードし、既知のリストと各ファイルを比較してください。
- 同時ダウンロードを実行し、APIリファレンスの各メンバーを確認してください。
Google Antigravityとは何か、そしてチャットアシスタントとはどう違うのか?
Googleの概要によると、Antigravity AppはAIエージェントのチームを起動、調整、検査するためのスタンドアロンデスクトップアプリケーションです。 そのエージェントは、チャットアシスタントがテキストを返す場所で、実装プランやウォークスルー、スクリーンショットなどのアーティファクトを返します。
パッケージ名をチェックせずに選ぶエージェントは、言語モデルが妄想する名前でパッケージを公開しているため、マルウェアをインストールすることがあります。 この攻撃はスロップスクワットと呼ばれます。 パッケージを追加するタスクでは、IronPPTパッケージとそのバージョンを指定してください。 AIコーディングアシスタントガイドは、エージェント用のIronPPTのドキュメントファイルを一覧しており、その受け入れテストは1つのプロンプトに収まっています。
計画、コード変更、ウォークスルーで何を確認すべきですか?
計画では、それぞれの回答を下で測定されたデッキの内容と比較してください。 コード変更では、各テキストボックスが位置を受け取る場所を見つけ、APIリファレンスで各IronPPTメンバーを確認してください。
ウォークスルーには各ダウンロードのスクリーンショットが含まれているべきです。 デスクトップアプリ内で、Antigravity は各スクリーンショットを画像アーティファクトとして保存し、コメントを受け入れるため、間違った行にコメントがあるときでも、新しいプロンプトなしでプロジェクトを特定できます。
実際のブラウザでダウンロードボタンをテストする方法は?
/browserに、すべてのデッキをダウンロードしてファイルを開くことでしか完成できないテーブルを提供してください。
/browser Launch StatusDesk with dotnet run as a background process.
Then open http://localhost:5326/Status.
Do this for every project, top to bottom:
1. Click Download status deck.
2. Save the file as artifacts/decks/status-<Id>.pptx.
3. Take a screenshot of the page.
Next, write a console tool in tools/DeckCheck that opens a deck with IronPPT.
It prints the slide count and each slide's text, shape count and image count.
Leave tools/DeckCheck out of the web project's compile items.
Run DeckCheck on each deck in artifacts/decks and compare it with TestData/expected-decks.csv.
Put the results in a Walkthrough table and in artifacts/deckcheck.md.
The table has these columns:
- project
- slides expected and slides found
- first text on slide 1
- images found
- pass or fail
If a row fails, trace the cause in the deck code before you edit.
Then fix it, restart the site and download every deck again.
At the end, kill the dotnet process by its PID and show me the table.
6つのプロジェクトは、ステータスデッキが処理しなければならないケースをカバーしています。 AtlasとBorealisにはロゴと未解決のリスクがあり、Cobaltにはロゴファイルがなく、Deltaにはリスクがないため、そのデッキはマイルストーンの後に終了します。 Emberのロゴは、画像の代わりに失敗したエクスポートからHTMLエラーページを保持しており、Fjordには7つのマイルストーンがあり、2番目のマイルストーンスライドが必要です。
P-102用のダウンロード後の/Statusページ。スタイルシートがない状態で最終ブラウザパスがキャプチャしました。
出力
以下のBorealisデッキは、変更されていない最終ブラウザパスでダウンロードされたファイルです。
Borealis Mobile Appのステータスデッキ、4つのスライドがあり、ロゴは2番目にあります。
何も追加していない新しいIronPPTデッキには何が含まれていますか?
すべての新しいPresentationDocumentは1つのスライドから始まります。そのスライドは、タイトルスライドのレイアウトを使用し、空のプレースホルダー、タイトル1およびサブタイトル2を保持し、AddSlideが後に追加されます。 スライド追加ガイドには既存のスライドが記載されています。
スライドは4:3、720×540ポイントです。 Position、Width、Heightはポイント単位で値を取り、幅100は1,270,000 EMUと書かれます。 IronPPT 2026.10.1用のスライド要素チュートリアルのコメントでピクセル単位と呼ばれているのは間違っています。
IronPPTハブ記事で測定されたSlide.AddTextは位置なしでテキストボックスを作成します。 Position、Width、HeightをSlide.TextBoxesの最後の項目に設定することで、追加されたボックスを配置します。 Font.FontFamilyはファイルに書体を含めず、Font.LatinFontは含めます。
すべてのスライドに対してAddSlideを呼び出し、位置を持たないAddTextを呼び出す校正ビルドは、すべての6つのデッキを白紙のスライドで開き、各デッキ内で6〜15のテキストボックスが1つの位置を共有しました。 既存のスライドを再利用し、各テキストボックスを配置した第2のビルドは、すべての6つのプロジェクトに合格しました。
Antigravityで作業できるプロジェクトをどのように設定するのか?
コンパイルしてページを提供するリポジトリでエージェントを開始してください。 このガイドのプロジェクトはdotnet new mvc -f net9.0で作成され、最初のプロンプトの前に一度ビルドされました。 Properties/launchSettings.jsonのhttpプロファイルはポート5326を提供します。
Which IronPPT version is in StatusDesk.csproj? Quote that PackageReference line.
Next, find and quote the code that sets the key.
Answer from the code without running the app.
Check the key handling against these rules:
- The key comes in through IRONPPT_LICENSE_KEY at startup and nowhere else.
- No appsettings file has an IronPPT.LicenseKey entry.
- The key isn't set in Properties/launchSettings.json either.
- If the variable is missing, startup logs a single warning with its name and no value.
- IronPPT licensing errors get logged by type name only, because their message can contain the key.
If that warning is missing, add it to Program.cs and change nothing else.
For each other rule that fails, give me the file and line.
ライセンスキーなしでは、IronPPT 2026.10.1はメモリ内でデッキを作成し、既存のPPTXファイルを開きました。Saveは「Production License Required」というタイトルのLicensingExceptionをスローし、出力ファイルは表示されませんでした。 校正ページで最初の無免許ダウンロードは871ms後に失敗し、後のものは33〜48msで失敗しました。 ハンドラーはタイプ名でLicensingExceptionに一致させる必要があります。なぜなら、そのタイプは公開されていないからです。
無効なキーでは、LicensingExceptionメッセージが指定されたキーのテキストを繰り返しました。 例外メッセージを表示した校正ダウンロードは、そのキーのテキストを応答に返しました。 メッセージを記録するログエントリは同じテキストを含んでいるため、上記のルールでログにはタイプ名のみが記録されます。
後のタスクに対してデッキのルールをどのように適用しますか?
すべての行が合格した場合、セッションの決定をルールとして記録します。 Antigravityのルール文書によると、CLIはリポジトリルートからAGENTS.md、GEMINI.md、および.agents/rulesを読み取ります。 /learnコマンドは、セッションからの修正を持続的なルールに凝縮します。
/learn Save what this session decided in a new AGENTS.md at the repo root.
Put it under the heading "Status decks" and cover these points:
- what a new PresentationDocument holds before any slide is added
- the unit of Position, Width and Height, and the slide size
- how each text box gets a position of its own
- how the deck's bytes reach the HTTP response
- that the key comes only from IRONPPT_LICENSE_KEY and is never printed, logged or stored
- that no command lists the environment variables
- that a change is done once every row of TestData/expected-decks.csv passes in /browser
Show me the file when you're done.
複数の人が同時にダウンロードした場合に何が起こりますか?
IronPPTは、各リクエストが独自のPresentationDocumentを構築し、独自のファイルに保存する場合でも、2つのリクエストを同時に使用するのは安全ではありません。メモリ上で16スレッドでデッキを構築してもエラーは発生しませんでした。 並行スレッドでの保存または読み込みは、InvalidOperationExceptionやIOExceptionなどのエラーで失敗し、例外なしに保存されたファイルには別のデッキのスライドが含まれていました。 Saveの周りでロックをかけ、単独で読み込みし、ビルドをロックせずに残すと、32デッキのうち1〜10は依然として失敗しました。
校正アプリでは、12の同時ダウンロードがあり、各プロジェクトごとに2つずつ、3回実行されました。 ロックなしでは、36の応答のうち30がHTTP 500を返し、6つの提供されたデッキのうち4つが間違っていました。 すべてのIronPPTコールで1つのロックをかけると、36の応答がすべて正しいデッキを保持し、最も遅いものは1,066msかかりました。
/plan On Monday mornings a dozen project managers download their decks within seconds of each other.
Write an Implementation Plan Artifact first, and wait for my approval before any edit.
Once I approve, measure the effect on the site before you touch the code:
1. Run the site in a separate process.
2. Send 12 download requests at once, two per project.
3. Save each response and check its slide count and title against TestData/expected-decks.csv.
4. Search each file for text from another project.
5. Count the failed responses and the files that don't match.
Then fix the root cause. Every download has to stay under two seconds.
After the fix, send the 12-request burst three more times.
Give me these results:
- the counts before the fix and for each later burst
- the first error from the log
End by stopping the site's dotnet process through its PID.
期待されるサービスは、この例に似ており、IronPPT 2026.10.1でコンパイルされます。これから構築されたデッキは、最初のスライドに空のTitle 1とSubtitle 2プレースホルダーを保持します。それらを削除するには、最初のAddText呼び出しの前に、title.TextBoxes.ToList()の各項目に対してRemoveを呼び出してください。
using IronPPT;
using IronPPT.Enums;
using IronPPT.Models;
namespace StatusDesk.Services;
public sealed class DeckBuilder(IWebHostEnvironment env)
{
// IronPPT is not safe to run on two requests at once, so every IronPPT call goes through this lock.
private static readonly object IronPptLock = new();
private static readonly Dictionary<string, string> StatusColors = new()
{
["Green"] = "#00B050",
["Amber"] = "#FFC000",
["Red"] = "#C00000",
};
public byte[] Build(Project project, string reportWeek)
{
lock (IronPptLock)
{
var deck = new PresentationDocument();
Slide title = deck.Slides[0];
AddText(title, project.Name, x: 40, y: 180, width: 640, height: 70, points: 40, bold: true);
AddText(title, $"Status report, week of {reportWeek}", x: 40, y: 260, width: 640, height: 40, points: 24);
AddText(title, $"Owner: {project.Owner}", x: 40, y: 310, width: 640, height: 40, points: 20);
Slide status = deck.AddSlide(new Slide());
AddText(status, "Status", x: 40, y: 30, width: 500, height: 60, points: 32, bold: true);
status.AddShape(new Shape
{
Type = ShapeType.Rectangle,
FillColor = new Color(StatusColors[project.Status]),
Position = (40, 110),
Width = 160,
Height = 60,
});
AddText(status, project.Status, x: 220, y: 120, width: 300, height: 40, points: 28, bold: true);
AddText(status, project.Summary, x: 40, y: 200, width: 640, height: 120, points: 20);
string logo = Path.Combine(env.ContentRootPath, "App_Data", "logos", project.Id + ".png");
if (File.Exists(logo))
{
try
{
var image = status.AddImage(logo);
image.Position = (560, 30);
image.Width = 120;
image.Height = 60;
}
catch (IronPPT.Models.Exceptions.ImageLoadException)
{
}
}
// Milestone and risk slides follow the same AddText pattern.
string path = Path.Combine(Path.GetTempPath(), $"status-{Guid.NewGuid():N}.pptx");
try
{
deck.Save(path);
return File.ReadAllBytes(path);
}
finally
{
File.Delete(path);
}
}
}
private static void AddText(Slide slide, string text, double x, double y, int width, int height, double points, bool bold = false)
{
slide.AddText(new Text(text)
{
TextStyle = new TextStyle { IsBold = bold, TextFont = new Font { LatinFont = "Calibri", FontSize = points } },
});
var box = (TextBox)slide.TextBoxes[^1];
box.Position = (x, y);
box.Width = width;
box.Height = height;
}
}
Saveはファイルパスのみを受け入れるため、例は一時ファイルを書き込み、そのバイトを返します。
複数のエージェントを派遣するのはいつですか?
一部の確認でブラウザが不要な場合に、第2のエージェントを派遣します。
Split this work between two agents.
Agent A writes an xUnit project, StatusDesk.Tests, with these tests:
- For each row of TestData/expected-decks.csv, check the slide count and title text.
- Check the status rectangle's fill color in the saved file's slide XML.
- Build and save all six decks on parallel threads, then check each file holds only its project.
The tests follow AGENTS.md and these rules:
- They copy IRONPPT_LICENSE_KEY into IronPPT.License.LicenseKey before any save.
- They build decks through the site's own deck code and never start the site.
- The web project is the repo root, so its compile items skip StatusDesk.Tests.
Agent A runs them with dotnet test StatusDesk.Tests.
Agent B starts once that suite passes:
1. Use /browser to download every deck.
2. Send the 12-request burst again.
3. Put a screenshot of each download in the Walkthrough, and note there that the tests passed first.
Tell me what each agent found.
IronPPTで保存されたデッキを読み返したテストは、テキストを無傷で受け取ります。 位置とサイズは設定された値より12,700倍大きく返され、塗りつぶしとテキストの色は#00000000として返されたため、カラーチェックはスライドXMLを読む必要があります。
プロンプトが実運用で生成したものは何ですか?
すべての6つのプロンプトは、単一のAntigravity CLI会話で無人で実行され、許可プロンプトはスキップされました。 アプリケーションはIRONPPT_LICENSE_KEYのみを通じてライセンスキーを受け取りました。 すべてのデッキもダウンロードされ、独立してチェックされ、最初のプロンプトの後と最終アプリケーションで一度チェックされました。
- 編集前、新しいドキュメントの最初のスライドで2つの空のプレースホルダーが見つかり、ビルドでそれらが削除されました。
- 最初のプロンプトの後、6つのデッキすべてが予期されたスライド数とタイトルを持っていました。
- テキストボックスが他のものと重ならず、スライドの端を超えることはありませんでした。
- 最初のビルドでは、12の同時ダウンロードの3つのバーストが3、1、3の正しいデッキを返しました。
- そのバーストでは、36リクエストのうち27がデッキの代わりにHTTP 200でエラーページを受け取りました。
- 提供されたデッキのうち2つは間違っており、1つのBorealis Mobile AppデッキにはDelta Office Moveプロジェクトの名前が含まれていました。
- エージェントの修正は、各デッキの構築と保存の周りに1つのロックを置きました。
- 修正はまた、最初のステータスページへのリクエストで6つすべてのデッキを構築し、プロジェクトデータやロゴが変更されるまでそのバイトをメモリに保持しました。
- 修正後、3つの独立したバーストが36の正しいデッキを36つ中から返し、最も遅いダウンロードは14msかかりました。 すべての応答はメモリに保持されたデッキから来たので、これらのバーストはロックを行使しませんでした。 並行セクションの校正テストは、ロックが機能していることを示す測定です。
- 400x200ピクセルのロゴは152x110ポイントで描かれ、歪んでいました。
- キーがないと、ページには「ステータスデッキはそのプロジェクトのために生成できません」表示されました。
- 無効なキーは応答にもログにも表示されませんでした。
- /learnは7つのポイントを含むAGENTS.mdをリポジトリルートに書き出しました。
- 13のxUnitテストはキーでパスし、キーなしでは失敗しました。
- 2エージェントプロンプトは、各エージェントを独自の子会話で実行し、エージェントBはテストが完了した後に始まりました。
- 一部のステップはページと異なる方法で実行されました。 /browserサブエージェントはまずChromeに到達できなかったため、エージェントは自体でリモートデバッグ付きでChromeを起動しました。 そのステップはまた、ユーザーのChromeプロファイルのDevToolsActivePortファイルを書き換えました。ブラウザのスクリーンショットにはスタイルシートがない状態でページが表示され、通常の独立したチェックでは正常に読み込みました。 両方の計画優先プロンプトは、ランが承認を送信するまで計画の後で停止しました。 セットアップの確認は何も記録しないキャッチブロックを報告し、その後の並行プロンプトで置き換えられました。
ChatGPT Codexはタスクの名前付き部品を探索者と作業者のエージェントに割り当て、GitHub CopilotはこのガイドがAGENTS.mdで行うように規定されたルールを記録ファイルに保持します。 ハブページの共有ラン記録には、Antigravityのバージョン、モデル、ランの時間、テストマシンが一覧されています。
トラブルシューティング
- スライド上のテキスト、スタイリング、画像、図形用のスライド要素
- 余分な空白スライドでデッキが開くときにスライドを追加
- テキストスタイルや段落用のテキスト追加
- 画像サイズと位置のための画像管理
- サーバーで
Saveがスローされるときのライセンスキーの適用
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。