Habilidades ML

Consulta esta sección para ver ejemplos sobre cómo utilizar las habilidades ML.

Ahorre costes de infraestructura utilizando las API de AI Center

Con las solicitudes de la API, puedes cambiar el estado de una habilidad ML mediante programación. Estas API podrían utilizarse incluso dentro de un flujo de trabajo de automatización para implementar y cancelar la implementación de una habilidad ML, optimizando el tiempo de actividad de la infraestructura y ahorrando costes. Consulta el conjunto completo de API de AI Center documentadas en swagger.

Ten en cuenta que accountname y tenantname son específicos de tu cuenta. Para obtener más información, consulta la lista de API .

Las API de AI Center se utilizan para:

1. Encuentra el ID de la habilidad ML de sampleClassifierSkill
2. Detener (desimplementar) la habilidad ML
3. Iniciar (volver a implementar) y verificar la actualización de estado.

En noviembre de 2022, anunciamos la disponibilidad de API para interactuar mediante programación con cada componente dentro de AI Center. Ahora puedes gestionar conjuntos de datos, entrenar modelos ML e implementar habilidades ML mediante API, sin tener que utilizar la interfaz de usuario.

Uno de los casos de uso clave para aprovechar las API es gestionar el estado de implementación de una habilidad ML. Dependiendo de la automatización, es posible que no necesites que una habilidad ML esté activa todo el tiempo. Cancelar la implementación de las habilidades ML cuando no se utilizan puede ayudarte a ahorrar en costes de hardware (unidades de IA).

Los pasos para acceder a las API de AI Center son:

1. Registrar una aplicación externa (configuración única)
2. Generar un token de autenticación (renovar al caducar)
3. Realizar llamadas a la API de AI Center

Nota: Los dos primeros pasos aplican el control de acceso asegurándose de que tu aplicación está registrada y autenticada

Registrar una aplicación externa

Para utilizar las API, tu aplicación debe registrarse como una aplicación externa con un ámbito de AI Center.

1. En el panel de navegación izquierdo, ve a la página Admin y selecciona External Applications.
2. Para añadir una nueva aplicación externa, selecciona + Add Application

   y nómbralo.

   Nota: Solo el tipoconfidential application puede acceder a las API de AI Center.
3. Para habilitar el ámbito de AI Center en la aplicación externa:
   1. Seleccione Add scope
   2. Elija AI Center API Access (preview) del menú desplegable Recurso
   3. Dirígete a la pestaña Application Scope
   4. Selecciona las API a las que deseas habilitar el acceso.
   En el siguiente ejemplo, todas las API se seleccionan para simplificar, pero puedes optar por asignar acceso a API específicas a aplicaciones externas específicas.
   
   

   

   
   
4. Selecciona Add. Se genera una ventana emergente con el ID de la aplicación y un Secreto de la aplicación.
   Consejo: Puedes ver el ID de la aplicación y el Secreto de la aplicación en cualquier momento desde Editar aplicación externa. Estas credenciales se utilizan para generar un token de autenticación en el siguiente paso. Consulta información adicional sobre la gestión de aplicaciones externas.
   
   

   

   
   

Generar un token de autenticación

Para la autenticación y el acceso seguro, la aplicación externa solicita un token de acceso al Identity Server de UiPath. El token de autenticación generado caduca en una hora, momento en el que deberás regenerar un nuevo token de autenticación.

Si quieres utilizar Postman, puedes registrarte de forma gratuita y elegir utilizar la interfaz basada en web de Postman o la aplicación descargable. Consulta el sitio web oficial de Postman .

1. Genera una solicitud POST al punto final de Identity Server https://cloud.uipath.com/identity_/connect/token que incluya lo siguiente en el cuerpo de la solicitud.

   client_id: App ID from previous step
   client_secret: App Secret from previous step
   grant_type: “client_credentials”

2. Establece grant_type como client_credentials.

Utiliza el tipo de contenido application/x-www-form-urlencoded para Postman.

Esta solicitud genera un token de autenticación similar al siguiente, que enumera los permisos habilitados para esta aplicación externa. Utiliza este token de autenticación al realizar llamadas a la API de AI Center.

Consulta información adicional sobre credenciales y tokens de autenticación.

Realizar llamadas a la API de AI Center

Las llamadas a la API se adhieren a la siguiente estructura: https://cloud.uipath.com/accountname/tenantname/aifabric_/ donde "accountname" y "tenantname " son específicos de tu cuenta. La mayoría de las API necesitan la siguiente información:

1. ID de cuenta e ID de tenant. Puedes encontrar la información de la cuenta y del tenant en la sección de información del perfil dentro del tenant. Consulta la información del perfil.
   
   

   

   
   
2. Autorización. El campo de autorización debe rellenarse con el token de autenticación generado en el paso anterior.
   Importante: Cuando utilices el token de autenticación, prefijalo con Bearer como en la siguiente captura de pantalla.

Ahora puedes acceder a API específicas. Usa sampleClassifierSkill para este ejemplo. En la lista Habilidades ML, puedes ver que esta habilidad existe y se encuentra actualmente en el estado Disponible .

Buscar detalles de la habilidad ML

Mediante la llamada GET ML Skills , puedes obtener una lista de todas las habilidades ML dentro de la cuenta y el tenant. También puedes añadir el nombre de la habilidad ML como parte de la consulta para buscar una habilidad ML específica y recuperar sus detalles. En este caso, encontrarás la habilidad ML idpara el sampleClassifierSkill

GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

En la respuesta a continuación, los campos clave se resaltan en amarillo. Comprueba que sampleClassifierSkill está en estado Disponible . La habilidad ML id se utiliza en las API posteriores para actualizar el estado.

Detener habilidad ML

