Uso de IronPPT con Asistentes de Codificación AI
IronPPT es la biblioteca de PowerPoint para .NET de Iron Software. Crea, abre y edita presentaciones PPTX desde código C# sin Microsoft Office ni Interop, y un solo paquete cubre cada plataforma que ejecuta .NET Standard 2.0.
Una presentación trimestral, un conjunto de material de curso o un listado de propiedades dependen de las mismas operaciones: añadir diapositivas, colocar texto e imágenes en ellas, y cambiar el orden antes de enviar el archivo. Un asistente sin la documentación de IronPPT no tiene una lista de los miembros que existen, y uno de los ejemplos de guía de IronPPT compila y se ejecuta, pero deja la presentación guardada sin cambios.
El proceso de configuración es el mismo para cada asistente. Añade el paquete, asigna la clave desde el entorno, proporciona al asistente la documentación legible por máquina de IronPPT, y lee cada presentación guardada antes de marcar la tarea como completa. Esto se aplica a añadir diapositivas, añadir texto, gestionar imágenes, y gestionar diapositivas.
Cómo usar IronPPT con un asistente de codificación AI
- Descarga la biblioteca de PowerPoint de C# desde NuGet
- Asigna
IronPPT.License.LicenseKeydesdeIronPPT_LICENSE_KEYal inicio - Dale al asistente el índice llms.txt de IronPPT antes de que escriba código
- Graba las reglas de IronPPT en el archivo de instrucciones que carga tu asistente
- Usa la diapositiva que ya tiene el nuevo mazo, luego añade el resto en su orden final
- Comprueba el XML de cada diapositiva guardada en la presentación contra la solicitud
¿No puede mi asistente de AI manejar PowerPoint por sí solo?
Sin una biblioteca de presentación, el código .NET puede escribir archivos de PowerPoint a través del Open XML SDK, que construye una presentación parte por parte y vincula las partes a través de relaciones.
IronPPT envuelve esa estructura de paquete en un pequeño modelo de objetos cuyos principales tipos son PresentationDocument y Slide.
Se aplican tres hechos antes del primer aviso.
- Una llamada sin efecto no genera error: solo una lectura del archivo guardado muestra el cambio faltante, e IronPPT realiza esa lectura cuando vuelve a abrir la presentación desde su ruta.
- Un nombre para el paquete y el espacio de nombres: ambos son
IronPPT. Los atacantes registran paquetes maliciosos bajo nombres que los asistentes recomiendan para paquetes que no existen, una práctica llamada slopsquatting, así que incluye el nombre exacto en el aviso. - La licencia es perpetua: una licencia IronPPT es una compra única sin tarifas de renovación, y la página de licencias muestra el número de desarrolladores que permite cada nivel.
Paso 1: Instalar IronPPT
Con el paquete referenciado, el asistente utiliza los tipos que proporciona IronPPT.
Install IronPPT 2026.10.1 from NuGet and restore the project.
Tell me the IronPPT version it references afterwards.
Desde un terminal, fija la versión explícitamente.
dotnet add package IronPPT --version 2026.10.1
El paquete no contiene binarios nativos, y sus únicas dependencias son IronSoftware.Common y IronSoftware.System.Drawing.
Paso 2: Aplique su clave de licencia
Sin una clave, un programa puede crear una presentación en memoria y abrir un archivo existente, pero cada llamada a Save falla con IronSoftware.Exceptions.LicensingException y el mensaje Se requiere licencia de producción. El mensaje también menciona siete días de uso gratuito para desarrollo, pero el guardado falló en el primer intento en la prueba de este artículo. Una clave mal escrita causa Clave de licencia no reconocida en su lugar, y el resto de ese mensaje repite la clave. Una clave corta apareció completa, y una clave de longitud completa con un carácter cambiado apareció como sus últimos 32 caracteres. El código que registra mensajes de excepción, por lo tanto, escribe material de clave en su registro. Una clave de prueba gratuita está disponible a continuación.
Empiece a usar IronPPT en su proyecto hoy con una prueba gratuita.
Asigna la clave de licencia una vez al inicio de la aplicación, antes de cualquier llamada a IronPPT. Recupérala de una variable de entorno para que no se almacene en el repositorio.
IronPPT.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPPT_LICENSE_KEY");
IronPPT.License.IsLicensed se establece en true después de asignar una clave válida, y IronPPT.License.IsValidLicense informa si una cadena clave es válida. Sin la asignación anterior, IronPPT ignora IRONPPT_LICENSE_KEY. Lee variables de entorno nombradas IronPPT.LicenseKey y IRONPPT_LICENSEKEY sin ningún código.
Paso 3: Dirige tu asistente a la documentación de LLM de IronPPT
- llms.txt contiene una entrada de una línea para cada una de sus 15 páginas.
- llms-full.txt ofrece un resumen de cada una de las 16 páginas de documentación en un solo archivo.
- llms-full-catalog.txt extiende el índice incluyendo artículos de blog.
- La Referencia de API enumera la firma de cada miembro.
- Herramientas que admiten archivos de habilidad pueden usar skill.md, que cubre configuración, licenciamiento, recetas y errores comunes.
- La Hoja de Datos del Producto AI detalla las plataformas soportadas y los principales casos de uso.
Proporciona el índice al inicio de cada sesión.
Open https://ironsoftware.com/ppt/csharp/llms.txt before you write more IronPPT code.
Keep to what its linked pages document.
The IronPPT object model works like this:
- PresentationDocument is the deck, and a new one already holds one blank slide.
- AddSlide appends a Slide.
- Slide.AddText, Slide.AddParagraph and Slide.AddImage fill a slide.
- Slide.Remove deletes a slide, and setting Slide.Show to false hides it.
- Save writes the .pptx file, and the constructor that takes a path opens one.
For a member those pages leave out, do this:
1. Search https://ironsoftware.com/ppt/csharp/object-reference/api/ for it.
2. Build once to prove it compiles.
3. If you still can't confirm it, say so instead of guessing.
After that, list the IronPPT calls in this project that the docs don't cover.
El permiso para responder 'no documentado' le da al asistente una opción distinta a inventar un método.
Paso 4: Añadir contexto de IronPPT a tu proyecto
Almacena las reglas de IronPPT en un archivo de instrucciones del proyecto para que cada nueva sesión pueda leerlas. Claude Code lee CLAUDE.md, ChatGPT Codex lee AGENTS.md, GitHub Copilot lee .github/copilot-instructions.md, Cursor lee archivos .mdc en .cursor/rules/ o AGENTS.md, y Google Antigravity lee AGENTS.md o GEMINI.md. Un solo bloque de texto es compatible con todos, aunque los archivos de reglas de Cursor también incluyen cabecera MDC. Comienza con lo siguiente.
Every deck in this project is built with IronPPT, under these rules:
- `IronPPT` is both the NuGet package name and the namespace.
- Begin with the llms.txt index, https://ironsoftware.com/ppt/csharp/llms.txt.
- Tools that read skill files load https://ironsoftware.com/ppt/csharp/skill.md.
- Set `IronPPT.License.LicenseKey` from IRONPPT_LICENSE_KEY when the app starts.
- The program reads that variable itself and never lists environment variables.
- Keep the key out of output, logs, exception text, and source control.
- A wrong key's `LicensingException` message repeats the key. Log only its first line.
- A new `PresentationDocument` already has one slide. Use `Slides[0]` as the title slide.
- Add text, paragraphs, and images through `Slide` methods.
- Build slides in their final order, or set `Slide.Index` to move one.
- Edits to the `Slides` list do not change the deck.
- Remove a slide with `Slide.Remove()` and hide one with `Show = false`.
- On a deck opened from disk, replace a picture by removing it and adding the new image.
- Do not add the Open XML SDK or another presentation library.
- When IronPPT lacks a feature, report that rather than working around it.
El archivo de habilidad nombra IronPPT 2026.8.1 como la versión con la que fue probado, y su ejemplo de archivo único fija esa versión. También describe Slides como una lista que se puede editar para reordenar diapositivas y promete un período de desarrollo de siete días antes de que Save requiera una clave. Las pruebas para 2026.10.1 contradijeron ambas afirmaciones.
Paso 5: Prompt de Configuración de Un Solo Paso
Los pasos 1 a 4 se pueden enviar juntos como un solo mensaje al inicio de un proyecto o sesión.
Set this project up for PowerPoint work with IronPPT, following these rules:
- Reference the IronPPT package at version 2026.10.1.
- Assign IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey first thing at startup.
- The code reads that variable itself. Don't list environment variables.
- The key never shows up in the console, a log, or a committed file.
- Before coding, go through https://ironsoftware.com/ppt/csharp/llms.txt, then keep to it.
- Look up anything it doesn't cover at https://ironsoftware.com/ppt/csharp/object-reference/api/.
- Compile before relying on a member found there.
- Load https://ironsoftware.com/ppt/csharp/skill.md if the tool accepts skill files.
- When the skill file and the compiler disagree, believe the compiler.
- Put content on slides with Slide methods, not with PresentationDocument.AddText.
- Create the slides in their final order, since editing the Slides list changes nothing.
Save these rules to the instructions file your next sessions read.
Tell me which file you wrote and what else you changed.
Paso 6: Patrones de Prompt que Producen Código Funcional
Especifica las diapositivas, su orden, y el contenido de cada una.
Vago Crear una presentación trimestral con IronPPT.
Mejor Usa
Slides[0]para el título, luego añade una diapositiva por región en orden de ingresos, cada una con un encabezado en negrita de 32 puntos y tres párrafos, y guarda quarterly.pptx.
Indica la versión de IronPPT y el marco objetivo. Los miembros pueden cambiar entre versiones.
Mejor Usa IronPPT 2026.10.1 en .NET 9, y asigna la clave de IronPPT_LICENSE_KEY antes de la primera llamada a IronPPT.
Solicita archivos completos. Un fragmento puede omitir la directiva using IronPPT.Models;, que proporciona Slide, Text, y Image.
Mejor Devuelve el Program.cs completo, con sus directivas using y la línea de licencia, listo para compilar tal cual.
Paso 7: Verifica lo que Recibes
Cada uno de los siguientes errores es reproducible en 2026.10.1.
- Añadiendo la diapositiva del título con
AddSlide: cada nuevoPresentationDocumenttiene una diapositiva desde el inicio, construida con el diseño de título. Un programa que añada su propia diapositiva de título guarda una presentación que se abre en una diapositiva en blanco. Escribe el título enSlides[0], o añade todas las diapositivas primero y luego elimina la original, porque eliminar la última diapositiva de una presentación lanza InvalidOperationException. - Añadiendo texto a través del documento:
PresentationDocument.AddTextadjuntó su texto al último párrafo de la última diapositiva, yPresentationDocument.AddTextBoxcreó una nueva diapositiva para el cuadro de texto. Añade contenido a través de métodosSlide. - Estilizando el resultado de
AddTextcon un argumento de cadena: el texto devuelto no tiene objeto de estilo, por lo que establecer una propiedad sobre él lanza NullReferenceException. La receta de estilo del archivo de habilidades hace esa llamada. Asigna un nuevoTextStyleen su lugar. - Elegir una fuente con
FontFamily: la ejecución guardada no llevó ningún tipo de letra.LatinFontescribió el tipo de letra en el archivo.
Una presentación reabierta con IronPPT devuelve su cuenta de diapositivas y texto correctamente. Lee posición, tamaño, alineación y color del XML de la diapositiva en ppt/slides/slideN.xml. Después de una recarga, IronPPT informó texto centrado como Alineado a la Izquierda, y una sonda leyó los colores hexadecimales #C00000 y #FFC000 como #00000000. Posición, tamaño y tamaño de fuente regresaron en la escala EMU descrita en salida de texto e imagen.
Deja que el Agente Verifique su Propio Trabajo
El asistente puede ejecutar estas comprobaciones por sí mismo y presentar los resultados.
Do a clean Release build and run the app once more.
Then show me the evidence:
- The IronPPT types and members the code calls, each with its documentation page.
- The value of IronPPT.License.IsLicensed.
- Each saved deck's slide count and every slide's first line of text, read back from the file.
- Any hidden slide.
- Every shape's a:off, a:ext, algn and solidFill values, taken from ppt/slides/slideN.xml.
- Any image or text whose position, size, alignment or color differs from what the code set.
Read those four properties from the XML, never from a deck reopened with IronPPT.
End by saying whether each deck matches what the code meant to build.
Edición de diapositivas con IronPPT
El orden de las diapositivas, eliminación y reemplazo de imágenes se comportan de manera diferente a lo que muestran la guía de gestión de diapositivas y la guía de gestión de imágenes. Las pruebas de este artículo guardaron cada cambio y leyeron las partes PPTX de nuevo.
PresentationDocument.Slidesdevuelve una nueva lista en cada llamada.Remove,Insert,RemoveAt, yAddde esa lista no cambiaron nada en la presentación guardada, por lo que el ejemplo de reordenamiento de la guía deja el orden tal como estaba.Slide.Remove()eliminó la diapositiva, tanto en memoria como después de que la presentación fue cargada desde un archivo.- Establecer
Showen false mantuvo la diapositiva en el archivo y la marcó como oculta. Slide.Clone()lanzó MissingMethodException, por lo que una diapositiva no se puede duplicar.- Añadir una diapositiva eliminada de nuevo con
AddSlideprodujo una diapositiva en blanco. - Establecer
Slide.Indexmovió una diapositiva, tanto en una nueva presentación como en una abierta desde el disco, y el archivo guardado mantuvo el nuevo orden. Slide.Imagescontiene valoresIImage, por lo que la llamadaImages[0].Replace(image)de la guía se vincula al métodoReplacedel elemento general. Esa llamada reemplazó la imagen en una presentación creada en memoria y dejó la imagen anterior en una presentación abierta desde el disco.- Convertir la imagen a
Imagellega aImage.Replace, que funcionó en una presentación reabierta y lanzó NullReferenceException en una presentación en memoria. - Eliminar la imagen y añadir la nueva imagen con
AddImagefuncionó en ambos casos, aunque el paquete guardado mantuvo la imagen anterior como una parte de medios no utilizada.
Salida de texto e imagen con IronPPT
El XML de la diapositiva guardada y el validador Open XML SDK 3.5.1 dieron los siguientes resultados.
- Cada llamada
Slide.AddTextcreó su propia forma de texto de 150 por 100 puntos y no estableció posición, por lo que la forma hereda su colocación del diseño de la diapositiva. AddParagraphañadió su párrafo a la última forma de texto de la diapositiva.- La primera diapositiva de una nueva presentación mantuvo marcadores de posición para título y subtítulo vacíos junto al texto añadido por
AddText. - Imagen
Position,Width, yHeightestán en puntos. Un PNG de 400 por 200 píxeles sin resolución establecida, añadido sin tamaño, se convirtió en 300 por 150 puntos, su tamaño en píxel a 96 DPI. - En una presentación reabierta, las mismas propiedades devolvieron las cifras EMU almacenadas como puntos, 12,700 veces los valores que se establecieron.
FontSizeconPointestablecido en 32 escribió un tamaño de 32 puntos, yIsBoldescribió en negrita.- Cada ejecución coloreada a través de
TextStyle.Colorfalló la validación con un error de elemento hijo inválido, para colores nombrados y hexadecimales por igual. Las presentaciones sin texto coloreado validaron sin errores.
Un Resultado que Puedes Reproducir
La prueba consta de un aviso, y no escribes nada del código. Abre una nueva sesión en una carpeta vacía, pega el aviso, y compara el resultado con los criterios de aprobación.
IRONPPT_LICENSE_KEY.El prompt
Create a .NET 9 console app that builds a quarterly regional deck with IronPPT.
If this directory isn't empty, tell me and stop.
Don't ask questions. Note your choice for each missing detail.
Keep every deliverable in this directory.
Work in this order:
1. Add IronPPT 2026.10.1 from NuGet.
2. Study https://ironsoftware.com/ppt/csharp/llms.txt, its license key page and four how-to guides.
3. Follow these code rules:
- Use only members those pages or the API reference document.
- At startup, the program itself assigns IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey.
- Never print the key, save it, or list environment variables.
- Stop with a message if IronPPT.License.IsLicensed is false.
- Print only the first line of a licensing error from Save.
4. Before building slides, the code writes qbr-data.json in thousands of dollars:
- Revenue/target: North 1240/1100, South 860/950, East 1410/1300, West 720/900.
- Three commentary lines of your own per region, under 60 characters each.
5. Draw each region's revenue and target as an 800 by 400 pixel PNG bar chart:
- Save charts/<region>.png and a grey background copy, charts/<region>-board.png.
- Encode the PNGs yourself, with no package or imaging library.
6. Build qbr.pptx with these seven slides in order, none blank:
- Title: "Quarterly Business Review" in bold 40 point, "Q3 2026" in 24 point.
- A slide headed "Agenda" listing the four regions.
- One slide per region, highest revenue first.
- A last slide headed "Next steps" with a "South: 90K below target" line per region below target.
Each region slide has:
- Its name as a bold 32 point heading, then one paragraph per commentary line.
- "Revenue 1410K against a target of 1300K" with its figures.
- That line in Color.Green if the target is met, otherwise Color.Red.
- Its chart at x 360, y 140, 320 by 160, all in points.
7. Reopen qbr.pptx from disk and save a board version, qbr-board.pptx, like this:
- Drop the agenda slide.
- Hide "Next steps" without removing it.
- Move the region with the largest shortfall right after the title.
- Swap that region's chart for its -board.png.
- Keep the rest in original order.
- Work around and note any change the save loses.
- As a last resort, rebuild from your data in the new order.
8. Build and run in Release.
The app fills readback.md only from both saved decks, reopened with IronPPT:
- A table per deck of each slide's position, first text line, visibility and image count.
- A section on each step where the guides' approach didn't work.
Its checks give expected, actual and match for both decks:
- Slide count and region order.
- Revenue line color, chart position and size per region slide.
- The board deck's moved region chart against its -board.png, by image bytes.
9. Fix each failed check and rerun, or describe an IronPPT cause nothing gets around and move on.
10. Report the Release build result, checks matched out of total, and your assumptions.
Resultado
El readback.md sin editar de la app lista sus tablas de diapositivas y verificaciones, y ambas presentaciones están disponibles tal como la app las guardó, qbr.pptx y qbr-board.pptx. Las siguientes cifras provienen de una lectura independiente de las partes PPTX guardadas.

