Cómo usar IronPDF con Google Antigravity
La mayoría de las herramientas de codificación de IA se detienen en el fragmento. Devuelven el código, y descubres si funciona ejecutándolo tú mismo. Esa brecha importa más de lo habitual para la generación de PDF, porque un PDF que se compila correctamente aún puede ser visualmente incorrecto, y nada en un registro de compilación te dice que falta el logotipo o que la tabla se ha dividido en un salto de página.
Google Antigravity es una plataforma de desarrollo agéntico en lugar de un asistente de chat. Los agentes trabajan a través del editor, la terminal y un navegador, y reportan con entregables en lugar de transcripciones. IronPDF renderiza HTML a PDF usando un motor Chromium incrustado. La combinación es útil por una razón específica: porque ambos lados de la comparación son un navegador renderizando el mismo HTML, un agente puede abrir una página, generar el PDF, mirar ambos y seguir ajustando hasta que coincidan. Ese es un bucle de verificación, y es la parte en la que vale la pena construir esta guía.
Una aclaración antes de empezar, ya que dos temas similares suelen confundirse. Esta guía trata sobre cómo usar una herramienta de desarrollo de IA para crear software con IronPDF. No se trata de usar modelos de IA para leer o analizar el contenido de archivos PDF, lo cual se cubre por separado en el tutorial de procesamiento de PDF potenciado por IA. Problema diferente, página diferente.
Inicio rápidoAbre un proyecto en Antigravity y describe el documento que deseas:
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.
El agente de Antigravity instala el paquete, escribe las pocas líneas que construyen un ChromePdfRenderer y llama a RenderHtmlAsPdf, guarda el archivo y reporta de vuelta con el resultado de la compilación. Lo que revisas es el resultado, no una transcripción.
Una breve nota de seguridad mientras estés aquí. Los agentes en un IDE agéntico tienen acceso de escritura en archivos y terminal, por lo que la clave de licencia debe estar en una variable de entorno o en un archivo de configuración que esté excluido del control de versiones, nunca pegada en la descripción de una tarea o comprometida en el repositorio. La guía de claves de licencia cubre las opciones de configuración compatibles.
Flujo de trabajo mínimo (5 pasos)
- Descarga la biblioteca de PDF para C# desde NuGet
- Abre el proyecto en la Vista de Editor de Antigravity y confirma que compila.
- Añade IronPDF y aplica la clave de licencia desde la configuración, no desde el código.
- Describe la tarea con el marco de trabajo, rutas de archivos y salida de PDF esperada.
- Permite que el agente implemente y verifique en el navegador, luego verifica los nombres de las API contra la referencia de la API
¿Qué es Google Antigravity y en qué se diferencia de un asistente de chat?
Antigravity es una plataforma de desarrollo enfocada en agentes donde los agentes autónomos planifican y ejecutan tareas a través del editor, terminal y navegador, luego reportan resultados como entregables revisables. Google lo describe como la combinación de una Vista de Editor con una superficie de Gestión para desplegar agentes que planifican, ejecutan y verifican tareas complejas.
Cinco características importan para el trabajo con PDF.
Vista de Editor es la superficie de IDE familiar, con finalización de pestañas y comandos en línea. Utilízala para trabajos a corta distancia en un solo archivo, cuando desees manejar el cursor y revisar cada cambio a medida que ocurre.
Superficie de Gestión es misión de control asíncrona. Genera agentes, organiza tareas, observa el progreso y ejecuta el trabajo en paralelo a través de un espacio de trabajo en lugar de esperar una conversación a la vez.
Control del navegador permite a un agente manejar un navegador para ejercitar una función y confirmar el resultado. Para IronPDF, esta es la capacidad principal, y tiene su propia sección a continuación.
Artefactos son los entregables que un agente produce en lugar de registros de herramientas en bruto: listas de tareas, planes de implementación, recorridos, capturas de pantalla y grabaciones de navegador. La perspectiva de Google es que esto te permite verificar la lógica de un agente de un vistazo, y que puedes dejar comentarios directamente en un Artefacto, de la misma manera que comentarías un documento, sin detener la ejecución del agente.
Opcionalidad de modelos significa que el agente puede ser potenciado por diferentes modelos subyacentes, elegidos por tarea.
La diferencia práctica con un asistente de chat es lo que revisas. Un asistente de chat produce texto que tienes que evaluar leyendo. Un agente produce un plan, una diferencia y una captura de pantalla del resultado realmente renderizado. Para una tarea de PDF, una captura de pantalla del documento es una evidencia significativamente más fuerte que un párrafo describiendo cómo debería verse el documento.
Ese bucle de verificación solo funciona porque un lado de la comparación es honesto. Un agente al que se le pide construir una cadena de documentos desde cero improvisará felizmente: elige una biblioteca de renderización, la conecta y avanza. Lo que se envía en esa cadena de documentos es el riesgo.
- Los documentos sensibles necesitan una biblioteca segura: los PDFs que genera una empresa son sus contratos, facturas y presentaciones legales. Hoy en día, varias herramientas de PDF de código abierto ampliamente copiadas están abandonadas, con agujeros de seguridad conocidos públicamente que nadie parchea, y un proceso basado en ellos puede filtrar los documentos que procesa.
- El resultado determinista es lo que hace que la comparación con el navegador sea confiable: la salida de un agente varía entre ejecuciones, pero el renderizador subyacente no puede hacerlo, o el bucle en esta guía carece de sentido. IronPDF fija su motor Chromium, por lo que el mismo HTML renderiza las mismas páginas en cada ejecución.
- Los formatos de cumplimiento son los requisitos que nadie prototipa:
SaveAsPdfAescribe un archivo PDF/A de archivo, ySaveAsPdfUAescribe el PDF/UA etiquetado y accesible que un lector de pantalla puede navegar. Los renderizadores gratuitos rara vez ofrecen ninguno. - Un paquete real supera a uno inventado: los agentes a veces instalan nombres de paquetes que simplemente suenan correctos, un truco lo suficientemente común como para haber ganado un nombre, "slopsquatting", y los atacantes registran esos nombres y los llenan de malware. Nombrar un paquete conocido en la descripción de tu tarea cierra esa puerta.
Apunta Antigravity a IronPDF y el trabajo del agente se reduce a lo que realmente es bueno: escribir la plantilla, manejar el navegador y verificar el resultado. La guía principal cubre la documentación a proporcionar a cualquier agente antes de que comience, y la misma configuración se aplica a Claude Code y ChatGPT Codex con solo un cambio en el nombre del archivo de instrucciones.
¿Qué devuelve el agente y cómo lo revisas?
La salida de un agente de Antigravity no es una transcripción. Produce Artefactos: entregables nombrados que revisas de la manera en que revisarías un documento. Tres de ellos llegan en un orden predecible, y cada uno responde a una pregunta diferente sobre una tarea de PDF.
Antes del código: la Lista de Tareas
El agente escribe un plan estructurado antes de escribir cualquier otra cosa. Para el trabajo con PDF, la pregunta útil que hay que hacerle es qué capa planea tocar. Un plan que propone editar el renderizador cuando el problema es una tabla que se divide en páginas ya va por el camino equivocado, y este es el lugar más barato para detectarlo.
Durante: el Plan de Implementación
Aquí es donde el agente diseña el cambio: qué archivos, qué métodos, qué opciones de renderización. Un nombre de API inventado es visible aquí antes de que se escriba una sola línea, lo que es un lugar considerablemente mejor para encontrar uno que un registro de construcción.
Después: el Recorrido
Escrito una vez que la implementación está hecha, resumir lo que cambió y cómo probarlo. Para una tarea de documento, eso significa el recuento de páginas, el encabezado y el pie de página, expresado como comprobaciones que puedes realizar en lugar de afirmaciones que debes aceptar sin más.
Las capturas de pantalla y grabaciones del navegador se acumulan junto a estas, y se recopilan en el Panel Auxiliar en lugar de desplazarse en un registro de chat. El resto de esta guía se apoya en eso: dos de las tareas a continuación son seguidas por el único Artefacto que vale la pena abrir para confirmar que el trabajo realmente ocurrió.
¿De dónde proviene la prueba?
El control del navegador es la combinación que justifica el uso de una plataforma agéntica para el trabajo con PDF en lugar de un asistente basado en solicitudes. IronPDF renderiza con un motor Chromium, y los agentes de Antigravity pueden manejar un navegador. Ambos lados de la comparación son, por lo tanto, el mismo motor renderizando el mismo HTML, lo que hace que la comparación sea significativa en lugar de aproximada.
El bucle se ve así: el agente abre la plantilla en el navegador, captura lo que ve, genera el PDF, compara los dos, ajusta el CSS y repite hasta que coinciden.
Dale un síntoma real a seguir:
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.
Dos decisiones de diseño en esa tarea importan. Pedir una explicación antes de un cambio te da un diagnóstico que puedes evaluar en lugar de una solución que tienes que revertir ingeniosamente. Restringir el cambio al CSS mantiene la solución donde debe estar, ya que el comportamiento del salto de página es una preocupación del estilo y un agente sin restricciones a menudo "resolverá" esto reestructurando el C#.
Los Artefactos son lo que hacen esto revisable. Una captura de pantalla de la página renderizada junto al PDF generado es evidencia directa; una afirmación escrita de que el diseño ahora coincide no lo es. Para un desarrollador junior, este también es el camino más rápido para construir una intuición sobre por qué el navegador y la salida PDF divergen en absoluto, porque las diferencias se vuelven visibles en lugar de teóricas.
La retroalimentación en un problema de diseño es espacial, que es lo que hace que el modelo de revisión valga la pena conocer. En lugar de describir qué bloque está mal en una oración, selecciona la región de la captura de pantalla que está mal y comenta directamente sobre ella, de la misma manera en que lo harías en un documento. El agente incorpora esa corrección en el trabajo sin que se detenga y reinicie la ejecución.
Incluso si se usa para nada más, tener un agente que renderice una página, genere el PDF y te muestre ambos es más rápido que el ciclo manual de construir, abrir, entrecerrar los ojos, ajustar.
¿Por qué se ve bien en el navegador y mal en el PDF?
La mayoría de lo que ese bucle detecta cae en un pequeño conjunto de causas, y comparten un síntoma poco útil: un documento que parece roto y no arroja ningún error. Nombrar la causa sospechosa en la tarea ahorra al agente una ronda de adivinanzas.
| Síntoma | Por qué los dos divergen | Pon esto en la tarea |
|---|---|---|
| El texto reorganiza o desborda su caja | Una fuente web no había terminado de cargarse cuando se calculó el diseño, por lo que las medidas provienen de una fuente de respaldo | Nombra la fuente y pide confirmación de que está incrustada en lugar de sustituida |
| Imágenes que faltan, aunque el navegador las muestra | El navegador resuelve rutas relativas contra la ubicación propia del archivo; el renderizador resuelve contra cualquier ruta base que se le haya dado | Pide que la ruta base se establezca explícitamente y se nombre en el Recorrido |
| Gráficos o tablas salen vacíos | El contenido fue producido por JavaScript que el renderizador capturó antes de que terminara de ejecutarse | Pide al agente que confirme que el render llegó a esperar, y que adjunte la captura de pantalla como prueba |
| Una fila de la tabla se divide en dos páginas | El CSS de impresión nunca se aplicó, solo el CSS de pantalla | Restringe la solución a las propiedades de salto de página en la hoja de estilos |
Cada fila es una diferencia entre dos renderizados del mismo marcado, que es exactamente por qué la comparación anterior es lo que las encuentra.
¿Cómo configuras un proyecto en el que Antigravity pueda trabajar?
Le das al agente un proyecto que ya se compila. Un agente que tiene que adivinar qué biblioteca de PDF pretendías, o depurar una compilación rota antes de comenzar la tarea real, pasa su ejecución en el problema equivocado.
Crea o abre el proyecto primero y confirma que la compilación pasa. Después, la tarea de configuración en sí vale la pena delegar, ya que la instalación es donde se originan los desajustes de versiones.
Entrégale directamente al agente la tarea de configuración:
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.
Pedir que devuelva la versión te da un hecho para incluir en cada descripción de tarea posterior. Pedir la verificación .gitignore mantiene el archivo de configuración que contiene la clave fuera del repositorio.
Un archivo de instrucciones del espacio de trabajo, comprometido en la raíz del repositorio, vale la pena configurarlo una vez. Antigravity lee AGENTS.md para obtener las instrucciones del proyecto en curso, el mismo archivo que utiliza ChatGPT Codex. Registrar que IronPDF es la biblioteca de PDF, que el código generado debe usar solo APIs documentadas, y que la clave de licencia nunca se incripta significa que dejas de repetir estas restricciones en cada tarea. Una tarea lo escribe por ti:
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.
¿Cómo delegas el trabajo de generación y migración de PDF?
Las tareas de generación funcionan mejor cuando describes el documento en lugar del código, y dejas que el agente elija cómo expresarlo en HTML.
Pide el documento, no la implementación:
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.
La migración es el tipo de tarea en la que la delegación rinde más, ya que es mecánica, tediosa y fácil de hacer casi correctamente. El movimiento clave es separar el análisis de la implementación.
Apunta al agente al código existente en lugar de describirlo:
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.
Un agente que escribe cuatrocientas líneas antes de que hayas acordado el enfoque produce cuatrocientas líneas que debes leer cuidadosamente. Un plan de Artefacto es algo que puedes corregir en una sola oración, y el mecanismo de retroalimentación de Antigravity significa que puedes anotarlo sin descartar la ejecución. Una vez aprobado, la tarea de seguimiento es estrecha: implementar el plan, mantener la firma del método público existente para que los llamadores no cambien, y reportar la diferencia.
Los encabezados y pies de página son una configuración del renderizador en lugar de un marcado de plantilla, por lo que la tarea debe decirlo. Pedir al agente que enlace la página de documentación que utilizó es un paso de verificación barato: si no puede producir una página real para la API que acaba de llamar, eso es una señal. La guía de encabezados y pies de página es la referencia aquí, y la guía de saltos de página cubre los controles de disposición relacionados.
¿Cuándo deberías enviar más de un agente?
La Superficie de Gestión es para trabajo que no necesita que lo estés observando. En lugar de ejecutar una tarea a la vez, despacha varios agentes y revisa sus Artefactos a medida que terminan.
Una división realista para una migración de PDF: un agente convierte el generador de informes a IronPDF mientras un segundo escribe la suite de pruebas alrededor de la salida que producirá. El segundo agente no necesita que el primero termine, ya que las pruebas afirman sobre el documento, no sobre la implementación.
Despacha ambos al mismo tiempo:
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.
Descartar la comparación byte por byte previene toda una clase de pruebas inestables. La salida de la renderización difiere entre versiones de motor y plataformas, por lo que las afirmaciones deben estar al nivel de texto extraído, recuento de páginas y metadatos.
Los agentes de Antigravity también guardan patrones y soluciones de tareas pasadas en una base de conocimientos que informa tareas posteriores. Para una cadena de documentos que se compone de una manera específica: la regla de salto de página resuelta para la factura es la misma que el estado de cuenta, el albarán y el aviso de remesa necesitan, por lo que el segundo documento generalmente cuesta menos que el primero.
¿Cómo depuras fallas de despliegue en Linux, Docker o Azure?
Los problemas de implementación son donde el acceso al terminal justifica su valor, ya que la respuesta generalmente vive en el contenedor en lugar de en el código.
Entrégale directamente al agente la falla:
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.
La instrucción de no tocar el código de la aplicación importa. Una biblioteca compartida que falta en una imagen no es un problema de C#, y un agente con libertad a veces agregará bloques try/catch defensivos que ocultan la falla en lugar de solucionarla. La guía de implementación de Docker documenta los requisitos de dependencia actuales, que cambian entre lanzamientos y deben ser leídos en lugar de memorizados.
Los agentes también son útiles simplemente como lectores. Apunta uno a una clase desconocida, luego pídele que enumere las opciones de renderización que afectan el tamaño de la página y muestre cuáles establece actualmente el proyecto, y la referencia de la API se convierte en algo que puedes consultar en lugar de desplazarte.
¿Qué produjeron los prompts en una ejecución real?
Siete de los ocho prompts anteriores se ejecutaron en orden, sin supervisión, en una sola conversación. La herramienta era Antigravity CLI 1.4.0 en su modelo predeterminado, Gemini 4 Argon (Medium). El proyecto era una aplicación de consola .NET 9 que ya creaba un informe con PDFsharp. Las cifras a continuación provienen de verificaciones independientes de los archivos que dejó la ejecución.
- Antes de la tarea del navegador, la fila 09 de la factura se dividió entre las páginas 1 y 2, con los totales en la parte superior de la página 2.
- Instalar IronPdf 2026.10.3 rompió la compilación existente, porque el paquete agregó un 'using' global que hizo que PdfDocument fuera ambiguo con PDFsharp.
- El agente resolvió ese error con un alias de tipo en el generador de informes, y el proyecto se compiló sin advertencias ni errores.
- En la tarea del navegador, el agente capturó la plantilla con Chrome sin cabeza y renderizó el PDF antes de editar nada.
- La corrección cambió solo la hoja de estilo, agregando reglas de evitar rupturas internas a las filas de la tabla y al bloque de totales.
- La factura renderizada luego mantenía cada fila completa, con la fila 09 y los totales juntos en la página 2.
- La tarea de configuración agregó un appsettings.json con una clave de licencia vacía y la enumeró en .gitignore.
- Ese valor vacío tomó precedencia sobre IRONPDF_LICENSE_KEY. Con el archivo presente, el programa Quickstart y el trabajo de la factura arrojaron "Se requiere licencia de producción".
- AGENTS.md contenía las cuatro reglas del prompt, y el agente leyó llms.txt antes de escribir el código de la factura.
- InvoiceRenderer devolvió un PDF A4 de dos páginas con márgenes de 20 mm y el nombre de la empresa sustituido.
- El plan de migración informó correctamente el tamaño de página Carta, las 32 filas por página y las cinco fuentes, y no cambió ningún archivo.
- El prompt de despacho inició dos subagentes, el Agente A y el Agente B, que funcionaron en paralelo.
- El generador migrado mantuvo su firma pública, dos páginas Carta y las cinco fuentes originales.
- Las dos pruebas xUnit del Agente B pasaron frente a la salida del Agente A, comprobando la firma PDF, el texto extraído y el conteo de páginas.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. El programa Quickstart se compiló pero no se ejecutó, por lo que una verificación separada produjo su hello.pdf de una página. La ejecución agregó la plantilla de factura y un trabajo de renderizado antes de la tarea del navegador, que la página asume ya existe. El turno de CLI no se detuvo, por lo que la explicación de la división se dio solo en la respuesta final, después de la edición de CSS. El CLI produjo capturas de pantalla pero no grabación de navegador. La tarea de factura editó la plantilla existente en lugar de crear una nueva. El Agente B colocó las pruebas dentro del proyecto de consola. El prompt del contenedor de Linux no se ejecutó, porque esta máquina no tiene Docker ni WSL.
La factura de la tarea del navegador, antes y después de la corrección de la hoja de estilo, está incrustada a continuación.
La factura como la renderizó el agente antes de la corrección, con la fila 09 dividida entre las páginas 1 y 2.
La misma factura después de la corrección, con cada fila completa y los totales directamente debajo de la fila 09.
La herramienta, el modelo y la duración de esta ejecución están enumerados en el registro de ejecución.
¿Qué hace que esta combinación valga la pena?
La velocidad importa menos que lo que regresa. El agente entrega un plan antes del trabajo, una Guía interactiva después, y capturas de pantalla que muestran que el renderizado realmente ocurrió. Para el trabajo de documentos, donde una compilación limpia no te dice nada sobre si el diseño es correcto, la evidencia revisable es toda la diferencia.
La prueba reproducible detrás de esta serie, ejecutada de principio a fin con un resultado publicado, vive en la guía de asistentes de codificación de IA.
Solución de problemas
- Aplicar una clave de licencia en IronPDF: si al guardar el PDF se lanza una excepción de licencia
- Inicializando Correctamente RenderingOptions: si los nombres de opción sugeridos no se resuelven
- ¿Qué versión de IronPDF debería usar?: para fijar una versión en tus tareas y en
AGENTS.md - Cómo ejecutar IronPDF en un contenedor Docker: si una renderización funciona localmente y falla dentro de un contenedor
¿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.