Microsoft Translator V3 (versión preliminar)
Microsoft Azure Cognitive Services Translator le permite traducir texto y documentos a más de 100 idiomas mediante modelos generales o personalizados.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft Translator |
| URL | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| Correo Electrónico | mtfb@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft Translator |
| Sitio web | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| Directiva de privacidad | https://privacy.microsoft.com/ |
| Categorías | IA; Business Intelligence |
El conector de Translator de Azure Cognitive Services permite integrar cualquier componente de Power Platform, como Power Automate Flow o Power App con nuestro servicio Microsoft Translator. Con este conector, puede realizar las siguientes acciones:
•Traducir texto.
• Transliterar texto.
• Traducir una variedad de tipos de archivo de documento.
Prerrequisitos
Siga las instrucciones para crear un recurso de Translator en Azure Portal.
Obtención de credenciales
• Después de crear un recurso de Translator, obtenga el nombre del recurso y la clave de Azure Portal.
• Siga estos requisitos previos para traducir documentos.
• Navegue dentro de los contenedores de origen y destino y haga clic en "Cambiar a la cuenta de usuario de Id. de Entra de Microsoft", como se muestra en la captura de pantalla siguiente. Este paso solo es necesario para el conector.
Introducción al conector
Siga estas instrucciones sobre cómo usar translator connector en un flujo y automatizar las tareas de traducción.
Errores comunes
Consulte esta documentación para ver los errores comunes: https://learn.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference#errors
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Clave de acceso | Proporcione el nombre del recurso de Microsoft Translator y la clave de recurso de Azure Cognitive Services para Translator. | Todas las regiones | Compartible |
| Identidad administrada de Logic Apps | Creación de una conexión mediante una identidad administrada de LogicApps | Solo LOGICAPPS | Compartible |
| Valor predeterminado [EN DESUSO] | Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. | Todas las regiones | No se puede compartir |
Clave de acceso
Identificador de autenticación: keyBasedAuth
Aplicable: Todas las regiones
Proporcione el nombre del recurso de Microsoft Translator y la clave de recurso de Azure Cognitive Services para Translator.
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Nombre del recurso de Translator | cuerda / cadena | Escriba el nombre del recurso de Microsoft Translator. | Cierto |
| Clave de recurso | securestring | Clave de recurso de Azure Cognitive Services para Translator. | Cierto |
Identidad administrada de Logic Apps
Identificador de autenticación: managedIdentityAuth
Aplicable: SOLO LOGICAPPS
Creación de una conexión mediante una identidad administrada de LogicApps
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Identidad administrada de LogicApps | managedIdentity | Inicio de sesión con una identidad administrada de Logic Apps | Cierto |
| Nombre del recurso de Translator | cuerda / cadena | Escriba el nombre del recurso de Microsoft Translator. | Cierto |
| Clave de recurso | securestring | Clave de recurso de Azure Cognitive Services para Translator. | Cierto |
Valor predeterminado [EN DESUSO]
Aplicable: Todas las regiones
Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Nombre del recurso de Translator | cuerda / cadena | Escriba el nombre del recurso de Microsoft Translator. | Cierto |
| Clave de recurso | securestring | Clave de recurso de Azure Cognitive Services para Translator. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Cancelación de la traducción |
Cancela un trabajo de traducción de documentos que está procesando o en cola actualmente. |
| Iniciar traducción de documentos |
Esta acción inicia un trabajo de traducción de documentos. |
| Obtención de formatos de documento admitidos |
Obtiene una lista de formatos de documento admitidos. |
| Obtención de formatos de glosario admitidos |
Obtiene una lista de formatos de glosario admitidos. |
| Obtención de orígenes de almacenamiento admitidos |
Obtiene una lista de las opciones y orígenes de almacenamiento admitidos. |
| Obtención del estado de las traducciones |
Obtiene una lista junto con el estado de todas las solicitudes de traducción enviadas por el usuario. |
| Obtención del estado de traducción |
Obtiene un resumen del estado de una solicitud de traducción de documentos específica. |
| Obtener el estado de los documentos |
Obtiene el estado de todos los documentos de un trabajo de traducción. |
| Obtener el estado del documento |
Obtiene el estado de un documento específico de un trabajo. |
| Obtener idiomas |
Recupera todos los idiomas admitidos para la traducción por Translator de Microsoft Azure Cognitive Services. |
| Traducción de texto |
Traduzca el texto del idioma de origen especificado en el texto del idioma de destino. |
| Transliterar |
Convierte texto en un idioma de un script a otro. |
Cancelación de la traducción
Cancela un trabajo de traducción de documentos que está procesando o en cola actualmente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de operación
|
id | True | string |
Identificador de la operación. |
Devoluciones
Iniciar traducción de documentos
Esta acción inicia un trabajo de traducción de documentos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de almacenamiento de los documentos de entrada
|
storageType | True | string |
Elija un archivo o carpeta. |
|
Lengua origen
|
sourceLanguage | True | string |
Código de lenguaje. Si no se especifica ninguno, Microsoft Translator intentará detectar automáticamente el idioma del documento. |
|
Ubicación de los documentos de origen
|
sourceURL | True | string |
Ubicación de los documentos de origen que pueden ser un único archivo o una carpeta. Esta ubicación es un vínculo de dirección URL desde Azure Blob Storage. |
|
Filtro de prefijo
|
documentFilterPrefix | string |
Cadena de prefijo que distingue mayúsculas de minúsculas para filtrar documentos en la ruta de acceso de origen para la traducción. Por ejemplo, al usar un URI de blob de Azure Storage, use el prefijo para restringir las subcarpetas para la traducción. |
|
|
Filtro de sufijo
|
documentFilterSuffix | string |
Cadena de sufijo que distingue mayúsculas de minúsculas para filtrar documentos en la ruta de acceso de origen para la traducción. Se usa con más frecuencia para extensiones de archivo. |
|
|
Categoría
|
targetCategory | string |
Cadena que especifica la categoría (dominio) de la traducción. Este parámetro se usa para obtener traducciones de un sistema personalizado creado con Custom Translator. |
|
|
Ubicación de los documentos traducidos
|
targetContainerURL | True | string |
Ubicación donde se almacenarán los documentos traducidos. Esta ubicación es un vínculo de dirección URL desde Azure Blob Storage. |
|
Idioma de destino
|
targetLanguage | True | string |
Código de idioma de destino. |
|
Dirección URL del glosario
|
glossaryUrl | string |
Ubicación de los documentos del glosario. Esta ubicación es un vínculo de dirección URL desde Azure Blob Storage. |
|
|
Formato y versión del documento del glosario
|
glossaryFormatVersion | string |
Formato y versión del documento del glosario. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
operationID
|
operationID | string |
Identificador de la operación. |
Obtención de formatos de documento admitidos
Obtención de formatos de glosario admitidos
Obtención de orígenes de almacenamiento admitidos
Obtiene una lista de las opciones y orígenes de almacenamiento admitidos.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of string |
Valor de respuesta. |
Obtención del estado de las traducciones
Obtiene una lista junto con el estado de todas las solicitudes de traducción enviadas por el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número total de registros que se van a devolver
|
$top | integer |
Número total de registros que el usuario quiere devolver en todas las páginas. |
|
|
Número de registros que se van a omitir
|
$skip | integer |
Número de registros que se van a omitir de la lista en función del método de ordenación. |
|
|
Número máximo de registros devueltos
|
$maxpagesize | integer |
Los registros máximos devueltos en una página. |
|
|
Ordenar por
|
$orderBy | array |
La consulta de ordenación de la colección, por ejemplo, "CreatedDateTimeUtc asc", "CreatedDateTimeUtc desc". |
|
|
Fecha y hora de inicio
|
createdDateTimeUtcStart | date-time |
Fecha y hora de inicio para obtener registros después. |
|
|
Fecha y hora de finalización
|
createdDateTimeUtcEnd | date-time |
Fecha y hora de finalización antes de obtener registros. |
|
|
Filtrar por estado
|
statuses | array |
Estados que se usarán en el filtrado. |
|
|
Filtrar por identificadores de operación
|
ids | array |
Identificadores de operación que se usarán en el filtrado. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of TranslationStatusResponse |
Valor de respuesta. |
|
@nextLink
|
@nextLink | string |
Dirección URL de la página siguiente. Null si la última página. |
Obtención del estado de traducción
Obtiene un resumen del estado de una solicitud de traducción de documentos específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de operación
|
id | True | string |
Identificador de la operación. |
Devoluciones
Obtener el estado de los documentos
Obtiene el estado de todos los documentos de un trabajo de traducción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de operación
|
id | True | string |
Identificador de la operación. |
|
Número total de registros que se van a devolver
|
$top | integer |
Número total de registros que el usuario quiere devolver en todas las páginas. |
|
|
Número de registros que se van a omitir
|
$skip | integer |
Número de registros que se van a omitir de la lista en función del método de ordenación. |
|
|
Número máximo de registros devueltos
|
$maxpagesize | integer |
Los registros máximos devueltos en una página. |
|
|
Ordenar por
|
$orderBy | array |
Consulta de ordenación de la colección. (Eg., 'CreatedDateTimeUtc asc', 'CreatedDateTimeUtc desc'). |
|
|
Fecha y hora de inicio
|
createdDateTimeUtcStart | date-time |
Fecha y hora de inicio para obtener elementos después. |
|
|
Fecha y hora de finalización
|
createdDateTimeUtcEnd | date-time |
Fecha y hora de finalización para obtener elementos antes. |
|
|
Filtrar por estado
|
statuses | array |
Estados que se usarán en el filtrado. |
|
|
Filtrar por identificador de documento
|
ids | array |
Identificadores de documento que se usarán en el filtrado. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
Valor de respuesta. |
|
camino
|
value.path | string |
Ubicación del documento o carpeta. |
|
sourcePath
|
value.sourcePath | string |
Ubicación del documento de origen. |
|
createdDateTimeUtc
|
value.createdDateTimeUtc | string |
Operación creada fecha y hora. |
|
lastActionDateTimeUtc
|
value.lastActionDateTimeUtc | string |
Fecha y hora en la que se ha actualizado el estado de la operación. |
|
estado
|
value.status | string |
Lista de posibles estados para el trabajo o documento. |
|
to
|
value.to | string |
Idioma de destino. |
|
progreso
|
value.progress | integer |
Progreso de la traducción si está disponible. |
|
id
|
value.id | string |
Id. de documento. |
|
characterCharged
|
value.characterCharged | integer |
Caracteres cargados por la API. |
|
@nextLink
|
@nextLink | string |
Dirección URL de la página siguiente. Null si la última página. |
Obtener el estado del documento
Obtiene el estado de un documento específico de un trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de operación
|
id | True | string |
Identificador de la operación. |
|
Id. de documento
|
documentId | True | string |
Identificador del documento. |
Devoluciones
Obtener idiomas
Recupera todos los idiomas admitidos para la traducción por Translator de Microsoft Azure Cognitive Services.
Devoluciones
- response
- array of Language
Traducción de texto
Traduzca el texto del idioma de origen especificado en el texto del idioma de destino.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Lengua origen
|
from | True | string |
El código de idioma fuente (ejemplo: "en"). Si no se especifica el código de idioma fuente, se aplica la detección automática de idioma para determinar el idioma de origen. |
|
Idioma de destino
|
to | True | string |
Código de idioma de destino (ejemplo: "fr"). |
|
Tipo de texto
|
textType | string |
Define si el formato de texto que se va a traducir es texto sin formato o HTML. |
|
|
Acción soece
|
profanityAction | string |
Especifica cómo se deben tratar las palabras soeces en las traducciones. |
|
|
Marcador de palabras soeces
|
profanityMarker | string |
Especifica cómo se deben marcar las palabras soeces en las traducciones. |
|
|
Incluir longitud de oración
|
includeSentenceLength | string |
Especifica si se deben incluir límites de oración para el texto de entrada y el texto traducido. |
|
|
Idioma de origen sugerido
|
suggestedFrom | string |
Especifica un idioma de reserva si no se puede identificar el idioma del texto de entrada. |
|
|
Script del texto de origen
|
fromScript | string |
Nombre del script del texto de entrada. |
|
|
Script del texto traducido
|
toScript | string |
Nombre del script del texto traducido. |
|
|
Categoría
|
category | string |
Cadena que especifica la categoría (dominio) de la traducción. Este parámetro se usa para obtener traducciones de un sistema personalizado creado con Custom Translator. |
|
|
Permitir la reserva en un dominio general
|
allowFallback | string |
Especifica que el servicio puede revertir a un sistema general cuando no existe un sistema personalizado. |
|
|
Mensaje de texto
|
Text | True | string |
Texto que se va a traducir. |
Devoluciones
- response
- array of TranslationResults
Transliterar
Convierte texto en un idioma de un script a otro.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Language
|
language | True | string |
Especifica el idioma del texto que se va a convertir de un script a otro. |
|
Script de origen
|
fromScript | True | string |
Nombre del script del texto de entrada. |
|
Script de destino
|
toScript | True | string |
Nombre del script del texto transliterado. |
|
Mensaje de texto
|
Text | True | string |
Texto que se va a traducir. |
Devoluciones
- response
- array of TransliterationResults
Definiciones
TranslationResults
Resultado de la traducción.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Texto traducido
|
TranslatedText | string |
Obtiene el texto traducido. |
|
Texto transliterado
|
TransliteratedText | string |
Obtiene el texto transliterado. |
TransliterationResults
Resultados de transliteración.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje de texto
|
text | string |
Obtiene el texto transliterado. |
|
Script
|
script | string |
Script transliterado. |
Language
Código de lenguaje. Si no se especifica ninguno, Microsoft Translator intentará detectar automáticamente el idioma del documento.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Código de lenguaje
|
Code | string |
Obtiene o establece el código de idioma. |
|
Language
|
Name | string |
Obtiene o establece el idioma. |
FormatOKResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
Formato de archivo con detalles. |
|
format
|
value.format | string |
Nombre del formato del documento. |
|
fileExtensions
|
value.fileExtensions | array of string |
Extensión de archivo compatible con este formato. |
|
contentTypes
|
value.contentTypes | array of string |
Tipos de contenido admitidos para este formato. |
|
versiones
|
value.versions | array of string |
Versión admitida. |
|
defaultVersion
|
value.defaultVersion | string |
Versión predeterminada si no se especifica ninguna. |
TranslationStatusResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Id. de la operación. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
Operación creada fecha y hora. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
Fecha y hora en la que se ha actualizado el estado de la operación. |
|
estado
|
status | string |
Lista de posibles estados para el trabajo o documento, como Canceled, Cancelling, Failed, NotStarted, Running, Succeeded, ValidationFailed. |
|
total
|
summary.total | integer |
Recuento de documentos totales. |
|
fallido
|
summary.failed | integer |
Error en el recuento de documentos. |
|
correcto
|
summary.success | integer |
Recuento de documentos traducidos correctamente. |
|
inProgress
|
summary.inProgress | integer |
Recuento de documentos en curso. |
|
notYetStarted
|
summary.notYetStarted | integer |
Recuento de documentos que aún no se han iniciado el procesamiento. |
|
cancelled
|
summary.cancelled | integer |
Recuento de documentos cancelados. |
|
totalCharacterCharged
|
summary.totalCharacterCharged | integer |
Recuento total de caracteres cargados. |
DocumentStatusResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
camino
|
path | string |
Ubicación del documento o carpeta. |
|
sourcePath
|
sourcePath | string |
Ubicación del documento de origen. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
Operación creada fecha y hora. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
Fecha y hora en la que se ha actualizado el estado de la operación. |
|
estado
|
status | string |
Lista de posibles estados para el trabajo o documento, como Canceled, Cancelling, Failed, NotStarted, Running, Succeeded, ValidationFailed. |
|
to
|
to | string |
Idioma de destino. |
|
progreso
|
progress | integer |
Progreso de la traducción si está disponible. |
|
id
|
id | string |
Id. de documento. |
|
characterCharged
|
characterCharged | integer |
Caracteres cargados por la API. |