Definire traduzioni personalizzate

Completato

Anche se il modello di traduzione predefinito usato dal Traduttore per Azure AI è efficace per la traduzione generale, potrebbe essere necessario sviluppare una soluzione di traduzione per aziende o settori in cui sono presenti vocabolari specifici 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 Traduttore personalizzato per:

1. Creare un'area di lavoro collegata alla risorsa Traduttore per Azure AI.
2. Creare un progetto.
3. Caricare file di dati di training ed 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 nelle chiamate di funzione translate alla risorsa Traduttore per Azure AI usando il parametro category, per consentire l'esecuzione della traduzione da parte del modello personalizzato anziché del modello predefinito.

Come effettuare una chiamata all'API

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

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

La richiesta deve includere alcuni di parametri:

• api-version: versione richiesta dell'API.
• to: lingua di destinazione in cui eseguire la traduzione. 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 includa 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 l'uso di 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 avuto esito positivo, potrebbe essere 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: Creare, pubblicare e tradurre con modelli personalizzati.