So verwenden Sie IronPPT mit Google Antigravity
Ein Projektmanagementbüro veröffentlicht jeden Montag ein Status-Deck für jedes Projekt. In StatusDesk, der Web-App des Büros, klickt ein Projektmanager auf 'Status-Deck herunterladen' in der Zeile eines Projekts und erhält eine PowerPoint-Datei, die der Server kurz zuvor erstellt hat. Ein Deck kann ohne Fehler heruntergeladen werden und dennoch mit einer leeren ersten Folie, übereinander gestapelten Textfeldern oder Folien eines anderen Projekts geöffnet werden. Keiner dieser Fehler erscheint in einem Build-Log.
Google Antigravity kann die Seite so überprüfen, wie ein Projektmanager sie nutzt. Sein /browser-Befehl startet einen sandboxed Browser-Unteragenten, der auf jeden Download-Button klickt und einen Screenshot aufnimmt. IronPPT erstellt das Deck auf dem Server aus Text, Formen und Bildern, den Elementen, die im Slide-Element-Tutorial von IronPPT behandelt werden. Dieses Handbuch erstellt die Seite mit beiden Tools und prüft sie anhand von sechs Projekten, deren Decks im Voraus bekannt sind.
Dieses Handbuch ist für Entwickler gedacht, die KI-Agenten nutzen, um .NET-Code zu schreiben, der PowerPoint-Dateien auf einem Webserver erstellt. Es behandelt weder die Gestaltung von Folien noch Unternehmensvorlagen.
SchnellstartBeschreiben Sie die Statusseite, wenn das StatusDesk-Projekt in Antigravity geöffnet ist.
/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.
Ein erfolgreicher Build beweist keine der drei Antworten, lesen Sie sie daher im Plan, bevor Sie ihn freigeben.
IronPPT liest IRONPPT_LICENSE_KEY nicht eigenständig. In unserer Untersuchung blieb License.IsLicensed falsch, wenn nur diese Variable gesetzt war, während eine Umgebungsvariable mit dem Namen IronPPT.LicenseKey den Prozess ohne jeglichen Code lizenzierte. Die Zuordnung von License.LicenseKey beim Start hält den Variablennamen unter Kontrolle der Anwendung. Der Lizenzschlüssel-Leitfaden beschreibt die anderen Möglichkeiten, den Schlüssel anzuwenden.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# PowerPoint-Bibliothek von NuGet herunter
- Beginnen Sie mit einem ASP.NET Core-Projekt, das bereits eine Seite erstellt und bereitstellt.
- Geben Sie jedem Textfeld, jeder Form und jedem Bild eine eigene Position in Punkten.
- Lassen Sie /browser jedes Deck herunterladen und jede Datei mit einer bekannten Liste vergleichen.
- Führen Sie gleichzeitige Downloads durch und bestätigen Sie dann jedes Mitglied in der API-Referenz.
Was ist Google Antigravity und wie unterscheidet es sich von einem Chat-Assistenten?
Laut dem Überblick von Google ist die Antigravity-App eine eigenständige Desktop-Anwendung zum Starten, Orchestrieren und Überwachen von Teams von KI-Agenten. Seine Agenten liefern Artefakte, wie einen Implementierungsplan, eine Anleitung und Screenshots, wo ein Chat-Assistent Text zurückgibt.
Ein Agent, der einen Paketnamen auswählt, ohne ihn zu überprüfen, kann Malware installieren, da Angreifer Pakete unter Namen veröffentlichen, die Sprachmodelle halluzinieren. Dieser Angriff wird slopsquatting genannt. Nennen Sie das IronPPT-Paket und seine Version in jeder Aufgabe, die ein Paket hinzufügt. Der Leitfaden für KI-Coding-Assistenten listet die Dokumentationsdateien von IronPPT für Agenten auf, und sein Akzeptanztest passt in eine einzige Eingabeaufforderung.
Was sollten Sie im Plan, den Codeänderungen und der Anleitung überprüfen?
Vergleichen Sie im Plan jede Antwort mit den unten gemessenen Deck-Inhalten. Finden Sie in den Codeänderungen heraus, wo jedes Textfeld seine Position erhält, und bestätigen Sie jedes IronPPT-Mitglied in der API-Referenz.
Der Walkthrough sollte einen Screenshot jedes Downloads enthalten. In der Desktop-App speichert Antigravity jeden Screenshot als Bildartefakt, das Kommentare akzeptiert, sodass ein Kommentar in der falschen Zeile das Projekt ohne eine neue Eingabeaufforderung identifiziert.
Wie testen Sie den Download-Button in einem echten Browser?
Geben Sie /browser eine Tabelle, die er nur durch das Herunterladen jedes Decks und das Öffnen der Datei abschließen kann.
/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.
Die sechs Projekte decken die Fälle ab, die ein Status-Deck handhaben muss. Atlas und Borealis haben ein Logo und offene Risiken, Cobalt hat keine Logodatei, und Delta hat keine Risiken, sodass sein Deck nach den Meilensteinen endet. Das Logo für Ember enthält eine HTML-Fehlerseite von einem fehlgeschlagenen Export anstelle eines Bildes, und Fjord hat sieben Meilensteine, die eine zweite Meilensteinfolie benötigen.
Die /Status-Seite nach dem Download für P-102, wie der endgültige Browserdurchlauf sie ohne ihre Stylesheets erfasst hat.
Ausgabe
Das Borealis-Deck unten ist die Datei, die der finale Browserdurchlauf unverändert heruntergeladen hat.
Status-P-102.pptx herunterladen
Das Borealis Mobile App Status-Deck, vier Folien mit dem Logo auf der zweiten.
Was enthält ein neues IronPPT-Deck, bevor Sie etwas hinzufügen?
Jedes neue PresentationDocument beginnt mit einer Folie. Diese Folie verwendet das Titel-Folie-Layout und behält zwei leere Platzhalter, Titel 1 und Untertitel 2, und AddSlide wird danach angehängt. Der Folie hinzufügen-Leitfaden weist auf die vorhandene Folie hin.
Die Folie ist 4:3, 720 mal 540 Punkte. Position, Width und Height nehmen Werte in Punkten an, daher schreibt eine Breite von 100 1.270.000 EMU. Die Kommentare im Slide-Element-Tutorial, die die Einheit in Pixeln nennen, sind für IronPPT 2026.10.1 falsch.
Slide.AddText erstellt ein Textfeld ohne Position, wie der IronPPT Hub-Artikel gemessen hat. Das Setzen von Position, Width und Height auf dem letzten Element von Slide.TextBoxes platziert das Feld, das der Aufruf hinzugefügt hat. Font.FontFamily schreibt keine Schriftart in die Datei, und Font.LatinFont tut es.
Ein Kalibrations-Build, der AddSlide für jede Folie und AddText ohne Positionen aufrufte, öffnete alle sechs Decks mit einer leeren Folie, und 6 bis 15 Textfelder in jedem Deck teilten sich eine Position. Ein zweiter Build, der die vorhandene Folie wiederverwendete und jedes Textfeld positionierte, bestand alle sechs Projekte.
Wie richtet man ein Projekt ein, in dem Antigravity arbeiten kann?
Starten Sie den Agenten in einem Repository, das eine Seite kompiliert und bereitstellt. Das Projekt dieses Leitfadens wurde mit dotnet new mvc -f net9.0 erstellt und einmal vor der ersten Eingabeaufforderung erstellt. Sein HTTP-Profil in Properties/launchSettings.json dient dem Port 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.
Ohne einen Lizenzschlüssel erstellte IronPPT 2026.10.1 ein Deck im Speicher und öffnete eine vorhandene PPTX-Datei. Save warf eine LicensingException mit dem Titel "Production License Required", und keine Ausgabedatei erschien. Auf der Kalibrierungsseite scheiterte der erste unlizensierte Download nach 871 ms und spätere Downloads in 33 bis 48 ms. Ein Handler muss die LicensingException anhand des Typnamens zuordnen, da der Typ nicht öffentlich ist.
Mit einem ungültigen Schlüssel wiederholte die LicensingException-Nachricht den übergebenen Schlüsseltext. Ein Kalibrierungs-Download, der die Ausnahmemeldung anzeigte, gab diesen Schlüsseltext in der Antwort zurück. Ein Log-Eintrag, der die Nachricht aufzeichnet, enthält denselben Text, weshalb die obige Regel nur den Typnamen protokolliert.
Wie wendet man die Deck-Regeln auf spätere Aufgaben an?
Wenn jede Zeile bestanden wird, protokollieren Sie die Entscheidungen der Sitzung als Regeln. Laut der Regeln-Dokumentation von Antigravity liest die CLI AGENTS.md, GEMINI.md und .agents/rules aus dem Repository-Stamm und aus Unterverzeichnissen. Der /learn-Befehl komprimiert Korrekturen aus der Sitzung in dauerhafte Regeln.
/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.
Was passiert, wenn mehrere Personen gleichzeitig herunterladen?
IronPPT ist nicht sicher, wenn es gleichzeitig auf zwei Anfragen verwendet wird, selbst wenn jede Anfrage ihr eigenes PresentationDocument erstellt und in ihre eigene Datei speichert. Das Erstellen von Decks im Speicher auf 16 Threads führte zu keinen Fehlern. Das Speichern oder Laden auf parallelen Threads schlug fehl, mit Fehlern wie InvalidOperationException und IOException, und einige Dateien, die ohne Ausnahme gespeichert wurden, enthielten die Folien eines anderen Decks. Mit einem Sperrschutz um Save und Laden allein und Erstellen ungesperrt blieben 1 bis 10 von 32 Decks immer noch fehlerhaft.
In der Kalibrations-App liefen 12 gleichzeitige Downloads, zwei für jedes Projekt, dreimal. Ohne Sperre kehrten 30 der 36 Antworten mit HTTP 500 zurück und 4 der 6 gelieferten Decks waren falsch. Mit einer Sperre um jeden IronPPT-Aufruf enthielten alle 36 Antworten das richtige Deck, und das langsamste dauerte 1.066 ms.
/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.
Der erwartete Service ähnelt diesem Beispiel, das mit IronPPT 2026.10.1 kompiliert wird. Aus ihm erstellte Decks behalten die leeren Titel 1 und Untertitel 2 Platzhalter auf der ersten Folie. Um sie zu löschen, rufen Sie Remove für jedes Element von title.TextBoxes.ToList() vor dem ersten AddText-Aufruf auf.
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 akzeptiert nur einen Dateipfad, daher schreibt das Beispiel eine temporäre Datei und gibt deren Bytes zurück.
Wann sollten Sie mehr als einen Agenten entsenden?
Schicken Sie einen zweiten Agenten, wenn ein Teil der Überprüfung keinen Browser braucht.
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.
Ein Test, der ein gespeichertes Deck mit IronPPT liest, erhält den Text intakt. Positionen und Größen kamen 12.700-mal größer zurück als die eingestellten Werte, und Füll- und Textfarben kamen als #00000000 zurück, daher muss eine Farbprüfung das Folien-XML lesen.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Alle sechs Eingabeaufforderungen liefen unbeaufsichtigt in einem einzigen Antigravity CLI-Gespräch, mit übersprungenen Erlaubnisaufforderungen. Die Anwendung erhielt den Lizenzschlüssel nur über IRONPPT_LICENSE_KEY. Jedes Deck wurde auch unabhängig heruntergeladen und überprüft, einmal nach der ersten Eingabeaufforderung und erneut in der endgültigen Anwendung.
- Vor jeder Bearbeitung fand der Plan die zwei leeren Platzhalter auf der ersten Folie eines neuen Dokuments und der Build entfernte sie.
- Nach der ersten Eingabeaufforderung hatten alle sechs Decks die erwartete Folienanzahl und den Titel.
- Kein Textfeld überlappte ein anderes oder lief über den Folienrand hinaus, bei beiden Überprüfungen.
- In diesem ersten Build kehrten drei Schübe von 12 gleichzeitigen Downloads 3, 1 und 3 korrekte Decks zurück.
- In diesen Schüben erhielten 27 der 36 Anfragen die Fehlerseite, mit HTTP 200, anstelle eines Decks.
- Zwei gelieferte Decks waren falsch, und ein Borealis Mobile App Deck enthielt den Namen des Delta Office Move Projekts.
- Der Fix des Agenten platzierte eine Sperre um das Erstellen und Speichern jedes Decks.
- Der Fix baute außerdem alle sechs Decks bei der ersten Anfrage an die Statusseite und behielt deren Bytes im Speicher, bis sich die Projektdaten oder ein Logo änderten.
- Nach dem Fix kehrten drei unabhängige Schübe 36 richtige Decks von 36 zurück, und der langsamste Download dauerte 14 ms. Jede Antwort kam aus den im Speicher behaltenen Decks, daher übten diese Schübe die Sperre nicht aus. Der Kalibrierungstest im Abschnitt über Gleichzeitigkeit ist die Messung, die zeigt, dass die Sperre funktioniert.
- Die 400x200-Pixel-Logos wurden bei 152x110 Punkten gezeichnet, was sie verzerrte.
- Ohne Schlüssel zeigte die Seite "Das Status-Deck konnte für dieses Projekt nicht generiert werden".
- Ein ungültiger Schlüssel erschien weder in der Antwort noch im Log.
- /learn schrieb AGENTS.md im Repository-Stamm mit allen sieben Punkten.
- Alle 13 xUnit-Tests bestanden mit dem Schlüssel und scheiterten ohne ihn.
- Der Zwei-Agenten-Dialog führte jeden Agenten in einem eigenen Untergespräch aus, und Agent B begann, nachdem die Tests bestanden waren.
- Einige Schritte liefen anders als die Seite. Der /browser-Unteragent konnte Chrome anfangs nicht erreichen, daher startete der Agent Chrome mit eigenem Remote-Debugging. Dieser Schritt schrieb auch die DevToolsActivePort-Datei im Chrome-Profil des Benutzers neu. Die Browser-Screenshots zeigten die Seite ohne ihre Stylesheets, die beim unabhängigen Test normal geladen wurden. Beide Plan-Ersteingabeaufforderungen stoppten nach dem Plan, bis der Lauf eine Freigabe schickte. Der Setup-Check meldete einen catch-Block, der nichts protokollierte, und die Gleichzeitigkeitseingabeaufforderung ersetzte ihn später.
ChatGPT Codex weist benannte Teile einer Aufgabe explorer- und worker-Agenten zu, und GitHub Copilot hält seine stehenden Regeln in festgeschriebenen Anleitungsdateien bereit, wie dieser Leitfaden mit AGENTS.md. Der gemeinsame Laufprotokoll auf der Hub-Seite listet die Antigravity-Version, das Modell, die Laufzeit und die Testmaschine auf.
Fehlerbehebung
- Folienelement für Text, Stil, Bilder und Formen auf einer Folie
- Folie hinzufügen wenn ein Deck mit einer zusätzlichen leeren Folie öffnet
- Text hinzufügen für Textstile und Absätze
- Bild verwalten für Bildgröße und -position
- Anwenden von Lizenzschlüsseln wenn
Saveauf dem Server auslöst.
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.