La versión de tablero gris del gráfico Oeste, como la app lo dibujó con su propio codificador PNG y lo colocó en qbr-board.pptx, sin editar.
- Una compilación Release para net9.0 completada sin advertencias ni errores.
- qbr.pptx contenía siete diapositivas en el orden solicitado, y ninguna de ellas estaba en blanco.
- La aplicación eliminó la diapositiva con la que comienza un nuevo mazo llamando a Remove en ella, después de que la llamada de lista de la guía no tuvo efecto.
- Cada encabezado de región estaba en negrita a 32 puntos.
- Las líneas de ingresos eran verdes para Norte y Este y rojas para Sur y Oeste.
- Todas las ocho diapositivas de región en los dos mazos colocaron el gráfico en x 360 e y 140 puntos, tamaño 320 por 160 puntos.
- qbr-board.pptx contenía seis diapositivas, con Oeste, 180K por debajo del objetivo, directamente después del título.
- Solo la diapositiva de próximos pasos estaba oculta en la presentación del tablero.
- La app construyó la presentación del tablero desde qbr.pptx tal como se abrió desde el disco y movió Oeste estableciendo la propiedad Index de su diapositiva.
- La diapositiva Oeste en la presentación del tablero llevaba los bytes exactos del PNG del gráfico que escribió la app.
- La verificación de la aplicación coincidió en 22 de 22 verificaciones.
- La lectura independiente coincidió en las 60 de sus verificaciones.
- El validador Open XML SDK informó seis errores en cada presentación, uno por cada ejecución coloreada.
- Ningún archivo en la carpeta del proyecto, su historial de Git, ni los archivos de sesión de Claude Code contenían la clave de licencia.
- El aviso de configuración escribió sus once reglas en un nuevo CLAUDE.md e instaló skill.md como una habilidad del proyecto.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Los avisos de los pasos 1, 3, 5, y 7 se ejecutaron después del aviso de aceptación en la misma sesión.
Lo que pasa
- Una compilación Release se completa sin ninguna edición manual.
- qbr.pptx tiene siete diapositivas en el orden que establece el paso 6, ninguna de ellas en blanco, cuando lees el archivo por ti mismo.
- Cada diapositiva de región contiene su encabezado, tres párrafos de comentarios, la línea de ingresos, y un gráfico en la posición y tamaño solicitados.
- qbr-board.pptx tiene seis diapositivas, con la región que más falló en su objetivo justo después del título y la diapositiva de próximos pasos oculta.
- readback.md toma cada valor real de las presentaciones guardadas y nombra cada paso que necesitaba un enfoque diferente.
- Una búsqueda en la carpeta del proyecto no encuentra ningún archivo que contenga la clave de licencia.
El récord de ejecución
- Todas las ejecuciones utilizaron un escritorio Windows 11 x64 con un Core i9-14900KF y 64 GB de memoria.
- El proyecto de esta guía apunta a net9.0 y fija
IronPPT2026.10.1. - La duración de una guía es la suma de los tiempos registrados para los avisos en su página, y el recuento de filas de esta guía solo incluye el aviso de aceptación.
- Última prueba 16 de octubre de 2026, para cada guía en la tabla.
| Guía | Asistente y versión | Modelo | Duración (minutos) |
|---|---|---|---|
| Esta guía | Claude Code 2.1.277, una sesión, mensajes de permiso desactivados | Claude Opus 5 | 18.2 |
| Claude Code | Claude Code 2.1.277, mensaje 3 en modo plan | Soneto 5 con planificación Opus 5 | 33.3 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 22.2 |
| GitHub Copilot | Copilot CLI 1.0.98, aviso 3 en modo plan, el cuerpo del problema y la revisión en sus propias sesiones | GPT-6 Luna, elegido por Auto | 16.1 |
| Cursor | Cursor CLI 2026.10.14, sin cabeza, aviso 3 en Modo Plan, que permaneció encendido para los avisos 5 a 7 | Composer 2.5 | 15.4 |
| Google Antigravity | Antigravity CLI 1.4.0, avisos de permiso omitidos | Gemini 4 Argon (Medio) | 47.4 |
Guías Específicas del Agente
Cada guía a continuación aplica estos pasos a una herramienta y una tarea de presentación.
- Usa IronPPT con Claude Code para material de curso de capacitación con texto estilizado
- Usa IronPPT con ChatGPT Codex para una presentación semanal de ventas ensamblada a partir de una plantilla
- Usa IronPPT con GitHub Copilot para una presentación de listado de propiedades con fotos
- Usa IronPPT con Cursor para portar un generador de presentaciones de informe Open XML SDK de una escuela a IronPPT
- Usa IronPPT con Google Antigravity para una aplicación web que construye una presentación de estado de proyecto para descarga
Solución de problemas
- Claves de licencia de IronPPT si
Savelanza una excepción de licencia - Solicitud de soporte de ingeniería si una presentación guardada difiere del código y la sección de edición de diapositivas no explica por qué
- Gestionar Imágenes si una imagen no está donde el código la colocó
¿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.