Como usar o IronWord com o ChatGPT Codex

Curtis Chau
Curtis Chau
Atualizado: 19 de outubro de 2026

Quando uma empresa muda seu nome, a equipe jurídica recebe uma pasta de contratos assinados para atualizar. O nome antigo é encontrado em parágrafos do corpo, tabelas de partes, títulos em maiúsculas e cabeçalhos de página. O Word também pode armazenar o nome em várias execuções de formatação, por exemplo, quando um fragmento foi colocado em negrito anos atrás. Uma busca e substituição padrão em cada arquivo corrige apenas alguns casos, enquanto outros permanecem inalterados sem alerta.

O ChatGPT Codex é o agente de codificação da OpenAI. Dentro de um repositório, ele edita arquivos, executa comandos como dotnet run, depois resume as mudanças. Um agente serve o terminal, IDEs, o aplicativo de desktop do ChatGPT e tarefas em nuvem. IronWord, uma biblioteca .NET da Iron Software, abre documentos Word existentes como um modelo de objeto de parágrafos, execuções e tabelas que o código pode editar e salvar sem o Microsoft Office.

Codex trabalha em um acúmulo de contratos com um manifesto de base. Os prompts em lote escrevem um CSV com uma linha por contrato, então cada contagem relatada por Codex é respaldada por um arquivo.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronWord

Instale o IronWord executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Inicie o Codex em um projeto de console .NET que contenha a pasta de contratos e solicite um inventário antes de qualquer edição.

$ironword Add the IronWord 2026.10.4 NuGet package to this console project.
Then have Program.cs open every .docx in Contracts/sample/ without changing it.

For each file, write one row to out/quickstart.csv with these columns:

- file
- body count, how often "Northwind Traders" appears in the body text
- table count, the same name counted separately in every table cell
- the exception type, when the file fails to open

Print the totals by reading that CSV back.
Program.cs reads the key from IRONWORD_LICENSE_KEY itself.
Don't print the key's value, and don't list environment variables.
Nothing gets saved here, so an unset key is no reason to stop.
Build and run it with at most three repair attempts, then tell me the result.
Text


O que é ChatGPT Codex, e como ele se encaixa no trabalho de documentos Word .NET?

As etapas de instalação estão na documentação do Codex CLI, e os lançamentos são publicados no repositório de código aberto.

Codex conhece o IronWord a partir de dados de treinamento e arquivos fornecidos, e um novo lançamento pode tornar ambos desatualizados. Os lançamentos de 2026.10 carregam e salvam por meio de streams e chamadas assíncronas.

Como você escreve um prompt do IronWord e configura o Codex para ele?

Um prompt em lote eficaz nomeia a entrada, cada localização do nome, a saída, a prova, a base de verdade somente leitura e as restrições.

O artigo da OpenAI sobre por que modelos de linguagem alucinam rastreia respostas erradas confiantes para treinamento e avaliação que recompensam palpites, e em um trabalho de renomeação o palpite é que todo contrato está limpo.

Codex procura habilidades em .agents/skills em cada diretório entre o diretório de trabalho e a raiz do repositório. Salva como .agents/skills/IronWord/SKILL.md, a skill.md do IronWord resolve a menção $ironword.

Antes de qualquer trabalho, Codex lê no máximo um AGENTS.md em cada diretório no caminho entre a raiz do repositório e a pasta de trabalho. O arquivo mais próximo da pasta de trabalho tem precedência. O comando /init esboça um AGENTS.md inicial.

Give this repository a top-level AGENTS.md with a Contract rebrand section.
List these rules in it:

- No DOCX library other than IronWord is allowed.
- IronWord's package is IronWord, and its namespaces are IronWord and IronWord.Models.
- The ironword skill in .agents/skills/ironword/ is one API reference.
- https://ironsoftware.com/word/csharp/llms.txt is the other.
- Contracts/inbox/ and Contracts/manifest.csv are read-only.
- Rebranded copies go to out/rebranded/ under their original names.
- IRONWORD_LICENSE_KEY holds the key, and its value never appears in output, logs or files.
- Checking the variable means its presence and length, nothing more.
- Any count you report is read from a CSV written in the same turn.
- The reply names that CSV.
Text

