Enforcing Terminology and Glossaries
How to provide a terminology list so the agent uses consistent, approved translations for key terms.
Product names, feature names, and other fixed terms should be translated consistently every time they appear.
Providing a Terminology List
If you already know which terms require a fixed translation, list them in a file and tell the agent to use that file in agent-instructions.md. The agent can read a terminology file in any format, including one exported from an existing terminology tool, as long as agent-instructions.md explains how to read it. Include a representative snippet of the file in your instructions so the agent knows what to expect.
To reduce costs, the agent reads only the line ranges it needs instead of the entire file, so keep each entry on a separate line.
For example, you can add instructions like these to
agent-instructions.md, including a snippet of your TBX
(TermBase eXchange) terminology file:
When you need to translate a term, search in [the terms file](./terms.tbx)
and use the canonical translation found there instead of re-translating.
The file has entries with this format:
<termEntry id="review-task">
<langSet xml:lang="en"><tig><term>review task</term></tig></langSet>
<langSet xml:lang="fr-FR"><tig><term>tâche de révision</term></tig></langSet>
<langSet xml:lang="de-DE"><tig><term>Prüfaufgabe</term></tig></langSet>
</termEntry>
Use your grep tool to search it.
Letting the Agent Build the List
If you want the agent to also update the terms file, or create it if you do not already have one, you can add instructions like these to agent-instructions.md:
Whenever you translate a topic, identify terms
(product names, feature names, UI labels) and record them, together with
the translation you used, in [the terms file](./terms.tbx).
Over time, this creates a project-specific glossary without requiring you to prepare one in advance. Review the terminology file after each translation task and correct any entries the agent got wrong. The agent will use those corrected entries in future translation tasks.