Cómo usar IronPPT con Google Antigravity

Curtis Chau
Curtis Chau
Actualizado: 19 de octubre de 2026

Una oficina de gestión de proyectos publica un informe de estado para cada proyecto todos los lunes. En StatusDesk, la aplicación web de la oficina, un gestor de proyectos hace clic en Descargar informe de estado en la fila de un proyecto y recibe un archivo PowerPoint que el servidor creó hace un momento. Un informe puede descargarse sin error y aún abrirse con una diapositiva en blanco al inicio, cuadros de texto apilados uno sobre otro u otras diapositivas de un proyecto diferente. Ninguno de estos fallos aparece en un registro de compilación.

Google Antigravity puede verificar la página de la misma manera en que lo usa un gestor de proyectos. Su comando /browser lanza un navegador subagente en entorno seguro que hace clic en cada botón de descarga y captura una captura de pantalla. IronPPT genera el informe en el servidor a partir de texto, formas e imágenes, los elementos cubiertos en el tutorial de elementos de diapositiva de IronPPT. Esta guía construye la página con ambas herramientas y la verifica contra seis proyectos cuyos informes se conocen de antemano.

Esta guía está destinada a desarrolladores que utilizan agentes de IA para escribir código .NET que produce archivos de PowerPoint en un servidor web. No aborda el diseño de diapositivas ni las plantillas corporativas.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronPPT

Instale IronPPT ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Con el proyecto StatusDesk abierto en Antigravity, describe la página de estado.

/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

Una compilación exitosa no demuestra ninguna de las tres respuestas, así que léelas en el plan antes de aprobarlo.

IronPPT no lee IRONPPT_LICENSE_KEY por sí solo. En nuestra prueba, License.IsLicensed permaneció falso cuando esa variable sola fue configurada, mientras que una variable de entorno llamada IronPPT.LicenseKey autorizó el proceso sin ningún código. Asignar License.LicenseKey al inicio mantiene el nombre de la variable bajo el control de la aplicación. La guía de la clave de licencia describe otras maneras de aplicar la clave.



¿Qué es Google Antigravity y en qué se diferencia de un asistente de chat?

Según la descripción general de Google, la aplicación Antigravity es una aplicación de escritorio autónoma para lanzar, orquestar e inspeccionar equipos de agentes de IA. Sus agentes devuelven Artefactos, como un Plan de Implementación, una Guía y capturas de pantalla, mientras que un asistente de chat devuelve texto.

Un agente que elige un nombre de paquete sin revisarlo puede instalar malware, porque los atacantes publican paquetes bajo nombres que los modelos de lenguaje imaginan. Este ataque se llama utilización de nombres semejantes. Nombra el paquete IronPPT y su versión en cada tarea que añada un paquete. La guía de asistentes de codificación de IA lista los archivos de documentación de IronPPT para agentes, y su prueba de aceptación se ajusta a un solo aviso.

¿Qué deberías verificar en el plan, los cambios de código y la guía?

En el plan, compara cada respuesta con los contenidos del informe medidos a continuación. En los cambios de código, encuentra dónde cada cuadro de texto recibe su posición, y confirma cada miembro de IronPPT en la referencia API.

La guía debería contener una captura de pantalla de cada descarga. En la aplicación de escritorio, Antigravity almacena cada captura de pantalla como un artefacto de imagen que acepta comentarios, de modo que un comentario en la fila incorrecta identifica el proyecto sin un nuevo aviso.

¿Cómo pruebas el botón de descarga en un navegador real?

Proporciona /browser una tabla que solo puede completar descargando cada informe y abriendo el archivo.

/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

Los seis proyectos cubren los casos que un informe de estado debe manejar. Atlas y Borealis tienen un logotipo y riesgos abiertos, Cobalt no tiene archivo de logotipo, y Delta no tiene riesgos, por lo que su informe termina después de los hitos. El logotipo para Ember contiene una página de error HTML de una exportación fallida en lugar de una imagen, y Fjord tiene siete hitos, que necesitan una segunda diapositiva de hitos.

StatusDesk /Página de estado que muestra seis proyectos, cada uno con un botón de descarga de informe de estado

La página de /Status después de la descarga para P-102, tal como la captura final del navegador la capturó sin sus hojas de estilo.

Resultado

