Comment utiliser IronPPT avec Google Antigravity

Curtis Chau
Curtis Chau
Mis à jour : 19 octobre 2026

Un bureau de gestion de projet publie un rapport de statut pour chaque projet chaque lundi. Dans StatusDesk, l'application web du bureau, un chef de projet clique sur Télécharger le rapport de statut dans la ligne d'un projet et reçoit un fichier PowerPoint que le serveur a généré peu de temps auparavant. Un rapport peut être téléchargé sans erreur mais s'ouvrir avec une première diapositive vide, des zones de texte empilées les unes sur les autres ou les diapositives d'un autre projet. Aucun de ces défauts n'apparaît dans le journal de compilation.

Google Antigravity peut vérifier la page de la même manière qu'un chef de projet l'utilise. Sa commande /browser lance un sous-agent navigateur isolé qui clique sur chaque bouton de téléchargement et capture une capture d'écran. IronPPT génère le rapport sur le serveur à partir de texte, formes et images, les éléments abordés dans le tutoriel sur les éléments de diapositive d'IronPPT. Ce guide construit la page avec les deux outils et la vérifie par rapport à six projets dont les rapports sont connus à l'avance.

Ce guide est destiné aux développeurs utilisant des agents intelligents pour écrire du code .NET qui produit des fichiers PowerPoint sur un serveur web. Il ne traite pas de la conception des diapositives ou des modèles d'entreprise.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPPT

Installez IronPPT en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Avec le projet StatusDesk ouvert dans Antigravity, décrivez la page de statut.

/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.
Text

Une compilation réussie ne prouve aucune des trois réponses, alors lisez-les dans le plan avant de l'approuver.

IronPPT ne lit pas IRONPPT_LICENSE_KEY par lui-même. Dans notre sonde, License.IsLicensed est resté faux lorsque cette variable seule était définie, tandis qu'une variable d'environnement nommée IronPPT.LicenseKey a autorisé le processus sans aucun code. Attribuer License.LicenseKey au démarrage garde le nom de la variable sous le contrôle de l'application. Le guide de la clé de licence décrit les autres façons d'appliquer la clé.



Qu'est-ce que Google Antigravity, et en quoi est-il différent d'un assistant de chat?

Selon la vue d'ensemble de Google, l'application Antigravity est une application de bureau autonome pour lancer, orchestrer et inspecter des équipes d'agents intelligents. Ses agents retournent des Artefacts, tels qu'un plan d'implémentation, un guide pas-à-pas et des captures d'écran, là où un assistant de chat retourne du texte.

Un agent qui choisit un nom de package sans le vérifier peut installer un logiciel malveillant, car les attaquants publient des packages sous des noms que les modèles de langage hallucinent. Cette attaque s'appelle le slopsquatting. Nommez le package IronPPT et sa version dans chaque tâche qui ajoute un package. Le guide des assistants de codage IA répertorie les fichiers de documentation d'IronPPT pour les agents, et son test d'acceptation tient en une seule invite.

Que devriez-vous vérifier dans le plan, les modifications du code et le guide pas-à-pas ?

Dans le plan, comparez chaque réponse avec le contenu du rapport mesuré ci-dessous. Dans les modifications du code, trouvez où chaque zone de texte reçoit sa position, et confirmez chaque membre d'IronPPT dans la référence API.

Le guide pas-à-pas devrait contenir une capture d'écran de chaque téléchargement. Dans l'application de bureau, Antigravity stocke chaque capture d'écran comme un artefact d'image qui accepte les commentaires, donc un commentaire sur la mauvaise ligne identifie le projet sans nouvelle invite.

Comment tester le bouton de téléchargement dans un vrai navigateur ?

Fournissez à /browser une table qu'il ne peut compléter qu'en téléchargeant chaque rapport et en ouvrant le fichier.

/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.
Text

Les six projets couvrent les cas qu'un rapport de statut doit gérer. Atlas et Borealis ont un logo et des risques ouverts, Cobalt n'a pas de fichier de logo, et Delta n'a pas de risques, donc son rapport se termine après les jalons. Le logo pour Ember contient une page d'erreur HTML d'une exportation échouée au lieu d'une image, et Fjord a sept jalons, ce qui nécessite une deuxième diapositive de jalon.

StatusDesk /Page de statut listant six projets, chacun avec un bouton de téléchargement du rapport de statut

