Habilidades de ML

Verifique essa seção para obter exemplos de como usar Habilidades de ML.

Economize custos de infraestrutura usando APIs do AI Center

Com as solicitações de API, você pode alterar programaticamente o estado de uma habilidade de ML. Essas APIs podem ser usadas mesmo dentro de um fluxo de trabalho de automação para implantar e desfazer a implantação de uma Habilidade de ML, otimizando o tempo de atividade da infraestrutura e economizando custos. Consulte o conjunto completo de APIs do AI Center documentadas no swagger.

Observe que accountname e tenantname são específicos da sua conta. Para mais informações, consulte a lista de APIs .

Você usa as APIs do AI Center para:

1. Encontre o ID da Habilidade de ML de sampleClassifierSkill
2. Interromper (desfazer a implantação) da Habilidade de ML
3. Inicie ( reimplantar ) e verifique a atualização do status.

Em novembro de 2022, anunciamos a disponibilidade de APIs para interagir programaticamente com cada componente do AI Center. Agora, é possível gerenciar conjuntos de dados, treinar modelos de ML e implantar Habilidades de ML usando APIs, sem ter que usar a Interface do usuário.

Um dos principais casos de uso para aproveitar APIs é gerenciar o status da implantação de uma Habilidade de ML. Dependendo da automação, você pode não precisar que uma Habilidade de ML esteja ativa o tempo todo. Desfazer a implantação de Habilidades de ML quando não estão em uso pode ajudar você a economizar em custos de hardware (AI Units).

As etapas para acessar as APIs do AI Center são:

1. Registrando um aplicativo externo (configuração única)
2. Gerar um token de autenticação (renovar após a expiração)
3. Fazendo chamadas de API do AI Center

Observação: as duas primeiras etapas impõem o controle de acesso, assegurando que o aplicativo seja registrado e autenticado

Registro de um aplicativo externo

Para usar as APIs, seu aplicativo precisa se registrar como um aplicativo externo com um escopo do AI Center.

1. No painel de navegação esquerdo, vá para a página Admin e selecione External Applications.
2. Para adicionar um novo aplicativo externo, selecione + Add Application

   e nomeie-a.

   Observação: apenas o tipoconfidential application pode acessar as APIs do AI Center.
3. Para habilitar o escopo do AI Center para o aplicativo externo:
   1. Selecionar Add scope
   2. Escolha AI Center API Access (preview) no menu suspenso Recurso
   3. Navegue para a guia Application Scope
   4. Selecione as APIs para as quais você deseja habilitar o acesso.
   No exemplo abaixo, todas as APIs são selecionadas para simplificar, mas você pode optar por atribuir acesso a APIs específicas a aplicativos externos específicos.
   
   

   

   
   
4. Selecione Add. Uma mensagem com o ID do aplicativo e um Segredo do aplicativo será gerada.
   Dica: você pode visualizar o ID do aplicativo e Segredo do aplicativo a qualquer momento no aplicativo Editar externo. Essas credenciais serão usadas para gerar um token de autenticação na etapa seguinte. Consulte informações adicionais sobre gerenciamento de aplicativos externos.
   
   

   

   
   

Gerar um token de autenticação

Para autenticação e acesso seguro, o aplicativo externo solicita um token de acesso do servidor de identidade da UiPath. O token de autenticação gerado expira em uma hora, após a qual você precisa gerar novamente um novo token de autenticação.

Se você quiser usar o Postman, você pode se registrar gratuitamente e escolher usar a interface baseada na web do Postman ou o aplicativo para download. Consulte o site oficial do Postman .

1. Gere uma solicitação POST para o endpoint do Identity Server https://cloud.uipath.com/identity_/connect/token que inclua o seguinte no corpo da solicitação.

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

2. Defina grant_type como client_credentials.

Use o tipo de conteúdo application/x-www-form-urlencoded para o Postman.

Essa solicitação gera um token de autenticação semelhante ao abaixo, listando as permissões habilitadas para esse aplicativo externo. Use este token de autenticação ao fazer chamadas de API do AI Center.

Consulte as informações adicionais sobre credenciais e tokens de autenticação.

Fazendo chamadas de API do AI Center

As chamadas de API seguem a seguinte estrutura: https://cloud.uipath.com/accountname/tenantname/aifabric_/ em que “accountname" e "tenantname " são específicos da sua conta. A maioria das APIs precisa das seguintes informações:

1. ID da conta e ID do Tenant. Você pode encontrar as informações da conta e do tenant na seção informações do perfil dentro do tenant. Consulte as informações do perfil.
   
   

   

   
   
2. Autorização. O campo de autorização deve ser preenchido com o token de autenticação gerado na etapa anterior.
   Importante: ao usar o token de autenticação, prefixe-o com Bearer , como na captura de tela abaixo.

Agora você pode acessar APIs específicas. Use sampleClassifierSkill para este exemplo. Na lista de Habilidades de ML, você pode ver que essa habilidade existe e está atualmente no estado Disponível .

Encontrar detalhes da Habilidade de ML

Usando a chamada GET ML Skills , você pode buscar uma lista de todas as Habilidades de ML dentro da conta e do tenant. Você também pode adicionar o nome da Habilidade de ML como parte da consulta para pesquisar uma Habilidade de ML específica e recuperar seus detalhes. Nesse caso, você encontra a Habilidade de ML idpara o sampleClassifierSkill

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

Na resposta abaixo, os campos-chave estão destacados em amarelo. Verifique novamente se o sampleClassifierSkill está no estado Disponível . A habilidade de ML id é usada nas APIs subsequentes para atualizar o estado.

