Como usar o IronWord com o Antigravity do Google

Curtis Chau
Curtis Chau
Atualizado: 19 de outubro de 2026

Os engenheiros de campo submetem relatórios de inspeção como arquivos Word, e as fotos incorporadas são a evidência. Uma página de revisão que é construída sem erros ainda falha ao remover fotos, omitir imagens dentro de tabelas, atribuir legendas incorretas ou relatar tamanhos de fotos imprecisos. Um registro de build não documenta nenhuma dessas falhas.

O Antigravity do Google pode testar a página da mesma forma que um revisor faz. Um subagente de navegador isolado, iniciado com o comando /browser, abre a página, escolhe cada relatório no controle de arquivo e tira uma captura de tela do resultado. No servidor, o IronWord abre os arquivos DOCX enviados e retorna suas fotos através de ExtractImages, sem a instalação do Microsoft Office. A página de revisão abaixo é construída com ambas as ferramentas e testada contra seis relatórios com contagens, legendas e tamanhos de pixels de fotos conhecidos.

O guia é para desenvolvedores que têm agentes de IA que escrevem código .NET que lê documentos Word. Gerar os próprios relatórios com um modelo de IA está fora do escopo.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronWord

Instale o IronWord executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Descreva a página de revisão em um prompt /plan uma vez que o Antigravity tenha o projeto Blazor aberto.

/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

Um build bem-sucedido não responde a nenhuma das três questões que o plano deve cobrir. O guia de modos de renderização da Microsoft explica quando uma página é interativa, e o guia de envio de arquivo do Blazor aborda o manuseio de uploads e limites de tamanho.

Forneça ao agente o nome da variável, mas não compartilhe seu valor. O IronWord também lê uma entrada IronWord.LicenseKey em appsettings.json, um arquivo que um commit pode incluir por engano. O guia de chave de licença lista todas as locais que o IronWord verifica para obter a chave.



O que é o Google Antigravity e como é diferente de um assistente de chat?

A visão geral do Google descreve o aplicativo Antigravity como uma aplicação de desktop que inicia, orquestra e inspeciona equipes de agentes. Um agente executa comandos, lê e grava arquivos e controla um navegador Chrome isolado. Um assistente de chat responde com texto, enquanto um agente retorna artefatos, por exemplo, um Plano de Implementação.

Em um ataque de slopsquatting, alguém registra um pacote com um nome que agentes de IA produzem para bibliotecas que nunca foram publicadas, e um agente que solicita esse nome instala o código do atacante. Nomeie o pacote IronWord em toda tarefa que envolva pacotes. O hub guia de assistentes de codificação de IA lista os arquivos de documentação do IronWord para agentes e contém um teste de aceitação com um único prompt.

O que você deve verificar no plano, nas mudanças de código e no Guia Passo a Passo?

Além das três respostas solicitadas pelo prompt Quickstart, o Plano de Implementação deve declarar a mensagem produzida para um relatório sem fotos. Entre as mudanças de código, encontre a linha que calcula o tamanho dos pixels, e verifique cada membro do IronWord contra a referência de API.

Cada relatório precisa de sua própria captura de tela no Passo a passo, ao lado da tabela de resultados. O Antigravity salva capturas de tela como artefatos de imagem, e um leitor pode comentar em qualquer uma delas. Um comentário em uma captura de tela que mostra uma legenda sob a foto errada informa ao agente qual imagem corrigir.

Como você testa a página de revisão do IronWord em um navegador real?

Dê ao /browser uma tabela de resultados cujas células ele preenche apenas enviando cada arquivo.

/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

Os seis relatórios cobrem os layouts que uma página de fotos deve lidar. Um contém um PNG, um JPEG e um GIF, e um armazena fotos em células de tabela. Outro inclui um logotipo no cabeçalho da página, um coloca a mesma imagem duas vezes, um não contém fotos e um é um relatório de 7,7 MB com quatro fotos de 12 MP.

Por favor, note: Revise a captura de tela do relatório de resolução total primeiro, porque demonstra se o limite aumentado entrou em vigor.