La page /Statut après le téléchargement pour P-102, comme la capture finale du navigateur l'a capturée sans ses feuilles de style.

Sortie

Le rapport Borealis ci-dessous est le fichier que le passage final du navigateur a téléchargé, inchangé.

Télécharger status-P-102.pptx

Le rapport de statut de l'application mobile Borealis, quatre diapositives avec le logo sur la deuxième.

Que contient un nouvel IronPPT avant d'ajouter quoi que ce soit ?

Chaque nouveau PresentationDocument commence par une diapositive. Cette diapositive utilise la disposition de diapositive de titre et garde deux espaceurs vides, Titre 1 et Sous-titre 2, et AddSlide s'ajoute après. Le guide Ajouter une diapositive note la diapositive existante.

La diapositive est en format 4:3, 720 par 540 points. Position, Width et Height prennent des valeurs en points, donc une largeur de 100 écrit 1 270 000 EMU. Les commentaires dans le tutoriel sur les éléments de diapositive qui appellent les unités des pixels sont incorrects pour IronPPT 2026.10.1.

Slide.AddText crée une zone de texte sans position, comme le article central d'IronPPT l'a mesuré. Régler Position, Width et Height sur le dernier élément de Slide.TextBoxes place la boîte que l'appel a ajoutée. Font.FontFamily n'écrit pas de police dans le fichier, et Font.LatinFont le fait.

Un build de calibration qui appelait AddSlide pour chaque diapositive et AddText sans positions ouvrait tous les six rapports avec une diapositive vide, et 6 à 15 zones de texte dans chaque rapport partageaient une position. Un second build qui réutilisait la diapositive existante et positionnait chaque zone de texte a passé tous les six projets.

Comment configurez-vous un projet dans lequel Antigravity peut travailler?

Lancez l'agent sur un dépôt qui compile et sert une page. Le projet de ce guide a été créé avec dotnet new mvc -f net9.0 et construit une fois avant la première invite. Son profil http dans Properties/launchSettings.json sert le 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.
Text

Sans une clé de licence, IronPPT 2026.10.1 a construit un rapport en mémoire et ouvert un fichier PPTX existant. Save a jeté une LicensingException intitulée "Licence de Production Requise", et aucun fichier de sortie n'est apparu. Sur la page de calibration, le premier téléchargement sans licence a échoué après 871 ms et les suivants entre 33 et 48 ms. Un gestionnaire doit correspondre à la LicensingException par nom de type, car le type n'est pas public.

Avec une clé invalide, le message de LicensingException répétait le texte de la clé qu'il avait reçue. Un téléchargement de calibration qui affichait le message d'exception renvoyait ce texte de clé dans la réponse. Une entrée de journal qui enregistre le message porte le même texte, c'est pourquoi la règle ci-dessus enregistre uniquement le nom du type.

Comment appliquez-vous les règles du rapport aux tâches ultérieures ?

Lorsque chaque ligne passe, enregistrez les décisions de la session en tant que règles. Selon la documentation des règles d'Antigravity, le CLI lit AGENTS.md, GEMINI.md et .agents/rules depuis la racine du dépôt et depuis des sous-répertoires. La commande /learn condense les corrections de la session en règles persistantes.

/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.
Text

Que se passe-t-il lorsque plusieurs personnes téléchargent en même temps ?

IronPPT n'est pas sûr à utiliser sur deux requêtes en même temps, même lorsque chaque requête génère son propre PresentationDocument et enregistre dans son propre fichier. Générer des rapports en mémoire sur 16 threads n'a produit aucune erreur. Enregistrer ou charger sur des threads parallèles a échoué, avec des erreurs telles que InvalidOperationException et IOException, et certains fichiers enregistrés sans exception contenaient les diapositives d'un autre rapport. Avec un verrou autour de Save et le chargement seul, et sans verrouillage pour la génération, 1 à 10 des 32 rapports ont encore échoué.

Dans l'application de calibration, 12 téléchargements simultanés, deux pour chaque projet, ont été exécutés trois fois. Sans verrou, 30 des 36 réponses ont renvoyé HTTP 500 et 4 des 6 rapports livrés étaient incorrects. Avec un verrou autour de chaque appel IronPPT, toutes les 36 réponses contenaient le rapport correct, et le plus lent a pris 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.
Text