El informe Borealis que se muestra a continuación es el archivo que la última descarga del navegador bajó, sin cambios.

Descargar estado-P-102.pptx

El informe de estado de la aplicación móvil Borealis, cuatro diapositivas con el logotipo en la segunda.

¿Qué contiene un nuevo informe de IronPPT antes de que agregues cualquier cosa?

Cada nuevo PresentationDocument comienza con una diapositiva. Esa diapositiva usa el diseño de Diapositiva de Título y mantiene dos marcadores de posición vacíos, Título 1 y Subtítulo 2, y AddSlide se añade después de ella. La guía para añadir diapositivas señala la diapositiva existente.

La diapositiva es 4:3, 720 por 540 puntos. Position, Width y Height toman valores en puntos, por lo que un ancho de 100 escribe 1,270,000 EMU. Los comentarios en el tutorial de elementos de diapositiva que llaman a la unidad píxeles están equivocados para IronPPT 2026.10.1.

Slide.AddText crea un cuadro de texto sin posición, como midió el artículo del centro de IronPPT. Configurar Position, Width y Height en el último elemento de Slide.TextBoxes coloca el cuadro que la llamada agregó. Font.FontFamily no escribe ningún tipo de letra en el archivo, y Font.LatinFont sí lo hace.

Una compilación de calibración que llamó a AddSlide para cada diapositiva y AddText sin posiciones abrió los seis informes con una diapositiva en blanco, y de 6 a 15 cuadros de texto en cada informe compartían una posición. Una segunda compilación que reutilizó la diapositiva existente y posicionó cada cuadro de texto aprobó los seis proyectos.

¿Cómo configuras un proyecto en el que Antigravity pueda trabajar?

Inicia el agente en un repositorio que compila y sirve una página. El proyecto de esta guía se creó con dotnet new mvc -f net9.0 y se construyó una vez antes del primer aviso. Su perfil http en Properties/launchSettings.json sirve al puerto 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

Sin una clave de licencia, IronPPT 2026.10.1 construyó un informe en memoria y abrió un archivo PPTX existente. Save lanzó una LicensingException titulada "Licencia de Producción Requerida", y no apareció ningún archivo de salida. En la página de calibración, la primera descarga sin licencia falló después de 871 ms y las siguientes de 33 a 48 ms. Un manejador tiene que igualar la LicensingException por nombre de tipo, porque el tipo no es público.

Con una clave no válida, el mensaje de LicensingException repitió el texto de la clave que se le dio. Una descarga de calibración que mostró el mensaje de la excepción devolvió ese texto de clave en la respuesta. Una entrada de registro que registra el mensaje lleva el mismo texto, por eso la regla anterior registra solo el nombre del tipo.

¿Cómo aplicas las reglas del informe a tareas posteriores?

Cuando cada fila se apruebe, registra las decisiones de la sesión como reglas. Según la documentación de reglas de Antigravity, el CLI lee AGENTS.md, GEMINI.md y .agents/rules desde la raíz del repositorio y desde subdirectorios. El comando /learn condensa correcciones de la sesión en reglas persistentes.

/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

¿Qué sucede cuando varias personas descargan a la vez?

IronPPT no es seguro para usar en dos solicitudes al mismo tiempo, incluso cuando cada solicitud construye su propio PresentationDocument y guarda en su propio archivo. Construir informes en memoria en 16 hilos no produjo errores. Guardar o cargar en hilos paralelos falló, con errores como InvalidOperationException y IOException, y algunos archivos que se guardaron sin una excepción contenían diapositivas de otro informe. Con un bloqueo alrededor de Save y cargando solo y construyendo sin bloqueo, de 1 a 10 de 32 informes aún fallaron.

En la aplicación de calibración, 12 descargas simultáneas, dos para cada proyecto, se ejecutaron tres veces. Sin un bloqueo, 30 de las 36 respuestas devolvieron HTTP 500 y 4 de los 6 informes entregados estaban equivocados. Con un bloqueo alrededor de cada llamada de IronPPT, las 36 respuestas contenían el informe correcto, y la más lenta tomó 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

