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 da 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.