Le service attendu ressemble à cet exemple, qui compile avec IronPPT 2026.10.1. Les rapports générés à partir de celui-ci conservent les espaceurs vides Titre 1 et Sous-titre 2 sur la première diapositive. Pour les supprimer, appelez Remove sur chaque élément de title.TextBoxes.ToList() avant le premier appel AddText.

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;
    }
}
C#

Save n'accepte qu'un chemin de fichier, donc l'exemple écrit un fichier temporaire et retourne ses octets.

Quand devriez-vous dépêcher plus d'un agent ?

Déléguez un second agent lorsque une partie de la vérification ne nécessite pas de navigateur.

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.
Text

Un test qui lit un rapport enregistré avec IronPPT reçoit le texte intact. Les positions et tailles sont revenues 12 700 fois plus grandes que les valeurs configurées, et les couleurs de remplissage et de texte sont revenues en tant que #00000000, donc une vérification des couleurs doit lire le XML de la diapositive.

Veuillez noter: Dans le test, l'agent B a écrit un guide pas-à-pas et l'agent A ne l'a pas fait, donc lisez la réponse finale de chaque agent avant de fusionner.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Toutes les six invites ont fonctionné sans surveillance dans une seule conversation CLI Antigravity, avec les invites de permission passées. L'application a reçu la clé de licence uniquement par IRONPPT_LICENSE_KEY. Chaque rapport a également été téléchargé et vérifié indépendamment, une fois après la première invite et à nouveau dans l'application finale.

  • Avant toute modification, le plan a trouvé les deux espaceurs vides sur la première diapositive d'un nouveau document, et la construction les a supprimés.
  • Après la première invite, les six rapports avaient le nombre de diapositives attendu et le titre.
  • Aucune zone de texte ne chevauchait une autre ou ne dépassait le bord de la diapositive, lors des deux vérifications.
  • Dans cette première construction, trois rafales de 12 téléchargements simultanés ont retourné 3, 1 et 3 rapports corrects.
  • Dans ces rafales, 27 des 36 requêtes ont reçu la page d'erreur, avec HTTP 200, au lieu d'un rapport.
  • Deux rapports livrés étaient incorrects, et un rapport de l'application mobile Borealis contenait le nom du projet Delta Office Move.
  • La correction de l'agent a placé un verrou autour de la génération et de l'enregistrement de chaque rapport.
  • La correction a également généré les six rapports à la première requête à la page de statut et conservé leurs octets en mémoire jusqu'à ce que les données de projet ou un logo changent.
  • Après la correction, trois rafales indépendantes ont retourné 36 rapports corrects sur 36, et le téléchargement le plus lent a pris 14 ms. Chaque réponse provenait des rapports conservés en mémoire, donc ces rafales n'ont pas exercé le verrou. Le test de calibration dans la section de la concurrence est la mesure qui montre que le verrou fonctionne.
  • Les logos de 400 par 200 pixels ont été dessinés à 152 par 110 points, ce qui les a déformés.
  • Sans clé, la page affichait "Le rapport de statut n'a pas pu être généré pour ce projet."
  • Une clé invalide n'apparaissait ni dans la réponse ni dans le journal.
  • /learn a écrit AGENTS.md à la racine du dépôt avec tous les sept points.
  • Les 13 tests xUnit ont réussi avec la clé et échoué sans elle.
  • L'invite à deux agents a exécuté chaque agent dans sa propre sous-conversation, et l'Agent B a commencé après que les tests aient réussi.
  • Certaines étapes ont été exécutées différemment de la page. Le sous-agent /browser n'a pas réussi à atteindre Chrome au début, donc l'agent a démarré Chrome avec debogage à distance lui-même. Cette étape a également réécrit le fichier DevToolsActivePort dans le profil Chrome de l'utilisateur. Les captures d'écran du navigateur montraient la page sans ses feuilles de style, qui se chargeaient normalement dans le contrôle indépendant. Les deux invites avant le plan se sont arrêtées après le plan jusqu'à ce que l'exécution envoie une approbation. La vérification de l'installation a rapporté un bloc catch qui n'a rien journalisé, et l'invite de concurrence l'a ensuite remplacé.

ChatGPT Codex assigne des parties nommées d'une tâche à des agents explorateurs et travailleurs, et GitHub Copilot conserve ses règles permanentes dans des fichiers d'instruction engagés, comme ce guide le fait avec AGENTS.md. Le journal d'exécution partagé sur la page centrale répertorie la version d'Antigravity, le modèle, la durée de l'exécution et la machine de test.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 7,110Version :2026.11tout juste publié