Cómo usar IronWord con Google Antigravity

Curtis Chau
Curtis Chau
Actualizado: 19 de octubre de 2026

Los ingenieros de campo envían informes de inspección como archivos de Word, y las fotos incrustadas son la evidencia. Una página de revisión que se construye sin errores aún falla cuando omite fotos, imágenes dentro de tablas, asigna pies de foto incorrectos o informa tamaños de fotos inexactos. Un registro de construcción no documenta ninguno de estos fallos.

Google Antigravity puede probar la página como lo haría un revisor. Un subagente de navegador en sandbox, iniciado con el comando /browser, abre la página, elige cada informe en el control de archivos y toma una captura de pantalla del resultado. En el servidor, IronWord abre los archivos DOCX subidos y devuelve sus fotos a través de ExtractImages, sin necesidad de instalar Microsoft Office. La página de revisión a continuación se construye con ambas herramientas y se prueba contra seis informes con cantidades de fotos, pies de fotos y tamaños en píxeles conocidos.

La guía es para desarrolladores que tienen agentes de IA que escriben código .NET que lee documentos de Word. Generar los informes con un modelo de IA está fuera del alcance.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronWord

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

Describe la página de revisión en un aviso de /plan una vez que Antigravity tenga abierto el proyecto Blazor.

/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

Una construcción exitosa no responde ninguna de las tres preguntas que el plan debe cubrir. La guía de modos de renderizado de Microsoft explica cuándo una página es interactiva, y la guía de carga de archivos de Blazor cubre el manejo de cargas y límites de tamaño.

Proporcione al agente el nombre de la variable, pero no comparta su valor. IronWord también lee una entrada IronWord.LicenseKey en appsettings.json, un archivo que un commit puede incluir por error. La guía de claves de licencia enumera todas las ubicaciones en las que IronWord busca la clave.



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

La visión general de Google describe la aplicación Antigravity como una aplicación de escritorio que lanza, orquesta e inspecciona equipos de agentes. Un agente ejecuta comandos, lee y escribe archivos y controla un navegador Chrome en sandbox. Un asistente de chat responde con texto, mientras que un agente devuelve Artefactos, por ejemplo, un Plan de Implementación.

En un ataque de slopsquatting, alguien registra un paquete bajo un nombre que los agentes de IA producen para bibliotecas que nunca se publicaron, y un agente que solicita ese nombre instala el código del atacante. Nombre el paquete IronWord en cada tarea que involucre paquetes. La guía de asistentes de codificación de IA del hub enumera los archivos de documentación de IronWord para agentes y contiene una prueba de aceptación de un solo aviso.

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

Además de las tres respuestas solicitadas por el aviso de Inicio Rápido, el Plan de Implementación debe indicar el mensaje producido para un informe sin fotos. Entre los cambios de código, encuentre la línea que calcula el tamaño en píxeles y verifique cada miembro de IronWord contra la referencia de API.

Cada informe necesita su propia captura de pantalla en el Recorrido, junto a la tabla de resultados. Antigravity guarda capturas de pantalla como artefactos de imagen, y un lector puede comentar cualquiera de ellas. Un comentario en una captura de pantalla que muestra un pie de foto bajo la foto incorrecta le dice al agente qué imagen corregir.

¿Cómo prueba la página de revisión de IronWord en un navegador real?

Proporcione a /browser una tabla de resultados cuyos celdas se llenan solo subiendo cada archivo.

/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

Los seis informes cubren los diseños que una página de fotos debe manejar. Uno contiene un PNG, un JPEG y un GIF, y otro almacena fotos en celdas de tabla. Otro incluye un logotipo en el encabezado de la página, uno coloca la misma imagen dos veces, uno no contiene fotos y otro es un informe de 7.7 MB con cuatro fotos de 12 MP.

Por favor, tenga en cuenta: Revise primero la captura de pantalla del informe de resolución completa, porque muestra si el límite aumentado tuvo efecto.

¿Qué causa fotos faltantes o incorrectas?

