Como usar o IronPDF com o Google Antigravity

Curtis Chau
Curtis Chau
Atualizado: 20 de outubro de 2026

A maioria das ferramentas de codificação de IA param no trecho. Eles entregam o código, e você descobre se ele funciona executando-o você mesmo. Essa lacuna importa mais do que o normal para a geração de PDFs, porque um PDF que compila corretamente ainda pode estar visualmente errado, e nada no log de construção informa que o logotipo está faltando ou que a tabela foi dividida por uma quebra de página.

Google Antigravity é uma plataforma de desenvolvimento agêntica em vez de um assistente de chat. Os agentes funcionam no editor, no terminal e em um navegador, e reportam de volta com entregáveis em vez de transcrições. O IronPDF renderiza HTML para PDF usando um mecanismo Chromium embutido. O emparelhamento é útil por um motivo específico: como ambos os lados da comparação são um navegador renderizando o mesmo HTML, um agente pode abrir uma página, gerar o PDF, olhar para ambos e continuar ajustando até que eles correspondam. Esse é um loop de verificação, e é a parte que vale a pena construir este guia.

Uma clarificação antes de você começar, já que dois tópicos de som semelhante são confundidos. Este guia é sobre usar uma ferramenta de desenvolvimento de IA para construir software com o IronPDF. Não é sobre usar modelos de IA para ler ou analisar o conteúdo de arquivos PDF, que é abordado separadamente no tutorial de processamento de PDF com suporte a AI. Problema diferente, página diferente.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronPdf

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

Abra um projeto no Antigravity e descreva o documento que você deseja:

In this C# project, add IronPDF and create Program.cs that renders the HTML
string "<h1>Hello from IronPDF</h1>" to hello.pdf. Read the license key from
the IRONPDF_LICENSE_KEY environment variable, never hardcode it. Run
dotnet build, fix any errors, and show me the resulting file.
Text

O agente do Antigravity instala o pacote, escreve as poucas linhas que constroem um ChromePdfRenderer e chama RenderHtmlAsPdf, salva o arquivo e retorna com o resultado da compilação. O que você revisa é o resultado, não uma transcrição.

Uma breve nota de segurança enquanto você está aqui. Agentes em um IDE agêntico têm acesso a gravação de arquivo e terminal, então uma chave de licença deve estar em uma variável de ambiente ou arquivo de configuração que é excluído do controle de fonte, nunca colada em uma descrição de tarefa ou comprometida no repositório. O guia de chave de licença cobre as opções de configuração suportadas.



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

Antigravity é uma plataforma de desenvolvimento focada em agentes onde agentes autônomos planejam e executam trabalhos no editor, terminal e navegador, e então relatam os resultados como entregáveis revisáveis. Google descreve isso como combinando uma Visualização do Editor com uma superfície de Gerente para implantar agentes que planejam, executam e verificam tarefas complexas.

Cinco características importam para trabalhos com PDF.

Visualização do Editor é a superfície IDE familiar, com preenchimento de abas e comandos inline. Use-a para trabalhos de curto alcance em um único arquivo, quando você quer mover o cursor e revisar cada alteração à medida que acontece.

Superfície do Gerente é o controle de missão assíncrono. Gerar agentes, enfileirar tarefas, acompanhar o progresso e executar o trabalho em paralelo em um espaço de trabalho em vez de esperar por uma conversa de cada vez.

Controle do navegador permite que um agente conduza um navegador para exercitar um recurso e confirmar o resultado. Para o IronPDF, esta é a capacidade principal, e ela recebe sua própria seção abaixo.

Artefatos são os entregáveis que um agente produz em vez de logs de ferramentas brutos: listas de tarefas, planos de implementação, tutoriais, capturas de tela e gravações de navegador. A estrutura do Google é que estes permitem verificar a lógica de um agente de relance, e que você pode deixar feedback diretamente em um Artefato, da mesma forma que comentaria em um documento, sem interromper a execução do agente.

Opcionalidade do modelo significa que o agente pode ser alimentado por diferentes modelos subjacentes, escolhidos por tarefa.

A diferença prática de um assistente de chat é o que você revisa. Um assistente de chat produz texto que você tem que avaliar lendo. Um agente produz um plano, um diff e uma captura de tela da saída real renderizada. Para uma tarefa de PDF, uma captura de tela do documento é uma evidência significativamente mais forte do que um parágrafo descrevendo como o documento deve parecer.