El servicio esperado se asemeja a este ejemplo, que se compila con IronPPT 2026.10.1. Los informes construidos a partir de él mantienen los marcadores de posición vacíos de Título 1 y Subtítulo 2 en la primera diapositiva. Para eliminarlos, llama a Remove en cada elemento de title.TextBoxes.ToList() antes de la primera llamada a 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 solo acepta una ruta de archivo, por lo que el ejemplo escribe un archivo temporal y devuelve sus bytes.

¿Cuándo deberías enviar más de un agente?

Despacha un segundo agente cuando parte de la verificación no necesita un navegador.

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

Una prueba que lee un informe guardado de nuevo con IronPPT recibe el texto intacto. Las posiciones y tamaños regresaron 12,700 veces más grandes que los valores establecidos, y los colores de relleno y texto regresaron como #00000000, por lo que una verificación de color tiene que leer el XML de la diapositiva.

Por favor, tenga en cuenta: En la ejecución de prueba, el Agente B escribió una guía y el Agente A no lo hizo, así que lee la respuesta final de cada agente antes de fusionar.

¿Qué produjeron los prompts en una ejecución real?

Los seis avisos se ejecutaron sin supervisión en una sola conversación del CLI de Antigravity, con los avisos de permiso omitidos. La aplicación recibió la clave de licencia solo a través de IRONPPT_LICENSE_KEY. Cada informe también fue descargado y verificado independientemente, una vez después del primer aviso y de nuevo en la aplicación final.

  • Antes de cualquier edición, el plan encontró los dos marcadores de posición vacíos en la primera diapositiva de un nuevo documento, y la compilación los eliminó.
  • Después del primer aviso, los seis informes tenían el conteo de diapositivas y el título esperados.
  • Ningún cuadro de texto se superpuso con otro o se salió del borde de la diapositiva, en ninguna de las verificaciones.
  • En esa primera compilación, tres arranques de 12 descargas simultáneas devolvieron 3, 1 y 3 informes correctos.
  • En esos arranques, 27 de las 36 solicitudes recibieron la página de error, con HTTP 200, en lugar de un informe.
  • Dos informes entregados estaban equivocados, y un informe de la aplicación móvil Borealis contenía el nombre del proyecto de mudanza de la oficina Delta.
  • La corrección del agente colocó un bloqueo alrededor de la construcción y el guardado de cada informe.
  • La corrección también construyó los seis informes en la primera solicitud a la página de estado y mantuvo sus bytes en memoria hasta que los datos del proyecto o un logotipo cambió.
  • Después de la corrección, tres arranques independientes devolvieron 36 informes correctos de 36, y la descarga más lenta tomó 14 ms. Cada respuesta provenía de los informes mantenidos en memoria, por lo que estos arranques no ejercieron el bloqueo. La prueba de calibración en la sección de concurrencia es la medida que muestra que el bloqueo funciona.
  • Los logotipos de 400 por 200 píxeles se dibujaron a 152 por 110 puntos, lo que los distorsionó.
  • Sin una clave, la página mostraba "No se pudo generar el informe de estado para ese proyecto."
  • Una clave no válida no apareció ni en la respuesta ni en el registro.
  • /learn escribió AGENTS.md en la raíz del repositorio con los siete puntos.
  • Todas las 13 pruebas xUnit pasaron con la clave y fallaron sin ella.
  • El aviso de dos agentes ejecutó cada agente en su propia conversación secundaria, y el Agente B comenzó después de que las pruebas pasaran.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El subagente /browser no pudo llegar a Chrome al principio, así que el agente inició Chrome con depuración remota por sí mismo. Ese paso también reescribió el archivo DevToolsActivePort en el perfil de Chrome del usuario. Las capturas de pantalla del navegador mostraron la página sin sus hojas de estilo, que se cargaron normalmente en la verificación independiente. Ambos avisos primero de plan se detuvieron después del plan hasta que la ejecución envió una aprobación. La verificación de configuración reportó un bloque de captura que no registró nada, y el aviso de concurrencia lo reemplazó más tarde.

ChatGPT Codex asigna partes nombradas de una tarea a agentes exploradores y de trabajo, y GitHub Copilot mantiene sus reglas permanentes en archivos de instrucciones comprometidos, como esta guía lo hace con AGENTS.md. El registro de ejecución compartido en la página del centro lista la versión de Antigravity, el modelo, la duración de la ejecución y la máquina de prueba.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 7,110Versión:2026.11recién lanzado