O que causa fotos faltantes ou erradas?

Em nossos testes, cada linha falhada resultou de uma das três causas. Para identificá-los, o código de extração do guia de extração de imagens do IronWord foi copiado para um manipulador de upload em um novo projeto Blazor .NET 9, e os seis relatórios foram processados pelo Chrome sem cabeça.

O que a página mostraCausaCorreção
Nenhuma saída para qualquer relatórioRenderização estática@rendermode InteractiveServer
Nenhuma saída, e o log do servidor permanece vazioO construtor do documento lê o fluxo de upload de forma síncronaLoadAsync no fluxo de upload
Um erro apenas para o relatório de resolução totalO limite padrão de upload de 512.000 bytesUm limite acima do maior relatório

A segunda linha é a mais difícil de diagnosticar. O construtor lançou NotSupportedException com a mensagem "Leituras síncronas não são suportadas." A exceção tornou-se visível apenas quando o manipulador a capturou e registrou.

Como você configura um projeto no qual Antigravity pode trabalhar?

Dê ao Antigravity um repositório que já constrói e serve uma página. O projeto de teste veio de dotnet new blazor -int Server -f net9.0 e foi construído com 0 erros antes de qualquer prompt ser executado. O modelo escreve uma porta aleatória no perfil http de Properties/launchSettings.json, então copie essa URL no prompt /browser.

A próxima tarefa audita o pacote e a chave de licença.

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

Cite a versão relatada em tarefas posteriores. O IronWord 2026.10.4 abriu todos os relatórios e extraiu todas as fotos sem nenhuma chave de licença. Salvar lançou uma LicensingException que dizia "Licença de Produção Necessária". Uma chave ausente, portanto, torna-se aparente apenas quando o aplicativo escreve um arquivo pela primeira vez, o que esta página somente leitura nunca faz.

Como você aplica as regras da página a tarefas posteriores?

Depois que todas as seis linhas passam, registre o que a sessão decidiu. A documentação de regras do Antigravity diz que cada vez que o agente lê ou edita um arquivo, ele carrega qualquer GEMINI.md ou AGENTS.md que encontrar em cada pasta entre esse arquivo e a raiz do espaço de trabalho. /learn converte feedback da sessão em regras de projeto 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

Uma vez que o arquivo existe, o modo de renderização e o limite de upload são registrados em um local que toda tarefa lê. O agente não atualiza esse arquivo automaticamente. Solicite a atualização na mesma tarefa que altera o valor.

Como você carrega um relatório enviado com o IronWord?

Especifique o resultado e a evidência, e permita que o agente estruture o 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 um serviço semelhante a este exemplo. Ele compila com o IronWord 2026.10.4, e a página de teste de calibração que o usa listou corretamente a contagem de fotos, legendas e tamanhos de pixels para todos os seis relatórios.

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#

A verificação de tamanho usa o valor relatado pelo navegador, então um arquivo superdimensionado falha antes que o fluxo de upload abra. O guia de upload da Microsoft aconselha contra confiar apenas neste valor fornecido pelo cliente, e o limite definido em OpenReadStream aplica o limite real. Ler o relatório de resolução total levou 1.118 ms e 1.280 ms em duas execuções de calibração. Para evitar transferências de dados grandes, o serviço gera miniaturas dimensionadas em vez de enviar imagens de tamanho total para o navegador.

Quais imagens o IronWord extrai de um documento?

O método ExtractImages retorna fotos localizadas no corpo do documento e em células de tabela. Ele ignora o logotipo no cabeçalho da página, por isso um papel timbrado não conta como uma foto do site. Se uma foto aparecer várias vezes, ela é retornada uma vez para cada posição, cada uma com seu próprio tamanho.