En nuestras pruebas, cada fila fallida resultó de una de tres causas. Para identificarlas, el código de extracción de la guía de extracción de imágenes de IronWord se copió en un manejador de carga en un nuevo proyecto Blazor de .NET 9, y los seis informes fueron procesados a través de Chrome sin cabeza.

Lo que muestra la páginaCausaReparar
Sin salida para ningún informeRenderizado estático@rendermode InteractiveServer
Sin salida, y el registro del servidor permanece vacíoEl constructor del documento lee el flujo de carga de manera sincrónicaLoadAsync en el flujo de carga
Un error solo para el informe de resolución completaEl límite de carga predeterminado de 512,000 bytesUn límite por encima del informe más grande

La segunda fila es la más difícil de diagnosticar. El constructor arrojó NotSupportedException con el mensaje "Las lecturas sincrónicas no son compatibles." La excepción se hizo visible solo cuando el manejador la capturó y registró.

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

Proporcione a Antigravity un repositorio que ya construya y sirva una página. El proyecto de prueba vino de dotnet new blazor -int Server -f net9.0 y se construyó con 0 errores antes de que se ejecutara cualquier aviso. La plantilla escribe un puerto aleatorio en el perfil http de Properties/launchSettings.json, así que copie esa URL en el aviso de /browser.

La siguiente tarea audita el paquete y la clave de licencia.

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

Cita la versión reportada en tareas posteriores. IronWord 2026.10.4 abrió cada informe y extrajo cada foto sin ninguna clave de licencia. Guardar lanzó una LicensingException que decía "Se requiere licencia de producción". Por lo tanto, una clave faltante se hace evidente solo cuando la aplicación escribe un archivo por primera vez, lo cual esta página de solo lectura nunca hace.

¿Cómo se aplican las reglas de la página a tareas posteriores?

Después de que las seis filas pasen, registre lo que decidió la sesión. La documentación de reglas de Antigravity dice que cada vez que el agente lee o edita un archivo, carga cualquier GEMINI.md o AGENTS.md que encuentre en cada carpeta entre ese archivo y la raíz del espacio de trabajo. /learn convierte la retroalimentación de la sesión en reglas del proyecto persistentes.

/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

Una vez que el archivo existe, el modo de renderizado y el límite de carga se registran en un solo lugar que cada tarea lee. El agente no actualiza ese archivo automáticamente. Solicite la actualización en la misma tarea que cambia el valor.

¿Cómo carga un informe subido con IronWord?

Especifique el resultado y la evidencia, y permita que el agente estructure el código.

/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

Espere un servicio similar a este ejemplo. Compila con IronWord 2026.10.4, y la página de prueba de calibración que lo utiliza enumeró correctamente el recuento de fotos, pies de foto y tamaños en píxeles para los seis informes.

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#

La verificación de tamaño utiliza el valor informado por el navegador, por lo que un archivo de gran tamaño falla antes de que se abra el flujo de carga. La guía de carga de Microsoft aconseja no confiar únicamente en este valor proporcionado por el cliente, y el límite establecido en OpenReadStream impone el límite real. La lectura del informe de resolución completa tomó 1,118 ms y 1,280 ms en dos ejecuciones de calibración. Para evitar transferencias de datos grandes, el servicio genera miniaturas escaladas en lugar de enviar imágenes de tamaño completo al navegador.

¿Qué imágenes extrae IronWord de un documento?

El método ExtractImages devuelve las fotos ubicadas en el cuerpo del documento y en las celdas de tabla. Omite el logotipo en el encabezado de la página, por lo que un membrete no cuenta como una foto del sitio. Si una foto aparece varias veces, se devuelve una vez por cada ubicación, cada una con su propio tamaño.

Cada resultado incluye su ancho y alto en puntos. Por ejemplo, una foto de 3 pulgadas de ancho se informa como 216 puntos, independientemente de la resolución. El servicio de muestra retiene estos valores de puntos. Para convertir a pulgadas, divida por 72 o use GetWidth(MeasurementUnit.Inch), como demostró el agente. El tamaño en píxeles se obtiene de la imagen decodificada, ya sea convirtiendo la propiedad Image a AnyBitmap o decodificando la cadena Base64 en ImageData.