Esse loop de verificação só funciona porque um lado da comparação é honesto. Um agente que é solicitado a construir um pipeline de documentos do zero improvisará felizmente: escolherá uma biblioteca de renderização, configurará-a e seguirá em frente. O que é enviado nesse pipeline é o risco.

  • Documentos sensíveis precisam de uma biblioteca segura: os PDFs que uma empresa gera são seus contratos, faturas e arquivos legais. Várias ferramentas PDF de código aberto amplamente copiadas estão abandonadas hoje, com falhas de segurança conhecidas publicamente que ninguém corrige, e um pipeline construído nelas pode vazar os próprios documentos que processa.
  • Saída determinística é o que torna a comparação do navegador confiável: a saída de um agente varia entre execuções, mas o renderizador subjacente não pode, ou o loop neste guia é inútil. IronPDF fixa seu motor Chromium, então o mesmo HTML renderiza as mesmas páginas em cada execução.
  • Formatos de conformidade são os requisitos que ninguém prototipa: SaveAsPdfA escreve um arquivo PDF/A arquivístico, e SaveAsPdfUA escreve o PDF/UA marcado, acessível, que um leitor de tela pode navegar. Renderizadores gratuitos raramente oferecem qualquer um.
  • Um pacote real vence um adivinhado: às vezes, agentes instalam nomes de pacotes que apenas parecem corretos, um truque comum suficiente para ter ganhado um nome, "slopsquatting", e atacantes registram esses nomes e os enchem de malware. Nomear um pacote conhecido na sua descrição de tarefa fecha essa porta.

Direcione o Antigravity para o IronPDF e o trabalho do agente se limita ao que ele é realmente bom em fazer: escrever o template, conduzir o navegador e verificar o resultado. O guia principal cobre a documentação para entregar a qualquer agente antes que ele comece, e a mesma configuração é transferida para Claude Code e ChatGPT Codex mudando apenas o nome do arquivo de instruções.

O que o agente entrega de volta e como você o revisa?

A saída de um agente do Antigravity não é uma transcrição. Ele produz Artefatos: entregáveis nomeados que você revisa da mesma forma que revisaria um documento. Três deles chegam em uma ordem previsível, e cada um responde a uma pergunta diferente sobre uma tarefa de PDF.

Antes do código: a Lista de Tarefas

O agente escreve um plano estruturado antes de escrever qualquer outra coisa. Para trabalhos com PDF, a pergunta útil a fazer é qual camada ele pretende tocar. Um plano que propõe editar o renderizador quando o problema é uma tabela se dividindo entre páginas já está indo para o caminho errado, e este é o lugar mais barato para perceber isso.

Durante: o Plano de Implementação

É aqui que o agente arquiteta a mudança: quais arquivos, quais métodos, quais opções de renderização. Um nome de API inventado é visível aqui antes que uma única linha dele seja escrita, que é um lugar consideravelmente melhor para encontrar um do que um log de compilação.

Depois: o Walkthrough

Escrito uma vez que a implementação está feita, resumindo o que mudou e como testá-lo. Para uma tarefa de documento, isso significa a contagem de páginas, o cabeçalho e o rodapé, expressos como verificações que você pode executar em vez de afirmações nas quais você tem que confiar.

Capturas de tela e gravações de navegador se acumulam ao lado destes, e elas se coletam no Painel Auxiliar em vez de passarem por um log de chat. O resto deste guia baseia-se nisso: duas das tarefas abaixo são seguidas pelo único Artefato que vale a pena abrir para confirmar que o trabalho realmente aconteceu.

De onde vem a prova?

Controle de navegador é o emparelhamento que justifica o uso de uma plataforma agêntica para trabalhos com PDF em vez de um assistente baseado em prompts. IronPDF renderiza com um motor Chromium, e agentes do Antigravity podem conduzir um navegador. Ambos os lados da comparação são, portanto, o mesmo motor renderizando o mesmo HTML, o que torna a comparação significativa em vez de aproximada.

O loop tem esta aparência: o agente abre o template no navegador, captura o que vê, gera o PDF, compara os dois, ajusta o CSS e repete até que correspondam.

Dê a ele um sintoma real para perseguir:

Templates/invoice.html renders correctly in a browser but the PDF output is
wrong: the line-item table splits a row across pages and the totals block
lands at the top of page 2 instead of under the table.

1. Open the template in the browser and capture a screenshot.
2. Run the renderer to produce invoice.pdf.
3. Compare the two and explain the difference before changing anything.
4. Fix it in the CSS using page-break properties. Do not change the C#.
5. Re-render, capture both again, and attach them as Artifacts.
Text