Cada resultado inclui sua largura e altura em pontos. Por exemplo, uma foto com largura de 3 polegadas é relatada como 216 pontos, independentemente da resolução. O serviço de exemplo retém esses valores em pontos. Para converter para polegadas, divida por 72 ou use GetWidth(MeasurementUnit.Inch), conforme demonstrado pelo agente. O tamanho dos pixels é obtido da imagem decodificada, seja convertendo a propriedade Image para AnyBitmap ou decodificando a string Base64 em ImageData.

A lista de parágrafos inclui parágrafos dentro de células de tabela em ordem de leitura, então selecionar o próximo parágrafo com texto atribui a legenda da primeira foto à segunda foto da tabela. O ExtractText do documento também omite texto de tabela, então sua saída não contém legendas de tabela.

Quando você deve despachar mais de um agente?

Divida as verificações entre dois agentes. Um testa o serviço no código. O outro reproduz os uploads do revisor no 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

Testes que abrem relatórios do disco não precisam de navegador nem de um aplicativo em execução, então detectam uma regressão de legenda antes de uma passagem /browser.

Por favor, note: No aplicativo de desktop, cada agente pode ser executado como uma tarefa separada. Compare os dois Passo a passo antes de mesclar.

Como você implanta a página em um contêiner Linux?

Além de suas assemblies gerenciadas, o IronWord 2026.10.4 contém uma biblioteca de layout nativa construída para Windows (x64 e x86), linux-x64 e 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 não é necessário para listar os arquivos nativos, porque a pasta de publicação no Windows contém os mesmos arquivos que a imagem recebe. Publicar o aplicativo de calibração para linux-x64 produziu um arquivo nativo, libLayoutEngineInterop.so (8.303.240 bytes). Esse arquivo vincula apenas contra o glibc, e o pacote não possui uma compilação musl ou linux-arm64, então esta versão não tem nenhuma biblioteca nativa para imagens Linux Alpine ou ARM64. No Windows, carregar e extrair fotos não carregou a biblioteca nativa. O guia Docker do IronWord recomenda o uso de imagens Ubuntu, Debian ou RHEL.

O que os prompts produziram em uma execução real?

Uma sessão do CLI do Antigravity executou todos os sete prompts sem assistência e ignorou todo prompt de permissão. O aplicativo leu a chave de licença apenas de IRONWORD_LICENSE_KEY. Nós carregamos cada relatório no Chrome sem cabeça duas vezes, uma vez com o código do primeiro prompt e outra com o código final.

  • As contagens de fotos e os tamanhos dos pixels estavam corretos para todos os seis relatórios em ambas as verificações do Chrome.
  • As legendas passaram de nenhuma após o primeiro prompt, que não solicitava nenhuma, para 12 de 12 corretas no aplicativo final.
  • As compilações de lançamento do aplicativo e do projeto de teste relataram 0 avisos e 0 erros.
  • Todos os sete testes xUnit foram aprovados.
  • A publicação no linux-x64 incluiu uma biblioteca nativa.
  • Cada uma das três passagens do navegador processou todos os seis relatórios através do seletor de arquivos.
  • Alguns passos foram executados de forma diferente da página. O prompt Quickstart já definiu o limite de 30 MB e copiou cada upload na memória, então nenhuma das três causas acima apareceu. Cada prompt /plan parou após seu plano até uma aprovação chegar. Agente A e Agente B foram executados em um turno da mesma conversa. As miniaturas foram redimensionadas com SixLabors.ImageSharp, uma dependência transitiva do IronWord. O agente comprometeu as capturas de tela da primeira passagem do navegador e a pasta out/linux de publicação.
  • /learn não escreveu AGENTS.md. Seu Artefato listou todos os seis pontos e pediu confirmação primeiro.

O guia do ChatGPT Codex processa toda uma pasta de documentos Word em paralelo sob um limite de concorrência, onde esta página lida com um upload de cada vez. O guia do Claude Code aprova um design no modo plano antes de quaisquer alterações de arquivo, como os prompts de plano primeiro fazem aqui.

A versão do CLI do Antigravity, modelo, duração e máquina de teste para esta execução estão no registro de execução do hub.


Solução de problemas


Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 62,392Versão:2026.11recém-lançado