Definire traduzioni personalizzate

Completato

Anche se il modello di traduzione predefinito usato da Azure AI Translator è efficace per la traduzione generale, potrebbe essere necessario sviluppare una soluzione di traduzione per aziende o settori in cui sono presenti vocabolari specifici di termini che richiedono una traduzione personalizzata.

Per risolvere questo problema, è possibile creare un modello personalizzato che esegue il mapping di set personalizzati di termini di origine e di destinazione per la traduzione. Per creare un modello personalizzato, usare il portale di Custom Translator per:

1. Creare un'area di lavoro collegata alla risorsa di Azure AI Translator.
2. Creare un progetto.
3. Caricare i file di dati di training e eseguire il training di un modello.
4. Testare il modello e pubblicare il modello.
5. Effettuare chiamate di traduzione all'API.

Al modello personalizzato viene assegnato un ID categoria univoco (evidenziato nello screenshot), che è possibile specificare in tradurre chiamate alla risorsa di Azure AI Translator usando il parametro categoria, causando l'esecuzione della traduzione da parte del modello personalizzato invece del modello predefinito.

Come chiamare l'API

Per avviare una traduzione, inviare una richiesta di POST all'URL della richiesta seguente:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

La richiesta deve includere un paio di parametri:

• api-version: versione richiesta dell'API.
• to: lingua di destinazione in cui tradurre. Ad esempio: to=fr per il francese.
• category: ID categoria .

La richiesta deve includere anche una serie di intestazioni obbligatorie:

• Ocp-Apim-Subscription-Key. Intestazione per la chiave client. Ad esempio: Ocp-Apim-Subscription-Key=<your-client-key>.
• Content-Type. Tipo di contenuto del payload. Il formato richiesto è: Content-Type: application/json; charset=UTF-8.

Il corpo della richiesta deve contenere una matrice che include un oggetto JSON con una proprietà Text che specifica il testo da tradurre:

[
    {"Text":"Where can I find my employee details?"}
]

Esistono diversi modi per inviare la richiesta all'API, tra cui C#, Python e curl. Ad esempio, per effettuare una chiamata rapida, è possibile inviare una richiesta POST usando curl:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

La richiesta precedente effettua una chiamata per tradurre una frase dall'inglese all'olandese.

Risposta restituita

La risposta restituisce un codice di risposta di 200 se la richiesta ha avuto esito positivo. Restituisce anche un corpo della risposta che contiene il testo tradotto, come illustrato di seguito:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Se la richiesta non ha esito positivo, è possibile che venga restituito un numero di codici di stato diversi a seconda del tipo di errore, ad esempio 400 (parametri di query mancanti o non validi). Per un elenco completo dei codici e della relativa spiegazione, vedere Codici di stato della risposta.

Nota

Per altre informazioni sulla traduzione personalizzata, vedere Avvio rapido: Compilare, pubblicare e tradurre con modelli personalizzati.