Para detener una habilidad ML:

• La consulta de solicitud debe contener la acción de actualización stop y la habilidad ML id
• El encabezado debe contener información de cuenta, tenant y autenticación

PUT /ai-deployer/v2/mlskills/stop/{mlSkillId}

La respuesta muestra que el cambio de estado de la habilidad ML se ha realizado correctamente:

Al comprobar la IU, puedes verificar que sampleClassifierSkill no estaba implementado.

Reanudar habilidad ML

Para reiniciar (implementar) la habilidad ML, realiza las llamadas a la API con updateType establecido en Reanudar.

POST /ai-deployer/v1/mlskills/{mlSkillId}?updateType=RESUME

En la respuesta, puedes ver que la solicitud se ha realizado correctamente y que el estado de la habilidad se ha actualizado a Implementando.

Espera a que la habilidad esté disponible y comprueba el estado de la habilidad ML utilizando la API de detalles GET ML Skill .

A partir de la respuesta, la habilidad ML está ahora implementada y disponible. Verifica la disponibilidad de la habilidad en la IU. Ahora tus automatizaciones pueden aprovechar la habilidad ML sampleClassifierSkill implementada dentro de los flujos de trabajo para hacer predicciones.

Actualizar la implementación de la habilidad ML mediante la API

Para acceder a las API de AI Center:

1. Registra una aplicación externa (configuración única).
2. Genera un token de autenticación (renueva al caducar).
3. Realiza llamadas a la API de AI Center.

Nota: Los dos primeros pasos aplican el control de acceso asegurándose de que tu aplicación está registrada y autenticada. Para acceder a la aplicación, debe registrarse y autenticar la aplicación. (paso 1 y 2)

Registrar una aplicación externa

Para utilizar estas API, tu aplicación debe registrarse como una aplicación externa dentro del ámbito de AI Center.

1. Ve a la página Administración desde el panel de navegación izquierdo y selecciona Aplicaciones externas.
2. Selecciona + Añadir aplicación y dale un nombre para añadir una nueva aplicación externa.
   Nota: Solo el tipo de aplicación confidencial puede acceder a las API de AI Center.
3. Selecciona Añadir ámbito para habilitar el ámbito de AI Center en la aplicación externa.
   • Elige Acceso a la API de AI Center (vista previa) en el menú desplegable Recurso .
   • Ve a la pestaña Ámbito de la aplicación y elige las API a las que quieres dar acceso a las aplicaciones externas. En el siguiente ejemplo, seleccionas todas las API para simplificar.
     
     

     

     
     
4. Una ventana emergente con el ID de la aplicación y un Secreto de la aplicación confirman que la aplicación se ha añadido correctamente. Comprueba el ID de la aplicación y el Secreto de la aplicación en cualquier momento desde Editar aplicación externa.
   Nota: Utiliza estas credenciales para generar un token de autenticación en el siguiente paso.
   
   

   

   
   

Consulta la página Gestionar aplicaciones externas para obtener más información.

Generar un token de autenticación

La aplicación externa debe solicitar un token de acceso al Identity Server de UiPath para la autenticación y el acceso seguro.

Nota: El token de autenticación caduca en una hora. Después de este tiempo, deberá generar uno nuevo.

Para simplificar, utilizamos Postman en este tutorial. Puedes registrar 10 tokens de forma gratuita y utilizar su interfaz web, aplicación o cualquier otra herramienta.

Genera una solicitud POST al punto final de Identity Server que incluya lo siguiente en el cuerpo de la solicitud:

• client_id: ID de aplicación del paso anterior.
• client_secret: Secreto de la aplicación del paso anterior.
• grant_type: client_credentials.

Selecciona application/x-www-form-urlencoded como tipo de contenido si utilizas Postman.

Esta solicitud crea un token de autenticación, utilizado para las llamadas a la API de AI Center:

También puedes ver los permisos habilitados para esta aplicación externa.

Consulta la información adicional sobre las credenciales y los tokens de autenticación en la página Aplicaciones externas (OAuth) .

Realizar llamadas a la API de AI Center

Las llamadas a la API siguen la estructura https://cloud.uipath.com/accountname/tenantname/aifabric_/ 10 , donde accountname y tenantname son específicos de tu cuenta.

La mayoría de las API necesitan la siguiente información:

• Account ID y Tenant ID. Comprueba los detalles de la cuenta y del tenant en la sección de información del perfil dentro del tenant.
  
  

  

  
  
• Authorization. El campo de autorización se rellena con el token de autenticación generado en el paso anterior.

Ahora puedes acceder a API específicas.

En la lista Habilidades ML, sampleClassifierSkill (usado como ejemplo) está actualmente en el estado Disponible.

Utiliza las API de AI Center para:

• Busca el ID de habilidad ML de sampleClassifierSkill.
• Detener (desimplementar) la habilidad ML.
• Iniciar (volver a implementar) y verificar la actualización de estado.

Buscar detalles de la habilidad ML

Con la llamada GET ML Skills , puedes recuperar todas las habilidades ML en tu cuenta y tenant.

Para encontrar una habilidad ML específica y obtener sus detalles, incluye su nombre en la consulta: GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

En este caso, encontramos el ID de la habilidad ML para el sampleClassifierSkill.

Nota: Cuando utilices el token de autenticación, prefijalo con Bearer.

En la respuesta a continuación, los campos clave se resaltan en amarillo. Utiliza el ID de ML Skill en el siguiente APIs para modificar el estado:

Actualizar réplicas de habilidades ML

Utiliza la llamada UPDATE ML Skill para modificar la configuración de implementación en una habilidad ML específica.

En el siguiente ejemplo, cambiamos el recuento de réplicas incluyendo el nuevo número en el cuerpo de la solicitud.