Comment utiliser IronPPT avec ChatGPT Codex
Une équipe des opérations de vente envoie le même deck chaque lundi. Un modèle fournit les diapositives et les chiffres de la semaine les remplissent. La diapositive de région unique devient une diapositive par région, une diapositive de promotion dépassée est retirée, et l'annexe reste dans le fichier mais en dehors du diaporama. Lorsque l'opération de diapositive échoue silencieusement, le deck est toujours enregistré et le journal de travail signale toujours un succès. Les directeurs régionaux reçoivent alors un récapitulatif d'une promotion qui s'est terminée le 30 juin, une diapositive avant les faits saillants de la semaine.
ChatGPT Codex est l'agent de codage d'OpenAI. Cela fonctionne dans un dépôt, où il modifie des fichiers, exécute des commandes telles que dotnet run et rapporte ce qu'il a changé. Le même agent fonctionne dans un terminal, une extension IDE, l'application de bureau ChatGPT et le cloud. IronPPT, la bibliothèque .NET de Iron Software pour PowerPoint, crée, ouvre, modifie et enregistre des fichiers .pptx sans Microsoft Office.
Codex reçoit un modèle de ventes hebdomadaire, un fichier de règles et deux semaines de données régionales. Chaque nombre de diapositives qu'il signale provient d'un CSV écrit à la même occasion, et chaque opération de diapositive est testée sur un deck enregistré avant que le code par lot ne s'y fie.
Démarrage rapideDémarrez Codex dans un projet console .NET 9 qui contient les dossiers Templates et 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 mention $ironppt charge l'aptitude d'IronPPT avant que Codex n'écrive le code.
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque C# PowerPoint depuis NuGet
- Enregistrez l'aptitude d'IronPPT sous .agents/skills/ironppt/SKILL.md pour que la mention
$ironpptsoit résolue. - Commitez un AGENTS.md qui nomme les règles du deck et n'accepte qu'un deck rouvert comme preuve.
- Supprimez les diapositives modèles avec
Remove()sur la diapositive, et construisez les diapositives déplacées ou répétées comme de nouvelles diapositives. - Rouvrez le deck enregistré et comparez chaque diapositive avec le plan.
Qu'est-ce que ChatGPT Codex et comment s'intègre-t-il dans le travail de présentation .NET?
La commande /permissions définit quand Codex modifie des fichiers ou exécute des commandes sans demander d'abord. La documentation CLI de Codex couvre l'installation et l'utilisation du terminal, et le dépôt open-source publie ses versions.
La connaissance de Codex sur IronPPT provient de ses données d'entraînement et des fichiers qui lui sont fournis. Un nom de membre qu'IronPPT ne possède pas fait échouer la compilation.
IronPPT livre une assembly .NET Standard 2.0, et son package NuGet répertorie Windows, Linux et macOS. La session de test a construit le projet sur Windows.
Comment rédiger une invite IronPPT et configurer Codex pour celle-ci?
Les invites ci-dessous nomment le modèle et les données (Templates/weekly-sales-template.pptx et Data/week-41.csv) et les règles (Data/README.md, qui établit l'ordre, les diapositives omises et masquées et le style maison).
Codex scanne les .agents/skills dans chaque dossier du répertoire de travail jusqu'à la racine du dépôt. Chaque aptitude est un dossier contenant un SKILL.md dont le front matter définit un nom et une description. Enregistrer le skill.md d'IronPPT sous .agents/skills/IronPPT/SKILL.md permet de résoudre la mention $ironppt. L'aptitude dit qu'elle a été vérifiée contre IronPPT 2026.8.1, alors que ce guide installe 2026.10.1.
Codex lit AGENTS.md avant de commencer tout travail. Il parcourt de la racine du dépôt au dossier de travail, prend au plus un fichier par répertoire et permet au fichier le plus profond de remplacer le plus superficiel. La commande /init génère un premier jet.
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.
Comment demander à Codex d'ajouter IronPPT et vérifier la licence?
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 dépend d'IronSoftware.Common 2026.4.2 et d'IronSoftware.System.Drawing 2026.8.2, et la liste des packages de la session de test montrait 30 packages transitifs, parmi eux SixLabors.ImageSharp 3.1.12 et Grpc.Net.Client 2.62.0. Consultez le changelog d'IronPPT avant de fixer une version.
Sans clé, IronPPT ouvre un deck, lit son texte, ajoute des diapositives et du texte, et masque des diapositives. Seul Save échoue, avec une exception de licence dont le message est Production License Required, et aucun fichier n'est écrit. IronPPT lit une clé depuis la variable d'environnement IronPPT.LicenseKey ou IRONPPT_LICENSEKEY par lui-même, mais il ignore IRONPPT_LICENSE_KEY. Le code qui garde la clé sous ce nom assigne License.LicenseKey avant le premier enregistrement. Le type d'exception de licence n'est pas public dans IronPPT 2026.10.1, donc un gestionnaire capte Exception et vérifie le nom du type.
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 page des clés de licence indique les autres moyens de fournir une clé.
Pourquoi le code de diapositive du guide laisse-t-il le deck inchangé?
Le guide de gestion des diapositives supprime une diapositive avec Slides.RemoveAt et déplace une avec Slides.Remove suivi de Slides.Insert, et l'aptitude IronPPT décrit Slides comme une liste mutable. Dans IronPPT 2026.10.1, PresentationDocument.Slides renvoie une nouvelle liste chaque fois qu'on la lit, et ces appels ne changent que cette copie. Lors de l'étalonnage, Slides.RemoveAt(0) sur un deck de six diapositives chargé a laissé le nombre à six, et un deck enregistré après un déplacement a conservé son ordre d'origine. Le code compile, ne soulève pas d'exception et enregistre la diapositive qu'il était censé supprimer.
Trois opérations sur une diapositive existante parviennent au deck. Appeler Remove() sur la diapositive elle-même la retire du fichier enregistré, et Show = false écrit une diapositive cachée qui reste dans le fichier. Définir Slide.Index déplace la diapositive, et une sonde séparée a rouvert le deck enregistré dans le nouvel ordre.
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.
Un contrôle contre l'objet liste modifiée réussit, car cette copie a bien changé.
Comment assembler le deck hebdomadaire à partir du modèle?
Le guide de gestion des diapositives ne couvre pas la duplication d'une diapositive. Dans IronPPT 2026.10.1, Clone() sur une diapositive lance une MissingMethodException, et l'ajout du même objet diapositive deux fois ne laisse aucune diapositive supplémentaire dans le fichier enregistré. Supprimer une diapositive et l'ajouter à nouveau à la fin a laissé une diapositive vide à son ancien emplacement. La méthode qui fonctionne ajoute un nouveau Slide pour chaque diapositive de sortie, le remplit avec un nouveau texte dans l'ordre dont le deck a besoin et appelle ensuite Remove() sur les originaux du modèle.
Copier le style d'un deck chargé échoue également. Lors de l'étalonnage, un titre de 36 pt copié propriété par propriété était écrit à 3 600 pt, et sa couleur #1F4E79 devenait noire. L'invite règle donc le style de la maison du README sur chaque texte.
Le modèle suit la liste des diapositives dans le README, avec le récapitulatif de la promotion du T2 en cinquième position et les faits saillants en sixième.
Télécharger weekly-sales-template.pptx
Le modèle de ventes hebdomadaire utilisé lors de la session de test, avec une diapositive de région qui contient les jetons de région.
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.
Comment vérifier le deck que Codex a enregistré?
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.
Sortie
DeckAssembler a enregistré le deck ci-dessous pour la semaine 41 lors de la session de test, et il est publié sans changement.
Le deck de ventes de la semaine 41 tel qu'il a été enregistré par IronPPT.
Que se passe-t-il lorsque le modèle change?
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.
Comment vérifier une diapositive à partir d'une capture d'écran?
Codex accepte les images comme contexte. Passez-en une avec le drapeau -i (forme longue --image) lors du démarrage ou de la reprise d'une session, ou collez-la dans le compositeur interactif.
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.
Comment déboguer une sortie de deck incorrecte de bout en bout?
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.
Examinez le diagnostic avant de permettre toute modification. Le travail hérité écrivait chaque ligne de journal après qu'un appel ait renvoyé et n'a jamais rouvert le deck.
Comment transformer un code ponctuel en composants réutilisables et testés?
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 remaniement peut supprimer le contrôle du titre tout en compilant.
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.
Pour les questions d'API, l'IronPPT.xml installé documente les membres de diapositive tels que AddSlide, Remove, Clone, Index et Show. Les résultats de la sonde montrent lesquels d'entre eux atteignent un deck enregistré.
$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.
Comment réutiliser ces invites sur un autre deck?
Avec le modèle, les fichiers de données et les règles du README modifiés, les mêmes invites s'appliquent aux packs de conseil, aux decks de statut de projet ou aux avis des clients. Pour une configuration applicable à chaque assistant, référez-vous au guide des assistants de codage IA d'IronPPT.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les invites ci-dessus ont été envoyées à Codex dans l'ordre, en une seule session. Le travail hérité, son journal et son deck ont été ajoutés avant l'invite de débogage. Des scripts séparés ont rouvert chaque deck enregistré par la session et ont lu chaque diapositive du fichier.
- Avant la session, le modèle contenait huit diapositives, toutes affichées.
- Avec la variable effacée, l'enregistrement a lancé l'exception de licence, et le fichier de sortie n'existait pas ensuite.
- Avec la variable définie et l'appel de démarrage omis, l'enregistrement a échoué de la même manière.
- Dans la sonde, Slides.RemoveAt(4) a laissé les huit diapositives dans le fichier enregistré.
- Clone() sur la diapositive région a lancé une MissingMethodException.
- Codex a démarré trois sous-agents, et l'invite de débogage a réutilisé l'agent explorateur de l'invite de sonde.
- Le deck enregistré de la semaine 41 contenait 11 diapositives dans l'ordre du README, avec les cinq diapositives de région dans l'ordre CSV.
- Dix diapositives étaient affichées, et l'annexe a été enregistrée comme cachée.
- Le récapitulatif de la promotion du T2 était absent du deck.
- L'Est a gardé sa diapositive avec un revenu de 0 $.
- Le modèle v2 refusé a laissé le hachage SHA-256 du deck existant inchangé.
- Codex a fait correspondre la capture d'écran aux chiffres de l'Ouest de la semaine 40.
- Le diagnostic a lié chacun des quatre problèmes de la semaine 40 à ses lignes dans le travail hérité.
- Le diagnostic a tracé la diapositive nord cachée jusqu'à la diapositive de région réutilisée que Slides.Last() a retournée.
- Un deck construit avec DeckService a correspondu à la première construction sur chaque diapositive.
- Tous les cinq tests ont réussi dans la session de Codex et dans la nôtre.
- Certaines étapes ont été exécutées différemment de la page. Les packages NuGet venaient d'un cache restauré avant la session, car le bac à sable n'avait pas de réseau.
Le guide GitHub Copilot mesure un échec similaire pour les images, où l'appel Replace du guide de gestion d'image laisse l'ancienne photo dans un deck chargé. Le guide Google Antigravity génère des decks pour des requêtes web simultanées, qu'IronPPT a correctement servies seulement lorsqu'un seul verrou protégeait chaque appel à IronPPT. Le record commun de session fournit la version Codex, le modèle, le calendrier et la machine de test.
Dépannage
- Comment gérer les diapositives pour masquer une diapositive avec
Showet la garder dans le fichier - Élément de diapositive pour définir un style de texte sur un nouveau texte au lieu de le copier à partir d'un deck chargé
- Appliquer les clés de licence si chaque enregistrement échoue avec Production License Required
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.