Ámbito de Amazon Comprehend

Las actividades de Amazon Comprehend utilizan el servicio de AWS Identity and Access Management (IAM) para establecer una conexión autenticada entre UiPath y sus recursos de AWS. Esta conexión permite que un robot llame a las API de Amazon Comprehend para leer y escribir recursos en su nombre.

Para establecer una conexión autenticada, cree o utilice un usuario de IAM existente y genere claves de acceso (ID de clave de acceso y clave de acceso secreta). Cuando crea su usuario de IAM, asigna las políticas y permisos que especifican los recursos a los que su robot puede acceder (por ejemplo, AmazonComprehendFullAccess).

Después de crear tu usuario de IAM y asignar tus políticas, debes introducir el ID de la clave de acceso y la Clave de acceso secreta en la actividad Amazon Comprehend Scope . Al ejecutar su proyecto de automatización, las claves se utilizan para firmar las solicitudes de API que realiza cada una de las actividades.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Agregue la actividad de Amazon Comprehend Scope a su proyecto.
3. Introduce valores para las propiedades ubicadas en el cuerpo de la actividad.
4. Si deseas reutilizar la conexión en actividades de ámbito posteriores, introduce una variable en la propiedad Salida.

En el cuerpo de la actividad

• Tipo de autenticación : el tipo de autenticación que quieres utilizar. Puedes elegir AmazonComprehend o Conexión existente. Su elección de autenticación determina qué otras propiedades de autenticación verá.
• Clave de acceso: el ID de clave de acceso del usuario de IAM que quieres autenticar. Este campo solo admite cadenas o variables String . Para recuperar el ID de la clave de acceso, consulte una de las siguientes secciones en la documentación de AWS:
  • Gestión de claves de acceso (consola)
  • Administración de claves de acceso (AWS CLI)
  • Administración de claves de acceso (API de AWS)
• Región : el punto de conexión del servicio de AWS que quieres utilizar para la conexión. Introduce una variable RegionEndpoint o RegionEndpoint .
  Nota:

  Dependiendo de las actividades que estés usando, selecciona una región donde los servicios estén disponibles.

  La lista de regiones se puede encontrar escribiendo 'RegiónFinal', que es un tipo de objeto, y luego un punto (.) Que mostrará la lista de regiones (vea la imagen a continuación).

  Las versiones futuras de Amazon Comprehend proporcionarán una lista desplegable para facilitar esta selección.

• Secreto : la clave de acceso secreta del usuario de IAM que quieres conectar al servicio Amazon Rekognition. Este campo solo admite cadenas o variables String . Para recuperar la clave de acceso secreta, consulte una de las siguientes secciones en la documentación de AWS:
  • Gestión de claves de acceso (consola)
  • Administración de claves de acceso (AWS CLI)

  • Administración de claves de acceso (API de AWS)

    Importante:

    Si está utilizando un usuario de IAM existente y ya no tiene la clave de acceso secreta, cree uno nuevo haciendo clic en el botón Crear clave de acceso en su resumen de usuario de IAM; estas Actions también crean un nuevo ID de clave de accesoa

    Después de hacer clic en el botón Crear clave de acceso , se abre un cuadro de diálogo. Según las instrucciones de AWS: "Elija Descargar .csv para guardar el ID de la clave de acceso y la clave de acceso secreta en un archivo CSV en su ordenador. Almacene el archivo en una ubicación segura. No volverá a tener acceso a la clave de acceso secreta después de cerrar este cuadro de diálogo. Después de descargar el archivo CSV, elija Cerrar ".

    Amazon recomienda la rotación frecuente de claves, para que pueda crear nuevas claves en cualquier momento si no puede encontrar la clave de acceso secreta asociada con su ID de clave de acceso. Si crea nuevas claves, asegúrese de actualizar cualquier actividad de Amazon Scope en sus proyectos existentes.

    Para obtener más información, consulte <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html?icmpid=docs_iam_console "target= "_blank"> Administración de claves de acceso para usuarios de IAM </a> en la documentación de AWS.

• Conexión existente : un objeto de conexión de AmazonComprehend autenticado. Introduce una variable AmazonComprehendConnection .

Propiedades

Común

• Nombre para mostrar: el nombre para mostrar de la actividad. Este campo solo admite cadenas o variables String .

Otros

• Privado : si se selecciona esta casilla, los valores de variables y argumentos ya no se registran en el nivel detallado.

Opciones

• ReportApiErrorAsException : cuando se selecciona, las respuestas de error de la API se notifican en BusinessActivityExecutionException por todas las actividades secundarias que usan este ámbito de aplicación. Cuando se borra, la actividad secundaria rellena el mensaje de error de la API en la propiedad de salida EstadoDeRespuesta y la ejecución del flujo de trabajo continúa. Comprueba la propiedad EstadoDeRespuesta para confirmar que la ejecución se ha realizado correctamente.

Salida

• Conexión : la conexión que se puede pasar al ámbito de una aplicación secundaria. Este campo solo admite variables AmazonComprehendConnection .