ML-Skills

In diesem Abschnitt finden Sie Beispiele zur Verwendung von ML-Fähigkeiten.

Sparen Sie Infrastrukturkosten mithilfe von AI Center-APIs

Mit den API-Anforderungen können Sie den Status einer ML-Fähigkeit programmatisch ändern. Diese APIs können sogar innerhalb eines Automatisierungsworkflows verwendet werden, um eine ML-Fähigkeit bereitzustellen und die Bereitstellung aufzuheben, wodurch die Verfügbarkeit der Infrastruktur optimiert und Kosten eingespart werden. Den vollständigen Satz von AI Center-APIs finden Sie unter Swagger dokumentiert.

Beachten Sie, dass accountname und tenantname spezifisch für Ihr Konto sind. Weitere Informationen finden Sie in der API- Liste.

Sie können die AI Center-APIs verwenden, um:

1. ML-Fähigkeits-ID von sampleClassifierSkillfinden
2. Die ML-Fähigkeit anhalten (bereitstellen)
3. Starten (erneute Bereitstellung) und überprüfen Sie die Statusaktualisierung.

Im November 2022 haben wir die Verfügbarkeit von APIs für die programmatische Interaktion mit jeder Komponente im AI Center angekündigt. Sie können jetzt Datasets verwalten, ML-Modelle trainieren und ML-Fähigkeiten mithilfe von APIs bereitstellen, ohne die Benutzeroberfläche verwenden zu müssen.

Einer der wichtigsten Anwendungsfälle für die Nutzung von APIs ist die Verwaltung des Bereitstellungsstatus einer ML-Fähigkeit. Je nach Automatisierung benötigen Sie möglicherweise nicht eine ML-Fähigkeit, um die ganze Zeit aktiv zu sein. Wenn Sie ML-Fähigkeiten nicht mehr bereitstellen, wenn sie nicht verwendet werden, können Sie Hardwarekosten (AI Units) sparen.

Dies sind die Schritte für den Zugriff auf AI Center-APIs:

1. Registrieren einer externen Anwendung (einmalige Einrichtung)
2. Generieren eines Authentifizierungstokens (Verlängerung bei Ablauf)
3. Ausführen von AI Center API-Aufrufen

Hinweis: Die ersten beiden Schritte erzwingen die Zugriffssteuerung, indem sie sicherstellen, dass Ihre Anwendung registriert und authentifiziert ist

Registrieren einer externen Anwendung

Um die APIs zu verwenden, muss Ihre App als externe Anwendung mit einem AI Center-Scope registriert sein.

1. Gehen Sie im linken Navigationsbereich zur Seite Admin und wählen Sie External Applications aus.
2. Um eine neue externe Anwendung hinzuzufügen, wählen Sie + Add Applicationaus.

   und benennen Sie sie.

   Hinweis: Nur der Typconfidential application kann auf AI Center-APIs zugreifen.
3. So aktivieren Sie den AI Center-Scope für die externe Anwendung:
   1. Add scope auswählen
   2. Wählen Sie AI Center API Access (preview) aus der Dropdownliste Ressource aus
   3. Navigieren Sie zur Registerkarte Application Scope
   4. Wählen Sie die APIs aus, für die Sie den Zugriff aktivieren möchten.
   Im folgenden Beispiel sind der Einfachheit halber alle APIs ausgewählt, aber Sie können bestimmten APIs den Zugriff auf bestimmte externe Anwendungen zuweisen.
   
   

   

   
   
4. Wählen Sie Add. Ein Popup mit der App-ID und einem geheimen App-Schlüssel wird generiert.
   Tipp: Sie können die App-ID und den Geheimen App-Schlüssel jederzeit über Externe Anwendung bearbeiten anzeigen. Diese Anmeldeinformationen werden verwendet, um im nächsten Schritt ein Authentifizierungstoken zu generieren. Weitere Informationen zum Verwalten externer Anwendungen finden Sie hier.
   
   

   

   
   

Generieren eines Authentifizierungstokens

Für die Authentifizierung und den sicheren Zugriff fordert die externe Anwendung ein Zugriffstoken vom UiPath Identity-Server an. Das generierte Authentifizierungstoken läuft nach einer Stunde ab. Daraufhin müssen Sie ein neues Authentifizierungstoken neu generieren.

Wenn Sie Postman verwenden möchten, können Sie sich kostenlos registrieren und entweder die webbasierte Postman-Schnittstelle oder die herunterladbare Anwendung verwenden. Siehe die offizielle Postman- Website.

1. Generieren Sie eine POST-Anforderung an den Identity Server-Endpunkt https://cloud.uipath.com/identity_/connect/token , die Folgendes im Textkörper der Anforderung enthält.

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

2. Legen Sie grant_type auf client_credentials fest.

Verwenden Sie den Inhaltstyp application/x-www-form-urlencoded für Postman.