Duas escolhas de design nessa tarefa importam. Pedir uma explicação antes de uma alteração dá a você um diagnóstico que pode avaliar em vez de uma correção que você tem que engenheirar de volta. Restringir a alteração ao CSS mantém a correção onde ela pertence, já que o comportamento de quebra de página é uma questão de folha de estilo e um agente não restringido muitas vezes "soluciona" isso reestruturando o C#.

Os Artefatos são o que tornam isso revisável. Uma captura de tela da página renderizada ao lado do PDF gerado é evidência direta; uma alegação escrita de que o layout agora coincide não é. Para um desenvolvedor júnior, este é também o caminho mais rápido para construir uma intuição para entender porque a saída do navegador e do PDF divergem de qualquer forma, porque as diferenças se tornam visíveis em vez de teóricas.

Por favor, note: Verifique as capturas de tela. Se o agente nunca abriu realmente o template, não verificou nada, e as capturas de tela são onde isso aparece.

Comentários sobre um problema de layout são espaciais, o que é o que torna o modelo de revisão que vale a pena conhecer. Em vez de descrever qual bloco está errado em uma sentença, selecione a região da captura de tela que está errada e comente diretamente sobre ela, da mesma forma que faria em um documento. O agente incorpora essa correção ao trabalho sem que a execução seja demolida e reiniciada.

Mesmo que usado para nada mais, ter um agente para renderizar uma página, gerar o PDF e mostrar ambos a você é mais rápido do que o ciclo manual de construir, abrir, apertar os olhos, ajustar.

Por que parece certo no navegador e errado no PDF?

A maioria do que esse loop detecta se enquadra em um pequeno conjunto de causas, e elas compartilham um sintoma inútil: um documento que parece quebrado e não gera nenhum erro. Nomear a causa suspeita na tarefa poupa ao agente uma rodada de adivinhação.

SintomaPor que os dois divergemColoque isso na tarefa
Texto refluindo ou transbordando sua caixaUma fonte web não havia terminado de carregar quando o layout foi calculado, então as medições vieram de uma fonte de reservaNomeie a fonte e peça confirmação de que ela está incorporada e não substituída
Imagens ausentes, embora o navegador as mostreO navegador resolve caminhos relativos contra o próprio local do arquivo; o renderizador resolve contra qualquer caminho-base que lhe foi dadoPeça para que o caminho-base seja configurado explicitamente e nomeado no Tutorial
Gráficos ou tabelas saem vaziosO conteúdo foi produzido por JavaScript que o renderizador capturou antes de ele ser executadoPeça ao agente para confirmar que a renderização esperou e para anexar a captura de tela como prova
Uma linha de tabela se divide entre duas páginasO CSS de impressão nunca foi aplicado, apenas o CSS de telaRestringir a correção às propriedades de quebra de página na folha de estilo

Cada linha é uma diferença entre duas renderizações do mesmo marcação, o que é exatamente porque a comparação acima é o que as encontra.

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

Você entrega ao agente um projeto que já compila. Um agente que tem que adivinhar qual biblioteca de PDF você pretendia, ou depurar uma construção quebrada antes de começar a tarefa real, gasta sua execução pelo problema errado.

Crie ou abra o projeto primeiro e confirme que a construção passa. Depois, a própria tarefa de configuração vale a pena delegar, já que a instalação é onde as incompatibilidades de versão se originam.

Entregue a tarefa de configuração diretamente ao agente:

Add the IronPDF NuGet package to this project. Then tell me which version was
installed and show me the PackageReference line. Configure the license key to
be read from configuration rather than hardcoded, and add the config file to
.gitignore if it isn't already. Don't change other package references.
Text

Pedir a versão de volta dá a você um fato para incluir em cada descrição de tarefa posterior. Pedir a verificação .gitignore mantém o arquivo de configuração que contém a chave fora do repositório.

Por favor, note: Verifique o log do terminal. Ele registra a versão do pacote que realmente foi resolvida, que é o fato que vale a pena colar em cada tarefa posterior.

Um arquivo de instruções do espaço de trabalho, enviado na raiz do repositório, vale a pena configurar uma vez. Antigravity lê AGENTS.md para instruções de projeto em andamento, o mesmo arquivo que o ChatGPT Codex usa. Registrar que o IronPDF é a biblioteca de PDF, que o código gerado deve usar apenas APIs documentadas e que a chave de licença nunca é incluída significa que você para de repetir essas restrições em cada tarefa. Uma tarefa escreve isso para você:

Create AGENTS.md at the repository root with a PDF section stating that this
project uses IronPDF for all PDF generation, that you must read
https://ironpdf.com/llms.txt before writing PDF code and use only APIs
documented there, that ChromePdfRenderer is the HTML to PDF entry point, and
that no competing PDF package may be added.
Text

Como você delega trabalho de geração e migração de PDF?

Tarefas de geração funcionam melhor quando você descreve o documento em vez do código e deixa que o agente escolha como expressá-lo em HTML.

Peça pelo documento, não pela implementação:

Create Templates/invoice.html with plain HTML and inline CSS: a header with a
company name, a line-item table (description, quantity, unit price, total), and
a right-aligned totals block. No JavaScript.

Then write Services/InvoiceRenderer.cs with an async RenderAsync method that
loads the template, substitutes {{CompanyName}}, renders it with IronPDF, and
returns a byte array. A4 portrait, 20mm margins. Build and fix errors.
Text

Migração é o tipo de tarefa em que a delegação mais compensa, já que é mecânica, tediosa e fácil de ficar quase certa. O movimento chave é dividir a análise da implementação.

Direcione o agente para o código existente em vez de descrevê-lo:

Read Reports/LegacyReportBuilder.cs. It builds PDFs by positioning text at
coordinates with another library.

1. Summarize the current output: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Produce this as a plan Artifact. Do not write code yet.
Text

Um agente que escreve quatrocentas linhas antes de você ter concordado com a abordagem, produz quatrocentas linhas que você tem que ler cuidadosamente. Um Artefato de plano é algo que você pode corrigir em uma frase, e o mecanismo de feedback do Antigravity significa que você pode anotá-lo sem descartar a execução. Uma vez aprovado, a tarefa de acompanhamento é estreita: implementar o plano, manter a assinatura do método público existente para que os chamadores não mudem e relatar o diff.

Cabeçalhos e rodapés são uma configuração de renderizador em vez de marcação de template, então a tarefa deve dizer isso. Pedir ao agente para vincular a página de documentação que usou é uma etapa de verificação barata: se não puder produzir uma página real para a API que acabou de chamar, isso é um sinal. O guia de cabeçalhos e rodapés é a referência aqui, e o guia de quebras de página cobre os controles de layout relacionados.

Quando você deve despachar mais de um agente?

A Superfície do Gerente é para trabalhos que não precisam de você assistindo. Em vez de executar uma tarefa de cada vez, despache vários agentes e revise seus Artefatos à medida que terminam.

Uma divisão realista para uma migração de PDF: um agente converte o gerador de relatórios legados para o IronPDF enquanto um segundo escreve o conjunto de testes em torno da saída que ele produzirá. O segundo agente não precisa do primeiro para terminar, já que os testes afirmam sobre o documento, não sobre a implementação.

Despache ambos ao mesmo tempo:

Agent A: migrate Reports/LegacyReportBuilder.cs to IronPDF per the approved
plan. Keep the public method signature unchanged.

Agent B: write xUnit tests for the migrated output. Assert that the result is
non-empty, begins with the %PDF- signature, contains the substituted company
name in extracted text, and has the expected page count. Do not use
golden-file byte comparisons; rendering output is not byte-stable.
Text

Descartar a comparação byte por byte previne uma classe inteira de testes instáveis. A saída de renderização varia entre versões de mecanismo e plataformas, então asserções pertencem ao nível de texto extraído, contagem de páginas e metadados.

Por favor, note: Artefato para verificar: ambos os Tutoriais. Os testes do Agente B só significam algo se eles afirmarem contra o documento que o Agente A realmente produziu.

Os agentes do Antigravity também salvam padrões e soluções de tarefas passadas em uma base de conhecimento que informa as posteriores. Para um pipeline de documentos que se complica de uma maneira específica: a regra de quebra de página funcionada para a fatura é a mesma regra que a declaração, o comprovante de embalagem, e o conselho de remessa todos precisam, então o segundo documento geralmente custa menos do que o primeiro.

Como você depura falhas de implantação no Linux, Docker ou Azure?

Problemas de implantação são onde o acesso ao terminal compensa, já que a resposta geralmente vive no contêiner em vez de no código.

Entregue diretamente ao agente a falha:

Rendering works locally on Windows but fails in our Linux container with:

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Inspect the Dockerfile for missing native dependencies IronPDF's Chromium
engine needs on Debian-based images. Explain the cause, then propose the
Dockerfile change. Don't modify C# code unless the cause is there.
Text