Como você pede ao Codex para adicionar IronWord e verificar a licença?

Print the IronWord PackageReference from ContractRebrand.csproj and the version restore resolved.
Then quote every IronSoftware entry that dotnet list package --include-transitive prints.
Leave the package references exactly as they are.
Text

O IronWord 2026.10.4 referencia IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 e IronSoftware.System.Drawing 2026.11.3. Restaure também IronSoftware.Drawing.Abstractions 2026.1.2 listados. A compilação copia bibliotecas nativas LayoutEngineInterop para Windows, Linux e macOS em uma pasta de tempos de execução. A página de conflito do OpenXML cobre um conflito com um DocumentFormat.OpenXml mais novo em versões antes de 2025.7.13. Verifique o changelog do IronWord antes de fixar.

Sem uma chave, abrir, ler e substituir têm sucesso, mas toda sobrecarga de salvamento, incluindo as assíncronas, lança uma LicensingException com a mensagem Licença de Produção Necessária.

Add Startup.ApplyIronWordKey and call it first in Program.cs.
It copies the IRONWORD_LICENSE_KEY value into IronWord.License.LicenseKey.
It also reports whether License.IsLicensed is true.

Add a --dry-run switch that opens and edits in memory and never saves.
Then run the sample twice with the variable removed:

1. Run it once with --dry-run.
2. Run it once copying each file to out/licence-check/ through SaveAs.

Clear the variable inside each child process only, never for the session.
Write out/licence-check.csv with the columns run, file, call, exception type name and message.
Tell me which calls threw.
The licensing exception type isn't public, so catch Exception and record its GetType().FullName.
Stop after three repair attempts.
Text

A página de chaves de licença também cobre o Web.config, App.config e appsettings.json.

Quais partes de um documento Word uma substituição de texto alcança?

Create Services/MentionScanner.cs.
For one DOCX it returns a count for each of these:

- "Northwind Traders" in body paragraphs
- "Northwind Traders" in table cells
- the name in upper case
- the name inside "Northwind Traders Pension Trust"
- the name in headers and footers
- the old notice address
- the Fax notices paragraph

The body and table cell counts leave out the pension trust name.
IronWord has no header or footer model.
For that column only, read word/header*.xml and word/footer*.xml with System.IO.Compression.

Then run it over Contracts/inbox/ into out/inventory.csv.
Mark files that fail to open as Unreadable.
List every file whose counts differ from manifest.csv.
In that comparison, the body count is body_mentions plus split_run_mentions.
Text

O agente explorador embutido testa a substituição em arquivos reais.

