Wie Sie IronPPT mit ChatGPT Codex verwenden

Curtis Chau
Curtis Chau
Aktualisiert: 19. Oktober 2026

Ein Vertriebsteam sendet jeden Montag dasselbe Deck. Eine Vorlage liefert die Folien und die wöchentlichen Zahlen füllen sie aus. Die einzelfolien regionale Folie wird zu einer Folie pro Region, eine veraltete Promotionsfolie wird entfernt, und der Anhang bleibt in der Datei, aber außerhalb der Präsentation. Wenn eine Folienoperation still scheitert, wird das Deck dennoch gespeichert und das Jobprotokoll meldet weiterhin Erfolg. Die Regionalleiter erhalten einen Rückblick auf eine am 30. Juni endende Promotion, eine Folie vor den Highlights dieser Woche.

ChatGPT Codex ist der Codierungsagent von OpenAI. Es funktioniert in einem Repository, wo es Dateien bearbeitet, Befehle wie dotnet run ausführt und berichtet, was es geändert hat. Der gleiche Agent läuft in einem Terminal, einer IDE-Erweiterung, der ChatGPT-Desktop-App und der Cloud. IronPPT, Iron Software's .NET-Bibliothek für PowerPoint, erstellt, öffnet, bearbeitet und speichert .pptx-Dateien ohne Microsoft Office.

Codex erhält eine wöchentliche Vertriebsvorlage, eine Regeldatei und zwei Wochen Regionaldaten. Jede gemeldete Folienanzahl stammt aus einem im selben Schritt geschriebenen CSV, und jede Folienoperation wird an einem gespeicherten Deck getestet, bevor der Batch-Code darauf basiert.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronPPT

Installieren Sie IronPPT, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Starten Sie Codex in einem .NET 9-Konsolenprojekt, das die Ordner Templates und Data enthält.

$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.
Text

Die Erwähnung von $ironppt lädt IronPPTs Fähigkeit, bevor Codex Code schreibt.



Was ist ChatGPT Codex und wie passt es in .NET-Präsentationsarbeiten?

Der Befehl /permissions legt fest, wann Codex Dateien bearbeitet oder Befehle ausführt, ohne zuerst nachzufragen. Die Codex CLI-Dokumentation behandelt die Installation und die Nutzung im Terminal, und das Open-Source-Repository veröffentlicht seine Versionen.

Codex' Wissen über IronPPT stammt aus seinen Trainingsdaten und den ihm gegebenen Dateien. Ein Mitgliedsname, den IronPPT nicht hat, führt zu einem Build-Fehler.

IronPPT wird mit einer .NET Standard 2.0-Assembly ausgeliefert, und sein NuGet-Paket listet Windows, Linux und macOS. Der Testlauf baute das Projekt auf Windows.

Wie schreibt man ein IronPPT-Eingabeskript und richtet Codex dafür ein?

Die unten stehenden Eingaben nennen die Vorlage und die Daten (Templates/weekly-sales-template.pptx und Data/week-41.csv) sowie die Regeln (Data/README.md, die die Reihenfolge, die weggelassenen und die versteckten Folien sowie den Stil beschreibt).

Codex durchsucht .agents/skills in jedem Ordner vom Arbeitsverzeichnis bis zum Repository-Stamm. Jede Fähigkeit ist ein Ordner, der ein SKILL.md enthält, dessen Kopf ein Name und eine Beschreibung festlegt. Das Speichern von IronPPTs skill.md als .agents/skills/IronPPT/SKILL.md ermöglicht es, die Erwähnung $ironppt aufzulösen. Die Fähigkeit erklärt, dass sie gegen IronPPT 2026.8.1 geprüft wurde, während dieser Leitfaden 2026.10.1 installiert.

Codex liest AGENTS.md, bevor es irgendwelche Arbeiten beginnt. Es geht vom Repository-Stamm einen Ordner nach dem anderen entlang und nimmt höchstens eine Datei pro Verzeichnis, wobei die tiefere Datei die flachere überschreibt. Der Befehl /init generiert einen ersten Entwurf.

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.
Text

Wie bittet man Codex, IronPPT hinzuzufügen und die Lizenz zu überprüfen?

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.
Text

IronPPT 2026.10.1 hängt von IronSoftware.Common 2026.4.2 und IronSoftware.System.Drawing 2026.8.2 ab, und die Paketliste des Testlaufs zeigte 30 transitive Pakete, darunter SixLabors.ImageSharp 3.1.12 und Grpc.Net.Client 2.62.0. Überprüfen Sie das IronPPT-Changelog, bevor Sie eine Version festlegen.

