Cómo usar IronPPT con ChatGPT Codex
Un equipo de operaciones de ventas envía la misma presentación cada lunes. Una plantilla proporciona las diapositivas y las cifras de la semana las completan. La diapositiva de región única se convierte en una diapositiva por región, se elimina una diapositiva de promoción desactualizada y el apéndice permanece en el archivo pero fuera de la presentación. Cuando una operación de diapositiva falla silenciosamente, la presentación aún se guarda y el registro de trabajo aún informa éxito. Los gerentes regionales entonces reciben un resumen de una promoción que terminó el 30 de junio, una diapositiva antes de los destacados de esta semana.
ChatGPT Codex es el agente de codificación de OpenAI. Funciona en un repositorio, donde edita archivos, ejecuta comandos como dotnet run e informa lo que cambió. El mismo agente se ejecuta en una terminal, una extensión de IDE, la aplicación de escritorio de ChatGPT y la nube. IronPPT, la biblioteca .NET de Iron Software para PowerPoint, crea, abre, edita, y guarda archivos .pptx sin Microsoft Office.
Codex obtiene una plantilla de ventas semanal, un archivo de reglas y dos semanas de datos regionales. Cada conteo de diapositivas que informa proviene de un CSV escrito en el mismo turno, y cada operación de diapositiva se prueba en una presentación guardada antes de que el código por lotes dependa de ella.
Inicio rápidoInicia Codex en un proyecto de consola .NET 9 que contiene las carpetas Templates y Data.
$ironppt Install IronPPT 2026.10.1 in this console app and list the slides of the sales template.
Program.cs opens Templates/weekly-sales-template.pptx and saves nothing.
Each slide gets a row in out/quickstart.csv, with these columns:
- number, counting from 1
- heading, the first text on the slide
- texts, how many text items the slide holds
- shown, yes or no from the slide's Show property
Program.cs reads IRONPPT_LICENSE_KEY itself and copies it into License.LicenseKey.
Never print the key or write it to a file or log, and don't list environment variables.
If three builds or runs fail, stop and show me the last error.
Otherwise, read the slide count back from the CSV and tell me the number.
La mención $ironppt carga la habilidad de IronPPT antes de que Codex escriba código.
Flujo de trabajo mínimo (5 pasos)
- Descarga la biblioteca de PowerPoint de C# desde NuGet
- Guarda la habilidad de IronPPT como .agents/skills/ironppt/SKILL.md para que la mención
$ironpptse resuelva - Compromete un AGENTS.md que nombre las reglas de la presentación y acepte solo una presentación reabierta como prueba
- Elimina las diapositivas de la plantilla con
Remove()en la diapositiva, y construye diapositivas movidas o repetidas como nuevas diapositivas - Reabre la presentación guardada y compara cada diapositiva con el plan
¿Qué es ChatGPT Codex y cómo se integra en el trabajo de presentación .NET?
El comando /permissions establece cuándo Codex edita archivos o ejecuta comandos sin preguntar primero. La documentación de la CLI de Codex cubre la instalación y uso en terminal, y el repositorio de código abierto publica sus lanzamientos.
El conocimiento de Codex sobre IronPPT proviene de sus datos de entrenamiento y los archivos que se le proporcionan. Un nombre de miembro que falta en IronPPT falla en la compilación.
IronPPT envía un ensamblaje .NET Standard 2.0, y su paquete NuGet enumera Windows, Linux y macOS. La ejecución de la prueba construyó el proyecto en Windows.
¿Cómo se escribe un aviso de IronPPT y se configura Codex para ello?
Los avisos a continuación nombran la plantilla y los datos (Templates/weekly-sales-template.pptx y Data/week-41.csv) y las reglas (Data/README.md, que establece el orden, las diapositivas omitidas y ocultas y el estilo de la casa).
Codex escanea .agents/skills en cada carpeta desde el directorio de trabajo hasta la raíz del repositorio. Cada habilidad es una carpeta que contiene un SKILL.md cuyo frontmatter define un nombre y una descripción. Guardar skill.md de IronPPT como .agents/skills/IronPPT/SKILL.md permite que la mención $ironppt se resuelva. La habilidad establece que se verificó contra IronPPT 2026.8.1, mientras que esta guía instala 2026.10.1.
Codex lee AGENTS.md antes de comenzar cualquier trabajo. Camina desde la raíz del repositorio hasta la carpeta de trabajo, toma a lo más un archivo por directorio y permite que el archivo más profundo sobrescriba al más superficial. El comando /init genera un primer borrador.
Write an AGENTS.md in the repository root, under a heading called Weekly sales deck.
Put these rules in it, one per line:
- IronPPT 2026.10.1 is the only PowerPoint library here. Package and namespace are both IronPPT.
- Don't add DocumentFormat.OpenXml or any other Office package.
- Data/README.md defines the deck, and it wins over anything else.
- Templates/ and Data/ are read-only.
- Look up IronPPT members in the ironppt skill under .agents/skills/ironppt/.
- A probe on a saved deck outranks both the skill and the installed IronPPT.xml.
- A deck counts as built only once it's saved, reopened from disk and checked.
- Every count you report comes from a CSV written in that turn. The reply names that CSV.
- The key stays in IRONPPT_LICENSE_KEY.
Show me the finished file.
¿Cómo pides a Codex que agregue IronPPT y verifique la licencia?
Show me the IronPPT PackageReference in WeeklySalesDeck.csproj and the version NuGet resolved.
Then quote the full output of dotnet list package with --include-transitive.
Don't change any package references.
IronPPT 2026.10.1 depende de IronSoftware.Common 2026.4.2 e IronSoftware.System.Drawing 2026.8.2, y la lista de paquetes de la ejecución de prueba mostró 30 paquetes transitivos, entre ellos SixLabors.ImageSharp 3.1.12 y Grpc.Net.Client 2.62.0. Revisa el changelog de IronPPT antes de fijar un lanzamiento.
Sin una clave, IronPPT abre una presentación, lee su texto, agrega diapositivas y texto, y oculta diapositivas. Solo Save falla, con una excepción de licencia cuyo mensaje es Production License Required, y no se escribe ningún archivo. IronPPT lee una clave de la variable de entorno IronPPT.LicenseKey o IRONPPT_LICENSEKEY por sí mismo, pero ignora IRONPPT_LICENSE_KEY. El código que mantiene la clave bajo ese nombre asigna License.LicenseKey antes del primer guardado. El tipo de excepción de licencia no es público en IronPPT 2026.10.1, por lo que un manejador captura Exception y verifica el nombre del tipo.
Move the key line into Startup.ApplyIronPptKey and call that method first in Program.cs.
It sets License.LicenseKey from IRONPPT_LICENSE_KEY, then prints License.IsLicensed.
Next, test what IronPPT does without a key.
Start the program three times as child processes, each with a --licence-check option:
1. Clear IRONPPT_LICENSE_KEY for that child only.
2. Keep the variable set, and pass a --no-startup flag that skips the Startup call.
3. Keep the variable set and the Startup call in place.
Each child opens the template, replaces {{WEEK}} with 41 and saves out/licence-check-N.pptx.
Write each call to out/licence-check.csv, with run, call, result, exception type and message.
Add a column that says whether each pptx file exists afterwards.
If three repair attempts fail, stop there.
Tell me which of the three runs saved a file.
La página de claves de licencia enumera las otras formas de proporcionar una clave.
¿Por qué el código de diapositivas de la guía deja la presentación sin cambios?
La guía de gestión de diapositivas elimina una diapositiva con Slides.RemoveAt y mueve una con Slides.Remove seguido de Slides.Insert, y la habilidad de IronPPT describe Slides como una lista mutable. En IronPPT 2026.10.1, PresentationDocument.Slides devuelve una nueva lista cada vez que se lee, y esas llamadas solo cambian esa copia. En calibración, Slides.RemoveAt(0) en una presentación cargada de seis diapositivas dejó el conteo en seis, y una presentación guardada después de un movimiento mantuvo su orden original. El código se compila, no genera excepción y guarda la diapositiva que se suponía debía eliminar.
Tres operaciones sobre una diapositiva existente realmente llegan a la presentación. Llamar Remove() en la misma diapositiva la elimina del archivo guardado, y Show = false escribe una diapositiva oculta que permanece en el archivo. Configurar Slide.Index mueve la diapositiva, y una prueba separada reabrió la presentación guardada en el nuevo orden.
Probe which slide operations survive a save, in a console app at scratch/slides-probe/.
Run it yourself on a copy of the template in scratch/, and apply the key the way Startup does.
Add a Compile Remove item that keeps scratch/** out of WeeklySalesDeck.csproj.
Give each case its own try block and its own saved file.
Reopen each saved file and measure these cases:
- Slides.RemoveAt(4), and whether the slide count drops
- Slides.Remove, then Slides.Insert(1, ...) on Highlights, and the order that results
- Remove() on the Q2 Promotion Recap slide itself
- Clone() on the region slide
- AddSlide(new Slide()) with AddText, and where the new slide ends up
- Show = false on the appendix
Then have the explorer agent read IronPPT.xml and the ironppt skill, writing nothing.
It reports what each source says about the Slides collection and about Clone.
Put every finding in out/slides-probe.csv, quoting the probe output, the XML or the skill.
Mark the rows where the skill and the probe disagree, and tell me which they are.
Una comprobación contra el objeto de lista editado pasa, porque esa copia sí cambió.
¿Cómo se arma la presentación semanal a partir de la plantilla?
La guía de gestión de diapositivas no cubre duplicar una diapositiva. En IronPPT 2026.10.1, Clone() en una diapositiva lanza una MissingMethodException, y agregar el mismo objeto de diapositiva dos veces no deja diapositiva extra en el archivo guardado. Eliminar una diapositiva y agregarla nuevamente al final dejó una diapositiva vacía en su antigua posición. El método que funciona agrega un nuevo Slide para cada diapositiva de salida, la llena con nuevo texto en el orden que necesita la presentación y luego llama Remove() en los originales de la plantilla.
Copiar el estilo de una presentación cargada también falla. En calibración, un encabezado de 36 pt copiado propiedad por propiedad se escribió a 3,600 pt, y su color #1F4E79 se volvió negro. El aviso por lo tanto establece el estilo de la casa del README en cada texto.
La plantilla sigue la lista de diapositivas en el README, con el Resumen de Promoción del Q2 quinto y Destacados sexto.
Descargar weekly-sales-template.pptx
La plantilla de ventas semanal usada en la ejecución de prueba, con una diapositiva de región que sostiene los tokens de la región.
Have the worker agent write Services/DeckAssembler.cs. It builds the deck Data/README.md describes.
DeckAssembler accepts these options:
- --week, which picks Data/week-NN.csv and Data/week-NN.tokens
- --template, defaulting to Templates/weekly-sales-template.pptx
- --plan, which writes out/deck-plan.csv and saves no deck
- --build, which saves out/week-NN.pptx
The probe showed which calls reach the saved file.
Build the deck with those calls, in these steps:
1. Open the template and find each slide by its heading.
2. For every output slide, add a new slide with AddSlide and write its texts with AddText.
3. Set the README's house style on every text you write.
4. Set Show = false on the new appendix slide.
5. Call Remove() on the eight template slides, then save.
The plan CSV has one row per output slide, with position, template heading, final heading and shown.
Run --plan --week 41, then give me the row count and the hidden slides from the CSV.
¿Cómo verificas la presentación guardada por Codex?
Run --build --week 41, then check the saved deck with code that's separate from the build.
The check reopens out/week-41.pptx and writes out/week-41-check.csv with these columns:
- position and heading
- shown
- the slide's full text, joined with " | "
- whether any {{ is left
Compare the check CSV with out/deck-plan.csv row by row.
Tell me which rows differ, and whether Q2 Promotion Recap appears anywhere in the deck.
Resultado
DeckAssembler guardó la presentación abajo para la semana 41 en la ejecución de prueba, y se publica sin cambios.
La presentación de ventas de la semana 41 tal como la guardó IronPPT.
¿Qué sucede cuando cambia la plantilla?
Show me that DeckAssembler refuses Templates/weekly-sales-template-v2.pptx.
Marketing sent it with Highlights renamed to Wins This Week.
Run --build --week 41 --template Templates/weekly-sales-template-v2.pptx.
The existing out/week-41.pptx has to stay the same, byte for byte.
Record the attempt in out/template-check.csv with these columns:
- exit code and message
- the headings the build found
- the SHA-256 of out/week-41.pptx before and after
Tell me whether the two hashes match.
¿Cómo se verifica una diapositiva a partir de una captura de pantalla?
Codex acepta imágenes como contexto. Pasa una con la bandera -i (forma larga --image) al iniciar o reanudar una sesión, o pégala en el compositor interactivo.
Check the screenshot I attached with -i against the data and the deck.
A regional manager sent it and says the West revenue is wrong.
Don't change any code, and work through these steps:
1. Read the region and its three figures from the image.
2. Compare them with Data/week-41.csv and Data/week-40.csv.
3. Compare them with the West slide in out/week-41.pptx, using its text in out/week-41-check.csv.
4. Write the comparison to out/screenshot-check.csv.
Tell me which week the screenshot shows, and whether out/week-41.pptx is right.
¿Cómo depuras el resultado incorrecto de la presentación de extremo a extremo?
Find out why the week 40 deck went out wrong. Data/week-40-complaint.md lists four problems.
Logs/week-40/deck.log says every step worked. Output/week-40.pptx is the deck that was sent.
Have the explorer agent read Jobs/LegacyWeeklyDeck.cs, the log and the deck before anything else.
A throwaway script under scratch/ may read the deck.
Don't edit any code outside scratch/.
Write out/week-40-diagnosis.md and cover these points in it:
- the line behind each of the four problems
- why the log reported success anyway
- the smallest fix for each, based on what the probe showed
Then give me one line per problem.
Revisa el diagnóstico antes de permitir cualquier edición. El trabajo heredado escribió cada línea de registro después de que una llamada se devolviera y nunca reabrió la presentación.
¿Cómo convierte el código único en componentes reutilizables y probados?
Ask the worker agent for a DeckService class that meets these conditions:
- It resolves from a Microsoft.Extensions.DependencyInjection container.
- A DeckOptions record configures it, with week, template, plan-only and output folder.
- It keeps the README rules, the heading check and the house style from DeckAssembler.
- DeckService.cs stays below 150 lines, and its public members have XML doc comments.
- Nothing calls Jobs/LegacyWeeklyDeck.cs.
Then build week 41 with DeckService into out/final/week-41.pptx.
Check that deck the way you checked out/week-41.pptx, into out/final/week-41-check.csv.
Compare the two check files and list every difference.
Un refactor puede omitir la verificación de encabezado y aún compilar.
Add an xUnit project at tests/WeeklySalesDeck.Tests, in the same solution as the main project.
Exclude tests/** from what the main project compiles.
The tests get the key through Startup.ApplyIronPptKey.
Each test builds a deck in a temp folder and reopens it.
Between them, the tests check these conditions:
- week 41 gives 11 slides, with Highlights second and the appendix hidden
- the five region slides follow the CSV order
- East shows Revenue: $0 and still has its slide
- no {{ is left anywhere, and Q2 Promotion Recap is gone
- the v2 template is refused, and the message names the missing heading
Run dotnet test with --logger trx and --results-directory out/tests/.
Read the trx file and tell me how many tests passed and failed.
Para preguntas de API, el IronPPT.xml instalado documenta miembros de diapositiva como AddSlide, Remove, Clone, Index y Show. Los resultados de la prueba muestran cuál de ellos llega a una presentación guardada.
$ironppt List the members in the installed IronPPT.xml that add, remove, move, copy or hide slides.
For each member you find, tell me these two things:
- what the XML says it does
- whether out/slides-probe.csv or the trx file in out/tests/ shows it working on a saved deck
Then write one compiling line per member in a probe project under scratch/api-probe/.
Build that probe with dotnet build, but don't run it.
¿Cómo reutilizas estos avisos en otra presentación?
Con la plantilla, los archivos de datos y las reglas del README cambiados, los mismos avisos se aplican a packs de junta, presentaciones de estado de proyecto o revisiones de cliente. Para configuraciones que se aplican a cada asistente, consulta la guía de asistentes de codificación AI de IronPPT.
¿Qué produjeron los prompts en una ejecución real?
Los avisos anteriores se enviaron a Codex en orden, en una única sesión. El trabajo heredado, su registro y su presentación se añadieron antes del aviso de depuración. Los scripts separados reabrieron cada presentación que guardó la ejecución y leyeron cada diapositiva del archivo.
- Antes de la ejecución, la plantilla contenía ocho diapositivas, todas ellas mostradas.
- Con la variable vaciada, el guardado lanzó la excepción de licencia, y el archivo de salida no existía posteriormente.
- Con la variable establecida y la llamada de inicio omitida, el guardado falló de la misma manera.
- En la prueba, Slides.RemoveAt(4) dejó todas las ocho diapositivas en el archivo guardado.
- Clone() en la diapositiva de región lanzó una MissingMethodException.
- Codex comenzó tres subagentes, y el aviso de depuración reutilizó el agente explorador del aviso de prueba.
- La presentación guardada de la semana 41 contenía 11 diapositivas en el orden del README, con las cinco diapositivas de región en orden CSV.
- Diez diapositivas fueron mostradas y el apéndice se guardó como oculto.
- El Resumen de Promoción del Q2 estaba ausente en la presentación.
- East conservó su diapositiva con ingresos de $0.
- La v2 de plantilla rechazada dejó la hash SHA-256 de la presentación existente sin cambios.
- Codex igualó la captura de pantalla con las cifras del Oeste de la semana 40.
- El diagnóstico relacionó cada uno de los cuatro problemas de la semana 40 con sus líneas en el trabajo heredado.
- El diagnóstico trazó la diapositiva oculta del Norte hasta la diapositiva de región reutilizada que Slides.Last() devolvió.
- Una presentación construida con DeckService coincidió con la primera construcción en cada diapositiva.
- Las cinco pruebas pasaron en la ejecución de Codex y en la nuestra.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Los paquetes de NuGet vinieron de una caché restaurada antes de la ejecución, porque el entorno de prueba no tenía red.
La guía de GitHub Copilot mide un fallo similar para imágenes, donde la llamada Replace de la guía de gestión de imágenes deja la foto antigua en una presentación cargada. La guía de Google Antigravity construye presentaciones para solicitudes web simultáneas, que IronPPT sirvió correctamente solo cuando un bloqueo único guardó cada llamada de IronPPT. El registro de ejecución compartido proporciona la versión de Codex, el modelo, el tiempo y la máquina de prueba.
Solución de problemas
- Gestión de Diapositivas para ocultar una diapositiva con
Showy mantenerla en el archivo - Elemento de Diapositiva para establecer un estilo de texto en nuevo texto en lugar de copiarlo de una presentación cargada
- Aplicación de Claves de Licencia si cada guardado falla con Production License Required
¿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.