A instrução para não tocar no código de aplicação importa. Uma biblioteca compartilhada ausente em uma imagem não é um problema do C#, e um agente com mão livre às vezes adiciona blocos try/catch defensivos que escondem a falha em vez de corrigi-la. O guia de implantação do Docker documenta as exigências de dependência atuais, que mudam entre os lançamentos e devem ser lidas em vez de lembradas.

Agentes também são úteis simplesmente como leitores. Direcione um para uma classe desconhecida, depois peça para listar as opções de renderização que afetam o tamanho da página e mostre quais o projeto atualmente define, e a referência de API se torna algo que você pode consultar em vez de rolar.

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

Sete dos oito prompts acima executaram em ordem, sem supervisão, em uma conversa. A ferramenta era Antigravity CLI 1.4.0 em seu modelo padrão, Gemini 4 Argon (Médio). O projeto era uma aplicação de console .NET 9 que já gerava um relatório com PDFsharp. As figuras abaixo vêm de verificações independentes dos arquivos que a execução deixou para trás.

  • Antes da tarefa do navegador, a linha 09 da fatura estava dividida entre as páginas 1 e 2, com os totais no topo da página 2.
  • Instalar IronPdf 2026.10.3 quebrou a compilação existente, porque o pacote adicionou um global using que tornou PdfDocument ambíguo com PDFsharp.
  • O agente resolveu esse erro com um alias de tipo no construtor de relatórios, e o projeto foi compilado sem avisos ou erros.
  • Na tarefa do navegador, o agente capturou o template com Chrome sem cabeça e renderizou o PDF antes de editar qualquer coisa.
  • A correção mudou apenas a folha de estilo, adicionando regras de evitar quebra dentro das linhas da tabela e do bloco de totais.
  • A fatura renderizada então manteve todas as linhas inteiras, com a linha 09 e os totais juntos na página 2.
  • A tarefa de configuração adicionou um appsettings.json com uma chave de licença vazia e a listou em .gitignore.
  • Esse valor vazio teve precedência sobre IRONPDF_LICENSE_KEY. Com o arquivo presente, o programa Quickstart e a tarefa da fatura lançaram ambos "Production License Required".
  • AGENTS.md continha todas as quatro regras do prompt, e o agente leu llms.txt antes de escrever o código da fatura.
  • InvoiceRenderer retornou um PDF A4 de duas páginas com margens de 20 mm e o nome da empresa substituído.
  • O plano de migração relatou o tamanho da página Carta, as 32 linhas por página e todas as cinco fontes corretamente, e não alterou nenhum arquivo.
  • O prompt de despacho iniciou dois subagentes, Agente A e Agente B, que rodaram em paralelo.
  • O construtor migrado manteve sua assinatura pública, duas páginas Carta e as cinco fontes originais.
  • Os dois testes xUnit do Agente B passaram contra a saída do Agente A, verificando a assinatura do PDF, texto extraído e contagem de páginas.
  • Alguns passos foram executados de forma diferente da página. O programa Quickstart foi construído mas não executado, então uma verificação separada produziu seu hello.pdf de uma página. A execução adicionou o template da fatura e um trabalho de renderização antes da tarefa do navegador, que a página assume já existir. A execução do CLI não pausou, então a explicação da divisão foi dada apenas na resposta final, após a edição do CSS. O CLI produziu capturas de tela mas nenhuma gravação de navegador. A tarefa da fatura editou o template existente em vez de criar um novo. O Agente B colocou os testes dentro do projeto do console. O prompt do container Linux não foi executado, porque esta máquina não possui Docker ou WSL.

A fatura da tarefa do navegador, antes e depois da correção da folha de estilo, está incorporada abaixo.

A fatura como o agente a renderizou antes da correção, com a linha 09 dividida entre as páginas 1 e 2.

A mesma fatura depois da correção, com todas as linhas inteiras e os totais diretamente abaixo da linha 09.

A ferramenta, o modelo e a duração desta execução estão listados em o registro da execução.

O que torna este emparelhamento válido?

A velocidade importa menos do que o que é devolvido. O agente entrega um plano antes do trabalho, um Walkthrough depois dele, e capturas de tela mostrando que a renderização realmente aconteceu. Para trabalhos com documentos, onde uma construção limpa não diz nada sobre se o layout está correto, evidências revisáveis são toda a diferença.

O teste reprodutível por trás desta série, executado do início ao fim com um resultado publicado, fica no guia de assistentes de codificação AI.


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 22,198,312Versão:2026.11recém-lançado