Glossaries not working with Azure Translator

Question

Hi,

I am using Azure Translate service for my Bot that translates Customer query to English for the Agent and English to detected language for the Customer. There are certain words whose meaning needs to be preserved. To achieve that I have uploaded my glossary file (TSV) in Azure Blob Storage and appending the Glossary URL. The below URL is not taking or referring my glossary file. Glossary URL: https://<<blob storage name>>.blob.core.windows.net/<<containername>>/<<filename.tsv>>?<<SaSToken>

Endpoint: https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=<<Fromlanguage>>&to=<<target language>>

**Body **: [ { "text":"<<User query with glossary words>>", "customization":{ "glossaries":[ { "format":"tsv", "url":"<<Glossary URL>>" } ] } } ]

In Headers passing the Keys.

Answer 1

Hello Vandanaa !

Thank you for posting on Microsoft Learn Q&A.

The glossary URL you’re passing is being ignored because the translate API doesn’t accept a glossaries file in the request body.

TSV glossaries are only supported by the document translation API and for real time text calls you have 2 options:

• use the dynamic dictionary markup inline
• deploy a Custom Translator model and pass its category id

https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries

If you need real time chat translation (you can keep using POST and remove the customization.glossaries block and it’s not a supported field for this endpoint.

You can use dynamic dictionary markup for the terms you must preserve, and you must specify from= or, if the terms list is large and stable, you can train a custom translator model and pass &category=<your-custom-model-id> on the query string.