Aptitud cognitiva Text TranslationText Translation cognitive skill

La aptitud Text Translation evalúa el texto y, para cada registro, devuelve el texto traducido al idioma de destino especificado.The Text Translation skill evaluates text and, for each record, returns the text translated to the specified target language. Esta aptitud usa Translator Text API v3.0, disponible en Cognitive Services.This skill uses the Translator Text API v3.0 available in Cognitive Services.

Esta funcionalidad es útil si espera que los documentos no estén en un único idioma, en cuyo caso puede normalizar el texto a un solo idioma antes de la indexación para la búsqueda mediante su traducción.This capability is useful if you expect that your documents may not all be in one language, in which case you can normalize the text to a single language before indexing for search by translating it. También es útil para los casos de uso de localización, en los que puede que desee tener copias del mismo texto disponibles en varios idiomas.It is also useful for localization use cases, where you may want to have copies of the same text available in multiple languages.

Translator Text API v3.0 es un servicio de Cognitive Services no regional, lo que significa que no se garantiza que los datos permanezcan en la misma región que Azure Cognitive Search o el recurso de Cognitive Services asociado.The Translator Text API v3.0 is a non-regional Cognitive Service, meaning that your data is not guaranteed to stay in the same region as your Azure Cognitive Search or attached Cognitive Services resource.

Nota

A medida que expanda el ámbito aumentando la frecuencia de procesamiento, agregando más documentos o agregando más algoritmos de IA, tendrá que asociar un recurso facturable de Cognitive Services.As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to attach a billable Cognitive Services resource. Los cargos se acumulan cuando se llama a las API de Cognitive Services y por la extracción de imágenes como parte de la fase de descifrado de documentos de Azure Cognitive Search.Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Cognitive Search. No hay ningún cargo por la extracción de texto de documentos.There are no charges for text extraction from documents.

La ejecución de aptitudes integradas se cobra según los precios de pago por uso de Cognitive Services existentes.Execution of built-in skills is charged at the existing Cognitive Services pay-as-you go price. Los precios de la extracción de imágenes se describen en la página de precios de Búsqueda cognitiva de Azure.Image extraction pricing is described on the Azure Cognitive Search pricing page.

@odata.type

Microsoft.Skills.Text.TranslationSkillMicrosoft.Skills.Text.TranslationSkill

Límites de datosData limits

El tamaño máximo de un registro debe tener menos de 50 000 caracteres según la medición de String.Length.The maximum size of a record should be 50,000 characters as measured by String.Length. Si tiene que dividir los datos antes de enviarlos a la aptitud Text Translation, puede usar la aptitud Text Split.If you need to break up your data before sending it to the text translation skill, consider using the Text Split skill.

Parámetros de la aptitudSkill parameters

Los parámetros distinguen mayúsculas de minúsculas.Parameters are case-sensitive.

EntradasInputs DescripciónDescription
defaultToLanguageCodedefaultToLanguageCode (Obligatorio) Código de idioma al que traducir los documentos para aquellos documentos que no especifican el idioma de destino explícitamente.(Required) The language code to translate documents into for documents that don't specify the to language explicitly.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages.
defaultFromLanguageCodedefaultFromLanguageCode (Opcional) Código de idioma desde el que traducir los documentos para aquellos documentos que no especifican el idioma de origen explícitamente.(Optional) The language code to translate documents from for documents that don't specify the from language explicitly. Si no se especifica defaultFromLanguageCode, se usará la detección automática de idioma proporcionada por Translator Text API para determinar el idioma de origen.If the defaultFromLanguageCode is not specified, the automatic language detection provided by the Translator Text API will be used to determine the from language.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages.
suggestedFromsuggestedFrom (Opcional) Código de idioma desde el que se van a traducir documentos cuando no se proporcionan ni la entrada fromLanguageCode ni el parámetro defaultFromLanguageCode y la detección automática de idioma no se realiza correctamente.(Optional) The language code to translate documents from when neither the fromLanguageCode input nor the defaultFromLanguageCode parameter are provided, and the automatic language detection is unsuccessful. Si no se especifica el idioma suggestedFrom, se usará inglés (en) como idioma suggestedFrom.If the suggestedFrom language is not specified, English (en) will be used as the suggestedFrom language.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages.