Diese Anforderung generiert ein Authentifizierungstoken ähnlich dem folgenden, das die für diese externe Anwendung aktivierten Berechtigungen auflistet. Verwenden Sie dieses Authentifizierungstoken, wenn Sie AI Center API-Aufrufe durchführen.

Siehe zusätzliche Informationen zu Anmeldeinformationen und Authentifizierungstoken.

Ausführen von AI Center API-Aufrufen

Die API-Aufrufe haben die folgende Struktur: https://cloud.uipath.com/accountname/tenantname/aifabric_/ wobei „ accountname “ und „ tenantname“ spezifisch für Ihr Konto sind. Die meisten APIs benötigen die folgenden Informationen:

1. Konto-ID und Mandanten-ID. Sie finden die Konto- und Mandanteninformationen im Abschnitt „Profilinformationen“ innerhalb des Mandanten. Siehe Profilinformationen.
   
   

   

   
   
2. Autorisierung. Das Autorisierungsfeld muss mit dem Authentifizierungstoken ausgefüllt werden, das im vorherigen Schritt generiert wurde.
   Wichtig: Wenn Sie das Authentifizierungstoken verwenden, stellen Sie ihm Bearer wie im folgenden Screenshot voran.

Jetzt können Sie auf bestimmte APIs zugreifen. Verwenden Sie für dieses Beispiel sampleClassifierSkill . In der Liste der ML-Fähigkeiten können Sie sehen, dass diese Fähigkeit vorhanden ist und sich derzeit im Status „ Verfügbar “ befindet.

Suchen Sie Details zur ML-Fähigkeit

Mit dem Aufruf GET ML Skills können Sie eine Liste aller ML-Fähigkeiten innerhalb des Kontos und des Mandanten abrufen. Sie können den Namen der ML-Fähigkeit auch als Teil der Abfrage hinzufügen, um nach einer bestimmten ML-Fähigkeit zu suchen und ihre Details abzurufen. In diesem Fall finden Sie die ML-Fähigkeit idfür den sampleClassifierSkill

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

In der folgenden Antwort sind die wichtigsten Felder gelb hervorgehoben. Vergewissern Sie sich, dass sich sampleClassifierSkill im Status „Verfügbar “ befindet. Die ML-Fähigkeit id wird in den nachfolgenden APIs verwendet, um den Status zu aktualisieren.

ML-Fähigkeit beenden

So beenden Sie eine ML-Fähigkeit:

• Die Anforderungsabfrage muss die Aktualisierungsaktion stop und die ML-Fähigkeit identhalten.
• Der Header muss Konto-, Mandanten- und Authentifizierungsinformationen enthalten

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

Die Antwort zeigt, dass die Statusänderung der ML-Fähigkeit erfolgreich war:

Auf der Benutzeroberfläche können Sie überprüfen, ob sampleClassifierSkill nicht bereitgestellt wurde.

ML-Fähigkeit fortsetzen

Um die ML-Fähigkeit neu zu starten (bereitstellen), führen Sie die API-Aufrufe aus, wobei updateType auf Fortsetzen festgelegt ist.

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

An der Antwort können Sie sehen, dass die Anforderung erfolgreich war und der Fähigkeitsstatus auf Wird bereitgestellt aktualisiert wurde.

Warten Sie, bis die Fähigkeit verfügbar ist, und überprüfen Sie den Status der ML-Fähigkeit mithilfe der GET ML Skill Detail-API.

Aus der Antwort wird die ML-Fähigkeit jetzt bereitgestellt und ist verfügbar. Überprüfen Sie die Verfügbarkeit der Fähigkeit in der UI. Jetzt können Ihre Automatisierungen die bereitgestellte ML-Fähigkeit sampleClassifierSkill in Workflows nutzen, um Vorhersagen zu treffen.

Aktualisieren Sie die Bereitstellung von ML-Fähigkeiten mithilfe der API

So greifen Sie auf die AI Center-APIs zu:

1. Registrieren Sie eine externe Anwendung (einmalige Einrichtung).
2. Generieren Sie ein Authentifizierungstoken (erneuern Sie es bei Ablauf).
3. AI Center API-Aufrufe ausführen.

Hinweis: Die ersten beiden Schritte erzwingen die Zugriffssteuerung, indem sie sicherstellen, dass Ihre Anwendung registriert und authentifiziert ist. Um auf die Anwendung zuzugreifen, müssen Sie die Anwendung registrieren und authentifizieren. (Schritt 1 und 2)

Registrieren einer externen Anwendung

Um diese APIs zu verwenden, muss sich Ihre App als externe Anwendung im AI Center-Scope registrieren.

1. Wechseln Sie im linken Navigationsbereich zur Seite Administrator und wählen Sie Externe Anwendungen aus.
2. Wählen Sie + Anwendung hinzufügen aus, und geben Sie ihr einen Namen, um eine neue externe Anwendung hinzuzufügen.
   Hinweis: Nur der vertrauliche Anwendungstyp kann auf die AI Center-APIs zugreifen.