Ohne Schlüssel öffnet IronPPT ein Deck, liest seinen Text, fügt Folien und Text hinzu und verbirgt Folien. Nur Save schlägt fehl, mit einer Lizenzierungsausnahme, deren Nachricht lautet: Production License Required, und es wird keine Datei geschrieben. IronPPT liest selbstständig einen Schlüssel aus der IronPPT.LicenseKey oder IRONPPT_LICENSEKEY Umgebungsvariable, ignoriert jedoch IRONPPT_LICENSE_KEY. Code, der den Schlüssel unter diesem Namen hält, weist License.LicenseKey vor dem ersten Speichern zu. Der Lizenzierungsausnahmetyp ist in IronPPT 2026.10.1 nicht öffentlich, daher fängt ein Behandler Exception ab und überprüft den Typnamen.

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.
Text

Die Seite für Lizenzschlüssel listet die anderen Möglichkeiten zur Bereitstellung eines Schlüssels auf.

Warum hinterlässt der Foliencode des Leitfadens das Deck unverändert?

Der Leitfaden zur Folienverwaltung entfernt eine Folie mit Slides.RemoveAt und bewegt eine mit Slides.Remove gefolgt von Slides.Insert, und die IronPPT-Fähigkeit beschreibt Slides als veränderliche Liste. In IronPPT 2026.10.1 gibt PresentationDocument.Slides jedes Mal, wenn es gelesen wird, eine neue Liste zurück, und diese Aufrufe ändern nur diese Kopie. Bei der Kalibrierung ließ Slides.RemoveAt(0) auf einem geladenen Sechs-Folien-Deck die Anzahl bei sechs, und ein Deck, das nach einer Bewegung gespeichert wurde, behielt seine ursprüngliche Reihenfolge bei. Der Code kompiliert, löst keine Ausnahme aus und speichert die Folie, die entfernt werden sollte.

Drei Operationen auf einer bestehenden Folie erreichen das Deck. Ein Aufruf von Remove() auf der Folie selbst entfernt sie aus der gespeicherten Datei, und Show = false schreibt eine versteckte Folie, die in der Datei bleibt. Das Setzen von Slide.Index bewegt die Folie, und eine separate Untersuchung öffnete das gespeicherte Deck in der neuen Reihenfolge.

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.
Text

Ein Abgleich mit dem bearbeiteten Listenobjekt besteht, weil diese Kopie tatsächlich geändert wurde.

Wie erstellt man das wöchentliche Deck aus der Vorlage?

Der Leitfaden zur Folienverwaltung behandelt nicht das Duplizieren einer Folie. In IronPPT 2026.10.1 wirft Clone() auf einer Folie eine MissingMethodException, und das zweimalige Hinzufügen desselben Folienobjekts lässt keine weitere Folie in der gespeicherten Datei. Das Entfernen einer Folie und das erneute Hinzufügen am Ende hinterließ eine leere Folie an ihrer alten Position. Die Methode, die funktioniert, fügt jedem Ausgabefolie einen neuen Slide hinzu, füllt ihn mit neuem Text in der vom Deck benötigten Reihenfolge und ruft dann Remove() auf den Vorlageoriginalen auf.

Das Kopieren von Stil aus einem geladenen Deck schlägt ebenfalls fehl. Bei der Kalibrierung wurde eine 36-pt-Überschrift, die Eigenschaft für Eigenschaft kopiert wurde, bei 3.600 pt geschrieben, und ihre Farbe #1F4E79 wurde schwarz. Daher setzt der Eingabetext den Stil laut README auf jeden Text ein.

Die Vorlage folgt der Folienliste im README, mit Q2 Promotion Recap an fünfter Stelle und Highlights an sechster.

Download weekly-sales-template.pptx

Die wöchentliche Vertriebsvorlage, die im Testlauf verwendet wurde, mit einer regionalen Folie, die die regionalen Token enthält.

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.
Text

Wie überprüft man das von Codex gespeicherte Deck?

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.
Text

Ausgabe

DeckAssembler speicherte das untenstehende Deck für Woche 41 im Testlauf, und es wird unverändert veröffentlicht.

Download week-41.pptx

Das Woche 41-Deck, wie es von IronPPT gespeichert wurde.

Was passiert, wenn sich die Vorlage ändert?

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.
Text

Wie überprüft man eine Folie von einem Screenshot?

