Traduttore di Azure in Foundry Tools v3.0

Novità

La versione 3.0 di Translator fornisce un'API Web moderna basata su JSON. Migliora l'usabilità e le prestazioni consolidando le funzionalità esistenti in meno operazioni e offre nuove funzionalità.

  • Traslitterazione per convertire il testo in una lingua da uno script a un altro.
  • Traduzione in più lingue in una richiesta.
  • Rilevamento della lingua, traduzione e traslitterazione in una richiesta.
  • Dizionario per cercare traduzioni alternative di un termine, per trovare traduzioni e esempi che mostrano i termini usati nel contesto.
  • Risultati di rilevamento del linguaggio più informativi.

URL di base

L'URL di base globale è https://api.cognitive.microsofttranslator.com. La traduzione testuale supporta anche endpoint geografici e specifici delle risorse. Per tutti gli URL degli endpoint e i percorsi di elaborazione delle richieste, vedere Supporto dell'area per Traduttore di Azure.

supporto Rete virtuale

Translator è ora disponibile con funzionalità di Rete virtuale (VNET) in tutte le aree del cloud pubblico Azure. Per abilitare Rete virtuale, SeeConfiguring Foundry Tools virtual networks.

Dopo aver attivato questa funzionalità, è necessario usare l'endpoint personalizzato per chiamare Translator. Non è possibile usare l'endpoint traduttore globale ("api.cognitive.microsofttranslator.com") e non è possibile eseguire l'autenticazione con un token di accesso.

È possibile trovare l'endpoint personalizzato dopo aver creato una risorsa traduttore e consentire l'accesso da reti selezionate ed endpoint privati.

  1. Passare alla risorsa Traduttore nel portale di Azure.

  2. Selezionare Rete nella sezione Gestione risorse.

  3. Nella scheda Firewall e reti virtuali scegliere Reti selezionate ed endpoint privati.

    Screenshot dell'impostazione della rete virtuale nel Azure portal.

  4. Seleziona Salva per applicare le modifiche.

  5. Selezionare Chiavi ed endpoint nella sezione Gestione risorse .

  6. Selezionare la scheda Rete virtuale.

  7. Nell'elenco sono elencati gli endpoint per la traduzione testuale e la traduzione dei documenti.

    Screenshot dell'endpoint di rete virtuale.

Intestazioni Description
Ocp-Apim-Subscription-Key Il valore è la chiave privata Azure per la sottoscrizione a Translator.
Ocp-Apim-Subscription-Region Il valore è l'area della risorsa traduttore. Questo valore è facoltativo se la risorsa è global

Ecco una richiesta di esempio per chiamare Translator usando l'endpoint personalizzato

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

Metrics

Le metriche consentono di visualizzare le informazioni sull'utilizzo e sulla disponibilità del traduttore nel portale di Azure. Per altre informazioni, vedere Metriche dei dati e della piattaforma.

Metriche del traduttore

Questa tabella elenca le metriche disponibili con la descrizione del modo in cui vengono usate per monitorare le chiamate API di traduzione.

Metrics Description
TotalCalls Numero totale di chiamate API.
TotalTokenCalls Numero totale di chiamate API tramite il servizio token usando il token di autenticazione.
SuccessfulCalls Numero di chiamate riuscite.
TotalErrors Numero di chiamate con risposta di errore.
BlockedCalls Numero di chiamate che hanno superato il limite di frequenza o di quota.
ServerErrors Numero di chiamate con errore interno del server (5XX).
ClientErrors Numero di chiamate con errore sul lato client (4XX).
Latenza Durata del completamento della richiesta in millisecondi.
CharactersTranslated Numero totale di caratteri nella richiesta di testo in ingresso.