La lista de párrafos incluye párrafos dentro de las celdas de tabla en orden de lectura, por lo que seleccionar el siguiente párrafo con texto asigna el pie de foto de la primera foto a la segunda foto de tabla. El ExtractText del documento también omite el texto de la tabla, por lo que su salida no contiene pies de foto de tabla.

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

Divida las verificaciones entre dos agentes. Uno prueba el servicio en el código. El otro reproduce las cargas del revisor en el navegador.

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

Las pruebas que abren informes desde el disco no necesitan ni un navegador ni una aplicación en ejecución, por lo que detectan una regresión de pies de foto antes de un pase de /browser.

Por favor, tenga en cuenta: En la aplicación de escritorio, cada agente puede ejecutarse como una tarea separada. Compare los dos Recorridos antes de fusionarlos.

¿Cómo despliega la página en un contenedor Linux?

Además de sus ensamblados gestionados, IronWord 2026.10.4 contiene una biblioteca de diseño nativa construida para Windows (x64 y x86), linux-x64 y 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 no es necesario para listar los archivos nativos, porque la carpeta de publicación en Windows contiene los mismos archivos que recibe la imagen. La publicación de la aplicación de calibración para linux-x64 produjo un archivo nativo, libLayoutEngineInterop.so (8,303,240 bytes). Ese archivo solo enlaza contra glibc, y el paquete no tiene compilación para musl o linux-arm64, por lo que esta versión no tiene biblioteca nativa para imágenes Linux de Alpine o ARM64. En Windows, cargar y extraer fotos no cargó la biblioteca nativa. La guía de Docker de IronWord recomienda usar imágenes de Ubuntu, Debian o RHEL.

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

Una sesión CLI de Antigravity ejecutó los siete avisos ininterrumpidamente y omitió cada aviso de permiso. La aplicación leyó la clave de licencia solo de IRONWORD_LICENSE_KEY. Subimos cada informe en Chrome sin cabeza dos veces, una vez con el código del primer aviso y otra vez con el código final.

  • Las cuentas de fotos y los tamaños en píxeles fueron correctos para los seis informes en ambas verificaciones de Chrome.
  • Los pies de foto pasaron de ninguno después del primer aviso, que no pedía ninguno, a 12 de 12 correctos en la aplicación final.
  • Las compilaciones de liberación de la aplicación y el proyecto de prueba informaron 0 advertencias y 0 errores.
  • Pasaron todas las siete pruebas de xUnit.
  • La publicación linux-x64 incluyó una biblioteca nativa.
  • Cada uno de los tres pases de navegador procesó los seis informes a través del selector de archivos.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El aviso de Inicio Rápido ya estableció el límite de 30 MB y copió cada carga en memoria, por lo que ninguna de las tres causas mencionadas anteriormente apareció. Cada aviso de /plan se detuvo después de su plan hasta que llegó una aprobación. Agente A y Agente B ejecutaron en un turno de la misma conversación. Las miniaturas fueron redimensionadas con SixLabors.ImageSharp, una dependencia transitiva de IronWord. El agente comprometió las capturas de pantalla del primer pase de navegador y la carpeta de publicación out/linux.
  • /learn no escribió AGENTS.md. Su Artefacto enumeró los seis puntos y pidió confirmación primero.

La guía ChatGPT Codex procesa toda una carpeta de documentos de Word en paralelo bajo un límite de concurrencia, donde esta página maneja una carga a la vez. La guía de Claude Code aprueba un diseño en modo plan antes de cualquier cambio de archivo, como lo hacen aquí los avisos de plan primero.

La versión CLI de Antigravity, el modelo, la duración y la máquina de prueba para esta ejecución están en el registro de la ejecución del hub.


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 62,392Versión:2026.11recién lanzado