Codex akzeptiert Bilder als Kontext. Übergeben Sie eins mit dem -i Schalter (Langform --image), wenn Sie eine Sitzung starten oder fortsetzen, oder fügen Sie es in den interaktiven Composer ein.

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.
Text

Wie debuggt man das fehlerhafte Deck-End-to-End?

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.
Text

Überprüfen Sie die Diagnose, bevor Sie Änderungen zulassen. Der Legacy-Job schrieb jede Protokollzeile nach einer Rückkehr des Aufrufs und öffnete das Deck nie erneut.

Wie wandeln Sie einmalige Codes in wiederverwendbare, getestete Komponenten um?

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.
Text

Ein Refactoring kann die Überschriftenprüfung fallen lassen und trotzdem kompilieren.

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.
Text

Für API-Fragen dokumentiert das installierte IronPPT.xml Folienmitglieder wie AddSlide, Remove, Clone, Index und Show. Die Probenergebnisse zeigen, welche von ihnen ein gespeichertes Deck erreichen.

$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.
Text

Wie verwendet man diese Eingaben auf einem anderen Deck erneut?

Mit geänderter Vorlage, Datenfiles und README-Regeln gelten dieselben Eingaben für Vorstandsunterlagen, Projektstatus-Decks oder Kundenbewertungen. Für Setups, die für jeden Assistenten gelten, lesen Sie den IronPPT AI-Coding-Assistentenleitfaden.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die obigen Eingaben wurden in einer Sitzung der Reihe nach an Codex gesendet. Der Legacy-Job, sein Protokoll und sein Deck wurden vor dem Debugging-Aufruf hinzugefügt. Separate Skripte öffneten jedes von Lauf gespeicherte Deck erneut und lasen jede Folie aus der Datei.

  • Vor dem Lauf hielt die Vorlage acht Folien, alle wurden angezeigt.
  • Mit gelöschter Variablen warf das Speichern die Lizenzierungsausnahme, und die Ausgabedatei existierte danach nicht.
  • Mit gesetzter Variablen und übersprungenem Startaufruf scheiterte das Speichern auf dieselbe Weise.
  • In der Untersuchung ließ Slides.RemoveAt(4) alle acht Folien in der gespeicherten Datei.
  • Clone() auf der Regionsfolie warf eine MissingMethodException.
  • Codex startete drei Subagenten, und der Debugging-Aufruf wiederverwendete den Erkundungsagenten vom Probe-Aufruf.
  • Das gespeicherte Woche 41 Deck enthielt 11 Folien in README-Reihenfolge, mit den fünf regionalen Folien in CSV-Reihenfolge.
  • Zehn Folien wurden angezeigt, und der Anhang war als versteckt gespeichert.
  • Q2 Promotion Recap fehlte im Deck.
  • Ost behielt seine Folie mit einem Umsatz von 0 $.
  • Die abgelehnte v2-Vorlage ließ den SHA-256-Hash des vorhandenen Decks unverändert.
  • Codex passte den Screenshot den Woche 40 West-Zahlen an.
  • Die Diagnose verband jedes der vier Woche 40 Probleme mit seinen Zeilen im Legacy-Job.
  • Die Diagnose verfolgte die versteckte Nordfolie zu der wiederverwendeten regionalen Folie, die Slides.Last() zurückgab.
  • Ein mit DeckService erstelltes Deck entsprach dem ersten Build auf jeder Folie.
  • Alle fünf Tests bestanden in Codex' Lauf und in unserem.
  • Einige Schritte liefen anders als die Seite. NuGet-Pakete kamen aus einem Cache, der vor dem Lauf wiederhergestellt wurde, da die Sandbox kein Netzwerk hatte.

Der GitHub Copilot-Leitfaden misst ein ähnliches Versagen bei Bildern, wo der Replace-Aufruf aus der Bildverwaltungsanleitung das alte Foto in einem geladenen Deck belässt. Der Google Antigravity-Leitfaden erstellt Decks für gleichzeitige Webanfragen, die IronPPT nur korrekt bedient, wenn ein einzelner Sperre jede IronPPT-Aufruf schützt. Das gemeinsame Laufprotokoll gibt die Codex-Version, das Modell, die Zeit und die Testmaschine an.


Fehlerbehebung

  • Wie Folien verwalten, um eine Folie mit Show zu verstecken und sie in der Datei zu halten
  • Folienelement, um einen Textstil auf neuen Text anzuwenden, anstatt ihn aus einem geladenen Deck zu kopieren.
  • Lizenzschlüssel anwenden, falls jedes Speichern mit Production License Required fehlschlägt

Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 7,110Version:2026.11gerade veröffentlicht