Create a scratch console project under scratch/replace-probe/ yourself.
Add a Compile Remove line for scratch/** to ContractRebrand.csproj.

Then ask the explorer agent to use that project.
It finds which parts of a contract the document-level ReplaceText call changes.
It tests copies of the Contracts/sample/ files in memory, with these four cases:

- a name split across runs
- a table cell
- the upper-case title
- the pension trust

The header has no object in the API, so the explorer answers that one from IronWord.xml.
It changes nothing under Services/ or in Program.cs.

Write the five answers to out/replace-reach.csv.
Beside each answer, quote the ironword skill or IronWord documentation.
Where a page and the test disagree, say so.
Text

A calibração em 2026.10.4 deu estes resultados em memória.

LocalizaçãoSubstituir no nível do documentoO que o alcança
Corpo, uma execuçãoSubstituídoA chamada do documento
Corpo, dividido em execuçõesSubstituídoA chamada do documento
Célula de tabelaInalteradoReplaceText em cada TableCell
Título em maiúsculasInalterado (correspondência sensível a maiúsculas e minúsculas)Uma segunda chamada com a forma em maiúsculas
Nome de confiança de pensãoRenomeado (correspondência de substring simples)Um espaço reservado substituído primeiro e restaurado depois
Cabeçalho ou rodapéNão no modelo de objetoReporte-o, então edite manualmente

A linha de execução dividida tem um efeito colateral. Um nome armazenado como um Norte em negrito seguido por um Traders vento simples torna-se uma execução em negrito que lê Contoso Ltd.

Uma verificação baseada no ExtractText do documento, que retorna apenas parágrafos do corpo, passa um contrato cuja tabela de partes ainda nomeia a empresa antiga. FindText falta uma correspondência de execução dividida, pois corresponde apenas a um elemento de texto que contém toda a frase.

Como você substitui texto em uma pasta de documentos?

Have the worker agent write Services/Rebrander.cs.
It applies every rule in Contracts/README.md to Contracts/inbox/.
It builds on the explorer's findings and follows these rules:

- Replace inside each table cell as well as the body.
- Keep the pension trust intact.
- Delete the Fax notices paragraph.
- Leave header and footer parts as they are, since IronWord can't edit them.
- Report those contracts as HeaderFlagged.
- Save each copy to out/rebranded/ with SaveAs.
- Never call Save() on a document opened from inbox/.

Add a --sequential mode that rescans the saved copies with MentionScanner.
It writes out/sequential.csv with these columns:

- file
- status from the README, always one of its four
- mentions left per location
- milliseconds
- header_lost, set to yes when a copy lacks a header or footer part its original had

The header_lost column is reported on its own and never changes a status.
Tell me the status counts.
Text

No IronWord 2026.10.4, salvar um DOCX carregado com uma tabela descarta todas as edições de texto dentro da tabela e em qualquer parágrafo após a primeira tabela. A cópia no disco mantém o texto antigo, nenhuma exceção é levantada, e o documento em memória ainda mostra a substituição. Edições antes da primeira tabela persistem, assim como uma célula substituída por um novo TableCell. Esses contratos colocam a assinatura após a tabela de partes, então uma verificação em memória passa cópias cuja assinatura salva nunca mudou.

O Save sem parâmetros está documentado para sobrescrever o arquivo de origem de um documento carregado, então um lote não deve chamá-lo. O guia de remoção de texto mostra a remoção de parágrafos atrás da regra de fax.

Na calibração, carregar um arquivo de zero bytes lançou NullReferenceException, e um arquivo de texto, um pacote truncado e um pacote de bytes aleatórios cada um lançou uma FileFormatException de um namespace ofuscado com a mensagem O arquivo contém dados corrompidos. Um catch para o tipo System.IO o perde. Capture Exception por arquivo e registre seu tipo.

As cópias usam SaveAs, que a página de solução de problemas do IronWord nomeia para um cabeçalho que desaparece após salvar.

Check whether SaveAs lost a header anywhere in this backlog.
IronWord's troubleshooting page header-disappears-after-saveas reports that in one environment.

For every HeaderFlagged file, compare the inbox original with its out/rebranded/ copy.
Look at the word/header*.xml and word/footer*.xml parts.
Write out/header-check.csv with these columns:

- file
- header parts before
- header parts after
- whether each part is present with its text unchanged

If a part went missing, rebrand that contract again from its inbox original.
Write it with the Save overload that takes the out/rebranded/ path.
Don't use the parameterless Save().
If the part is still missing, record it and stop.
Tell me which files lost a part.
Text

Como você processa uma pasta de documentos em paralelo?

As chamadas assíncronas fazem entrada/saída de arquivo sem bloquear, mas a documentação afirma que a análise e serialização permanecem síncronas e que uma instância de documento não é segura para threads.

Add a --parallel mode that works like this:

- It runs Task.WhenAll over the inbox.
- Each task holds a slot of a SemaphoreSlim whose size comes from --concurrency.
- Then it awaits WordDocument.LoadAsync and SaveAsAsync on its own WordDocument.

Run the mode three times:

1. At concurrency 1 into out/parallel-c1/.
2. At concurrency 4 into out/parallel-c4/.
3. At Environment.ProcessorCount into out/parallel-max/.

Write out/parallel-compare.csv with the columns file, folder and a yes or no.
The yes or no says whether the extracted body and cell text match out/rebranded/.
Log each run as a new line of out/runs.csv.
Give it the mode, concurrency, elapsed seconds and match count from out/parallel-compare.csv.
Tell me the quickest setting in runs.csv.
Text

Na calibração, abrir e editar a caixa de entrada na memória, incluindo quatro arquivos ilegíveis, levou 4,8 segundos sequencialmente, 1,4 em um limite de 4 e 1,8 em 16, e com SaveAsAsync adicionou 14,4, 5,5 e 4,7 segundos. O salvamento é o passo limitante.

Como você diagnostica um documento que ainda mostra texto antigo?

Codex aceita imagens através da flag -i (--image) em uma nova sessão ou com codex exec resume, ou como uma colagem no compositor.

I attached the first page of out/rebranded/MSA-1050.docx as an image with -i.
Its header still names Northwind Traders.
Look at the image, then explain from the file itself why the batch left that text.
Tell me whether out/sequential.csv already flags this file.
Don't change any code.
Text

Uma resposta correta nomeia a parte do cabeçalho e a linha HeaderFlagged do arquivo.

Como você depura a saída incorreta de lotes de ponta a ponta?

Find out why the nightly job passed contracts that legal later flagged.
The log reports 0 contracts still naming Northwind Traders.
Contracts/legal-review.csv lists contracts where legal still found the old name.
It was in the party table or an upper-case title.
The file also lists a pension trust that was renamed.

Send the explorer agent through Jobs/NightlyRebrand.cs and Logs/nightly-2026-10-07/ first.
Then write your own report in out/nightly-diagnosis.md with these parts:

- why the job's own check passed them
- the smallest fix
- the command that proves the fix

Don't run or edit any code.
Text

O diagnóstico deve citar a linha onde o trabalho marca um contrato como limpo.

Como transformar código único em componentes reutilizáveis e testados?

Put the worker agent on a RebrandJob class, built like this:

- Install the Microsoft.Extensions.DependencyInjection package.
- Have its container resolve RebrandJob.
- Set it up through a RebrandOptions record with inbox, output folder, concurrency and dry run.
- Keep every README rule, the header check and the per-file CSV.
- RebrandJob.cs stays under 180 lines, with XML doc comments.

The README rules cover body and cell replacement, upper case and the pension trust guard.
They also cover the address and the fax deletion.
Run the job over the whole inbox into out/final/ and out/final.csv.
Then tell me whether every status matches manifest.csv.
Also confirm no copy keeps an old name, old address or fax paragraph.
Old names in a copy's header or in the pension trust don't count.
Text

Um refatoramento pode remover uma regra e ainda compilar.

Add an xUnit project at tests/ContractRebrand.Tests.
Exclude it from the main project's compile items, and join both projects in a solution file.

Write tests on real inbox files that check these:

- a split-run contract comes back with no old name
- a table contract is clean in its cells
- a pension trust mention survives
- a header contract is HeaderFlagged
- the zero-byte file is Unreadable without stopping the batch
- 20 files rebranded in parallel equal their sequential copies

Assert on extracted text and statuses, never on DOCX bytes.
Keep test copies in out/tests/work/.
Run dotnet test on the solution with a trx logger into out/tests/.
Report the totals from the trx file.
Text

A documentação de prompts personalizados da OpenAI descontinua prompts salvos em ~/.codex/prompts em favor de habilidades, onde perguntas recorrentes pertencem.

$ironword Look in the installed IronWord.xml.
List the WordDocument members that load or save a document, and answer these:

- Which ones are asynchronous?
- Which one overwrites the source file a document was loaded from?

List only members you can call from a line that compiles in a probe under scratch/.
Also name any member anywhere in IronWord.xml that is documented but doesn't compile.
Check by compiling only.
Don't run Save() on any document loaded from Contracts/inbox/.
Then show the line in RebrandJob that keeps Contracts/inbox/ untouched.
Text

Como você reutiliza esses prompts em outro acúmulo de documentos?

Com nomes, caminhos e regras alterados, esses prompts se encaixam no próximo acúmulo, e o guia de assistentes de codificação IA do IronWord cobre a configuração para todos os cinco assistentes.

O que os prompts produziram em uma execução real?

Os prompts foram executados em ordem em uma sessão Codex. O projeto .NET 9 continha 124 contratos e um manifesto de status e contagens esperadas, e cada build de liberação foi bem-sucedido. Nosso scanner recaneou cada cópia salva, e os testes foram rerun em um clone novo.

  • Antes da renomeação, o inventário correspondia ao manifesto em todos os 124 arquivos e marcou os 4 arquivos não-DOCX como Ilegíveis.
  • Após a rebranding sequencial, as 120 cópias salvas não tinham nenhum dos 114 nomes antigos acima da tabela de partes, incluindo os 22 divididos em execuções.
  • Nenhum dos 13 títulos em maiúsculas, 38 endereços antigos de aviso ou 57 parágrafos de fax permaneceram.
  • Todos os 9 nomes de confiança de pensão permaneceram intactos.
  • O nome antigo permaneceu em 28 tabelas de partes e 114 assinaturas, porque o salvamento descartou essas edições.
  • O csv do trabalhador sequencial deu a cada arquivo o status do manifesto, Rebranded 104, HeaderFlagged 10, NoChange 6 e Unreadable 4, mas suas próprias colunas de contagem ainda mostravam as 114 menções de assinatura e 28 de tabela. Os status registram a detecção, não a substituição, como o próprio Codex relatou.
  • Nos 10 arquivos de amostra, o quickstart relatou 19 menções de corpo e 2 de tabela, contra 16 e 2 no manifesto. Sua contagem de corpo também considerou as 2 menções de célula e o nome de confiança de pensão.
  • Sem a chave, a execução a seco editou todos os 9 arquivos de amostra legíveis na memória. A execução de salvamento lançou LicensingException em SaveAs para cada um deles.
  • Com limites de 1, 4 e 32, as execuções paralelas levaram 11.456, 7.825 e 5.830 segundos. Todas as 120 cópias legíveis em cada pasta combinaram com as sequenciais.
  • O diagnóstico noturno rastreou as descobertas para a verificação case-sensitive ExtractText().Contains do trabalho e sua substituição no nível do documento. Ele não citou números de linha, e seu comando de prova visava um projeto de teste que ainda não existia.
  • O refatoramento manteve todas as regras em um RebrandJob.cs de 68 linhas, e suas cópias out/final combinavam com out/rebranded.
  • O final.csv correspondia aos status do manifesto, mas marcou 118 linhas como incompletas, e o Codex relatou a verificação de conteúdo como falhada.
  • A execução do Codex e o clone novo passaram 4 dos 6 testes. O teste de execução dividida falhou na assinatura e o teste de tabela em uma célula de tabela de partes.
  • A resposta da API listou quatro membros de carregamento, sete de salvamento e cinco assíncronos, e nomeou o Save sem parâmetros como aquele que sobrescreve o arquivo de origem.
  • Ele nomeou corretamente quatro membros documentados que não compilam. Estes eram o construtor que aceita bytes e uma string, FlushModelToBytes, ReplaceTextAcrossRuns em um parágrafo e SetNoChangeStatusAsUpdated.
  • Ele também listou o construtor somente bytes, que compila, e perdeu outros cinco que falham em 2026.10.4, FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes e ApplyCellStyle em uma tabela.
  • Alguns passos foram executados de forma diferente da página. A imagem foi renderizada com python-docx a partir da cópia MSA-1050 da execução. O trabalho noturno, seu log e o arquivo de revisão jurídica foram adicionados imediatamente antes do prompt de investigação.

O guia do GitHub Copilot testa uma declaração salva lendo sua tabela por meio de Tabelas, Linhas e Células. O guia do Cursor lista as partes de um DOCX que o IronWord não lê.

O registro de execução compartilhado lista a versão do Codex, modelo, máquina e tempo para esta execução.


Solução de problemas


Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 62,392Versão:2026.11recém-lançado