Azure Translator in Foundry Tools v3.0

Was ist neu?

Version 3.0 des Übersetzers stellt eine moderne JSON-basierte Web-API bereit. Sie verbessert die Benutzerfreundlichkeit und Leistung, indem vorhandene Features in weniger Vorgänge konsolidiert werden und neue Features bereitgestellt werden.

  • Transliteration zum Konvertieren von Text in einer Sprache von einem Skript in ein anderes Skript.
  • Übersetzung in mehrere Sprachen in einer Anforderung.
  • Spracherkennung, Übersetzung und Transliteration in einer Anforderung.
  • Wörterbuch zum Nachschlagen alternativer Übersetzungen eines Begriffs, um Back-Übersetzungen und Beispiele zu finden, die ausdrücken, die im Kontext verwendet werden.
  • Informativere Spracherkennungsergebnisse.

Basis-URLs

Die globale Basis-URL lautet https://api.cognitive.microsofttranslator.com. Textübersetzung unterstützt auch geografie- und ressourcenspezifische Endpunkte. Informationen zu allen Endpunkt-URLs und ihren Anforderungsverarbeitungsspeicherorten finden Sie unter Regionsunterstützung für Azure Translator.

Virtual Network-Support

Der Übersetzer ist jetzt mit Virtual Network -Funktionen (VNET) in allen Regionen der Azure öffentlichen Cloud verfügbar. Um Virtual Network zu aktivieren, SeeConfiguring Foundry Tools virtual networks.

Nachdem Sie diese Funktion aktiviert haben, müssen Sie den benutzerdefinierten Endpunkt verwenden, um den Übersetzer aufzurufen. Sie können den globalen Übersetzerendpunkt ("api.cognitive.microsofttranslator.com") nicht verwenden, und Sie können sich nicht mit einem Zugriffstoken authentifizieren.

Sie können den benutzerdefinierten Endpunkt finden, nachdem Sie eine Übersetzerressource erstellt und den Zugriff von ausgewählten Netzwerken und privaten Endpunkten zulassen.

  1. Navigieren Sie im Azure-Portal zu Ihrer Übersetzerressource.

  2. Wählen Sie im Abschnitt Ressourcenverwaltung die Option Netzwerk aus.

  3. Wählen Sie auf der Registerkarte Firewalls und virtuelle Netzwerke die Option Ausgewählte Netzwerke und private Endpunkte aus.

    Screenshot der Einstellung des virtuellen Netzwerks im Azure portal.

  4. Wählen Sie "Speichern" aus, um Ihre Änderungen anzuwenden.

  5. Wählen Sie "Schlüssel" und "Endpunkt " im Abschnitt "Ressourcenverwaltung " aus.

  6. Wählen Sie die Registerkarte Virtual Network aus.

  7. Hier sind die Endpunkte für die Textübersetzung und die Dokumentübersetzung aufgeführt.

    Screenshot des virtuellen Netzwerkendpunkts.

Headers Beschreibung
Ocp-Apim-Subscription-Key Der Wert ist der Azure geheimer Schlüssel für Ihr Abonnement von Translator.
Ocp-Apim-Subscription-Region Der Wert ist der Bereich der Übersetzerressource. Dieser Wert ist optional, wenn die Ressource global

Hier ist eine Beispielanforderung zum Aufrufen des Übersetzers mithilfe des benutzerdefinierten Endpunkts.

// 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

Mithilfe von Metriken können Sie die Informationen zur Übersetzernutzung und -verfügbarkeit im Azure Portal anzeigen. Weitere Informationen finden Sie unter Daten- und Plattformmetriken.

Übersetzermetriken

In dieser Tabelle sind die verfügbaren Metriken aufgeführt, die beschreiben, wie sie zum Überwachen von Übersetzungs-API-Aufrufen verwendet werden.

Metrics Beschreibung
TotalCalls Gesamtanzahl der API-Aufrufe.
TotalTokenCalls Die Gesamtzahl der API-Aufrufe über den Tokendienst mithilfe des Authentifizierungstokens.
SuccessfulCalls Anzahl erfolgreicher Aufrufe
TotalErrors Anzahl der Anrufe mit Fehlerantwort.
BlockedCalls Anzahl von Aufrufen, die das Raten- oder Kontingentlimit überschritten haben
ServerFehler Anzahl der Anrufe mit internem Serverfehler(5XX).
ClientErrors Anzahl der Anrufe mit clientseitigem Fehler(4XX).
Latenz Dauer zum Abschließen der Anforderung in Millisekunden.
CharactersTranslated Gesamtanzahl von Zeichen in einer eingehenden Textanforderung