3. Wählen Sie Scope hinzufügen aus, um den AI Center-Scope für die externe Anwendung zu aktivieren.
   • Wählen Sie AI Center API-Zugriff (Vorschau) von der Dropdownliste Ressource aus.
   • Wechseln Sie zur Registerkarte Anwendungs-Scope und wählen Sie die APIs aus, die Sie Zugriff auf externe Anwendungen gewähren möchten. Im folgenden Beispiel wählen Sie der Einfachheit halber alle APIs aus.
     
     

     

     
     
4. Ein Popup mit der App-ID und einem geheimen App-Schlüssel bestätigt, dass die Anwendung erfolgreich hinzugefügt wurde. Überprüfen Sie die App-ID und den Geheimen App-Schlüssel jederzeit über „Externe Anwendung bearbeiten“.
   Hinweis: Verwenden Sie diese Anmeldeinformationen, um im nächsten Schritt ein Authentifizierungstoken zu generieren.
   
   

   

   
   

Weitere Informationen finden Sie auf der Seite Verwalten externer Anwendungen .

Generieren eines Authentifizierungstokens

Die externe Anwendung muss ein Zugriffstoken vom UiPath Identity-Server zur Authentifizierung und zum sicheren Zugriff anfordern.

Hinweis: Das Authentifizierungstoken läuft nach einer Stunde ab. Nach dieser Zeit müssen Sie eine neue generieren.

Der Einfachheit halber verwenden wir Postman in diesem Tutorial. Sie können 10 Token kostenlos registrieren und deren Webschnittstelle, Anwendung oder ein anderes Tool verwenden.

Generieren Sie eine POST-Anforderung an den Identity Server -Endpunkt , die Folgendes im Textkörper der Anforderung enthält:

• client_id: App-ID aus dem vorherigen Schritt.
• client_secret: Geheimer App-Schlüssel aus dem vorherigen Schritt.
• grant_type: client_credentials.

Wählen Sie application/x-www-form-urlencoded als Inhaltstyp aus, wenn Sie Postman verwenden.

Diese Anforderung erstellt ein Authentifizierungstoken, das für AI Center API-Aufrufe verwendet wird:

Sie können auch die Berechtigungen sehen, die für diese externe Anwendung aktiviert sind.

Überprüfen Sie die zusätzlichen Informationen zu Anmeldeinformationen und Authentifizierungstokens auf der Seite Externe Anwendungen (OAuth) .

Ausführen von AI Center API-Aufrufen

Die API-Aufrufe folgen der https://cloud.uipath.com/accountname/tenantname/aifabric_/ 10- Struktur, wobei accountname und tenantname spezifisch für Ihr Konto sind.

Die meisten APIs benötigen die folgenden Informationen:

• Account ID und Tenant ID. Überprüfen Sie die Konto- und Mandantendetails im Abschnitt mit den Profilinformationen innerhalb des Mandanten.
  
  

  

  
  
• Authorization. Das Autorisierungsfeld wird mit dem Authentifizierungstoken ausgefüllt, das im vorherigen Schritt generiert wurde.

Sie können jetzt auf bestimmte APIs zugreifen.

In der Liste der ML-Fähigkeiten befindet sich sampleClassifierSkill (als Beispiel) derzeit im Status Verfügbar.

Verwenden Sie die AI Center-APIs für Folgendes:

• Suchen Sie die ML-Fähigkeits-ID von sampleClassifierSkill.
• Die ML-Fähigkeit anhalten (bereitstellen)
• Starten (erneute Bereitstellung) und überprüfen Sie die Statusaktualisierung.

Suchen Sie Details zur ML-Fähigkeit

Mit dem Aufruf GET ML Skills können Sie alle ML-Fähigkeiten in Ihrem Konto und Mandanten abrufen.

Um eine bestimmte ML-Fähigkeit zu finden und ihre Details abzurufen, geben Sie ihren Namen in die Abfrage ein: GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

In diesem Fall finden wir die ML-Fähigkeits-ID für sampleClassifierSkill.

Hinweis: Wenn Sie das Authentifizierungstoken verwenden, stellen Sie ihm Bearer.

In der folgenden Antwort sind die wichtigsten Felder gelb hervorgehoben. Verwenden Sie die ID ML Skill in der folgenden APIs , um den Status zu ändern:

Aktualisieren Sie die ML-Fähigkeiten-Replikate

Verwenden Sie den Aufruf UPDATE ML Skill , um die Bereitstellungskonfiguration für eine bestimmte ML-Fähigkeit zu ändern.

Im folgenden Beispiel ändern wir die Replikatanzahl, indem wir die neue Zahl in den Anforderungstext aufnehmen.