Entradas de la aptitudSkill inputs

Nombre de entradaInput name DescripciónDescription
texttext Texto que se va a traducir.The text to be translated.
toLanguageCodetoLanguageCode Cadena que indica el idioma al que se debe traducir el texto.A string indicating the language the text should be translated to. Si no se especifica esta entrada, se usará defaultToLanguageCode para traducir el texto.If this input is not specified, the defaultToLanguageCode will be used to translate the text.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages
fromLanguageCodefromLanguageCode Cadena que indica el idioma actual del texto.A string indicating the current language of the text. Si no se especifica este parámetro, se utilizará defaultFromLanguageCode (o la detección automática de idioma si no se proporciona defaultFromLanguageCode) para traducir el texto.If this parameter is not specified, the defaultFromLanguageCode (or automatic language detection if the defaultFromLanguageCode is not provided) will be used to translate the text.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages

Salidas de la aptitudSkill outputs

Nombre de salidaOutput name DescripciónDescription
translatedTexttranslatedText Cadena resultante de la traducción del texto desde translatedFromLanguageCode a translatedToLanguageCode.The string result of the text translation from the translatedFromLanguageCode to the translatedToLanguageCode.
translatedToLanguageCodetranslatedToLanguageCode Cadena que indica el código de idioma al que se ha traducido el texto.A string indicating the language code the text was translated to. Resulta útil si va a traducir a varios idiomas y desea poder realizar un seguimiento del idioma de cada texto.Useful if you are translating to multiple languages and want to be able to keep track of which text is which language.
translatedFromLanguageCodetranslatedFromLanguageCode Cadena que indica el código de idioma desde el que se ha traducido el texto.A string indicating the language code the text was translated from. Resulta útil si opta por la opción de detección automática de idioma, ya que esta salida le dará el resultado de dicha detección.Useful if you opted for the automatic language detection option as this output will give you the result of that detection.

Definición de ejemploSample definition

 {
    "@odata.type": "#Microsoft.Skills.Text.TranslationSkill",
    "defaultToLanguageCode": "fr",
    "suggestedFrom": "en",
    "context": "/document",
    "inputs": [
      {
        "name": "text",
        "source": "/document/text"
      }
    ],
    "outputs": [
      {
        "name": "translatedText",
        "targetName": "translatedText"
      },
      {
        "name": "translatedFromLanguageCode",
        "targetName": "translatedFromLanguageCode"
      },
      {
        "name": "translatedToLanguageCode",
        "targetName": "translatedToLanguageCode"
      }
    ]
  }

Entrada de ejemploSample input

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "text": "We hold these truths to be self-evident, that all men are created equal."
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "text": "Estamos muy felices de estar con ustedes."
        }
    }
  ]
}

Salida de ejemploSample output

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "translatedText": "Nous tenons ces vérités pour évidentes, que tous les hommes sont créés égaux.",
          "translatedFromLanguageCode": "en",
          "translatedToLanguageCode": "fr"
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "translatedText": "Nous sommes très heureux d'être avec vous.",
          "translatedFromLanguageCode": "es",
          "translatedToLanguageCode": "fr"
        }
    }
  ]
}

Errores y advertenciasErrors and warnings

Si proporciona un código de idioma no admitido para el lenguaje de origen o destino, se genera un error y no se traduce el texto.If you provide an unsupported language code for either the from or the to language, an error is generated and text is not translated. Si el texto está vacío, se creará una advertencia.If your text is empty, a warning will be produced. Si el texto tiene más de 50 000 caracteres, solo se traducirán los primeros 50 000 caracteres y se emitirá una advertencia.If your text is larger than 50,000 characters, only the first 50,000 characters will be translated and a warning will be issued.

Consulte tambiénSee also