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, debes registrarte y autenticar la aplicación. (pasos 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. Compruebe 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 observar 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 el 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 siguiente respuesta, los campos clave se resaltan en amarillo. Utiliza el ID 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.