Parar ML Skill

Para interromper uma Habilidade de ML:

• A consulta da solicitação deve conter a ação de atualização stop e a Habilidade de ML id
• O cabeçalho deve conter informações da conta, tenant e autenticação

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

A resposta mostra que a alteração do status da habilidade de ML foi bem-sucedida:

Verificando a UI, é possível verificar se a implantação de sampleClassifierSkill foi desfeita.

Retomar ML Skill

Para reiniciar (implantar) a Habilidade de ML, faça as chamadas de API com o updateType definido para Retomar.

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

Na resposta, você pode ver que a solicitação foi bem-sucedida, e o estado da habilidade foi atualizado para Implantando.

Aguarde a habilidade ficar disponível e verifique o status da habilidade de ML usando a API de detalhes do GET ML Skill .

A partir da resposta, a Habilidade de ML agora está implantada e disponível. Verifique a disponibilidade de habilidades na Interface Gráfica. Agora suas automações podem aproveitar a Habilidade de ML sampleClassifierSkill implantada dentro de fluxos de trabalho para fazer previsões.

Atualize a implantação da Habilidade de ML usando a API

Para acessar as APIs do AI Center:

1. Registrar um aplicativo externo (configuração única).
2. Gere um token de autenticação (renovado após a expiração).
3. Faça chamadas de API do AI Center.

Observação: as duas primeiras etapas impõem o controle de acesso, certificando-se de que seu aplicativo esteja registrado e autenticado. Para acessar o aplicativo, você deve registrar e autenticar o aplicativo. (etapas 1 e 2)

Registro de um aplicativo externo

Para usar essas APIs, seu aplicativo deve se registrar como um aplicativo externo dentro do escopo do AI Center.

1. Acesse a página Administrador no painel de navegação à esquerda e selecione Aplicativos externos.
2. Selecione + Adicionar aplicativo e dê a ele um nome, para adicionar um novo aplicativo externo.
   Observação: apenas o tipo de aplicativo confidencial pode acessar as APIs do AI Center.
3. Selecione Adicionar escopo para habilitar o escopo do AI Center para o aplicativo externo.
   • Escolha Acesso à API do AI Center (pré-visualização) no menu suspenso Recurso .
   • Acesse a guia Escopo do aplicativo e escolha as APIs que você deseja dar acesso aos aplicativos externos. No exemplo abaixo, você seleciona todas as APIs para simplificar.
     
     

     

     
     
4. Uma mensagem com o ID do aplicativo e um Segredo do aplicativo confirma que o aplicativo foi adicionado com sucesso. Consulte o ID do aplicativo e Segredo do aplicativo a qualquer momento em Editar aplicativo externo.
   Observação: use essas credenciais para gerar um token de autenticação na etapa seguinte.
   
   

   

   
   

Verifique a página Gerenciando aplicativos externos para mais informações.

Gerar um token de autenticação

O aplicativo externo deve solicitar um token de acesso do servidor de identidade da UiPath para autenticação e acesso seguro.

Observação: O token de autenticação expira em uma hora. Após este período, você precisará gerar um novo.

Por uma questão de simplicidade, usamos o Postman neste tutorial. Você pode registrar 10 tokens gratuitamente e usar sua interface web, aplicativo ou qualquer outra ferramenta.

Gere uma solicitação POST para o endpoint do Identity Server que inclua o seguinte no corpo da solicitação:

• client_id: ID do aplicativo da etapa anterior.
• client_secret: segredo do aplicativo da etapa anterior.
• grant_type: client_credentials.

Selecione application/x-www-form-urlencoded como o tipo de conteúdo se você estiver usando o Postman.

Essa solicitação cria um token de autenticação, usado para chamadas da API do AI Center:

Você também pode ver as permissões habilitadas para esse aplicativo externo.

Verifique as informações adicionais sobre credenciais e tokens de autenticação na página Aplicativos externos (OAuth) .

Fazendo chamadas de API do AI Center

As chamadas de API seguem a estrutura https://cloud.uipath.com/accountname/tenantname/aifabric_/ 10 , em que accountname e tenantname são específicos para sua conta.

A maioria das APIs precisa das seguintes informações:

• Account ID e Tenant ID. Verifique os detalhes da conta e do tenant na seção de informações do perfil dentro do tenant.
  
  

  

  
  
• Authorization. O campo de autorização é preenchido com o token de autenticação gerado na etapa anterior.

Agora você pode acessar APIs específicas.

Na lista de Habilidades de ML, sampleClassifierSkill (usado como um exemplo) está atualmente no estado Disponível.

Use as APIs do AI Center para:

• Encontre o ID da habilidade de ML de sampleClassifierSkill.
• Interromper (desfazer a implantação) a Habilidade de ML.
• Inicie ( reimplantar ) e verifique a atualização do status.

Encontrar detalhes da Habilidade de ML

Com a chamada GET ML Skills , você pode recuperar todas as Habilidades de ML em sua conta e tenant.

Para encontrar uma Habilidade de ML específica e obter seus detalhes, inclua seu nome na consulta: GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

Nesse caso, encontramos o ID da Habilidade de ML para o sampleClassifierSkill.

Observação: ao usar o token de autenticação, prefixe ele com Bearer.

Na resposta abaixo, os campos-chave estão destacados em amarelo. Use o ID ML Skill no seguinte APIs para modificar o estado:

Atualizar réplicas de Habilidade de ML

Use a chamada UPDATE ML Skill para modificar a configuração da implantação em uma habilidade de ML específica.

No exemplo abaixo, alteramos a contagem de réplicas incluindo o novo número no corpo da solicitação.