> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UiPath Automation Hub

> Verbinde UiPath Automation Hub mit Langdock, verstehe Open-API-Berechtigungen und richte Katalog- und CoE-Verbindungen mit minimalen Berechtigungen ein

## Überblick

UiPath Automation Hub ist der Ort, an dem deine Organisation Automatisierungsideen sammelt und durch die Pipeline steuert. Nach der Verbindung kannst du über Langdock Ideen suchen, Kategorien und Anwendungen durchsuchen, Phase und Status in der Pipeline prüfen und bei Bedarf Cost-Benefit- oder Collaborator-Details abrufen, direkt aus deinen Conversations.

<Info>
  **Authentifizierung:** API Key (persönliches oder user-assigned Open-API-Token)<br />
  **Kategorie:** Knowledge Base<br />
  **Verfügbarkeit:** Alle Workspace-Pläne<br />
  **Unterstütztes Deployment:** Nur UiPath Automation Cloud
</Info>

## Voraussetzungen

* Eine UiPath Automation Cloud Organisation mit aktiviertem Automation Hub
* Zugriff auf **Admin Console → Platform Setup → Open API**, um ein Token zu erstellen oder zu kopieren
* Ein **persönliches** oder **user-assigned** Open-API-Token (Tenant-Level-Tokens können Automations nicht suchen)

## Einrichtung

<Steps>
  <Step title="Automation Hub Cloud URL kopieren">
    Öffne Automation Hub im Browser und kopiere die URL. Eine typische URL sieht so aus: `https://cloud.uipath.com/mycompany/DefaultTenant/automationhub_/...`. Langdock extrahiert Organisation und Tenant aus dieser URL. Du kannst auch nur den Organisationsnamen eingeben (der Tenant ist dann `DefaultTenant`) oder `org/tenant`.

    <Note>
      Es werden nur UiPath Automation Cloud URLs akzeptiert. Automation Suite und andere Self-Hosted-Hosts werden abgelehnt.
    </Note>
  </Step>

  <Step title="Persönliches Open-API-Token erzeugen">
    Geh in Automation Hub zu **Admin Console → Platform Setup → Open API** und erstelle oder wähle ein **persönliches** oder **user-assigned** Token. Nutze **Copy to Clipboard** neben dem Token, damit du den kombinierten `Tenant ID/Token`-Wert erhältst.

    Die genauen UI-Schritte stehen in [UiPaths Token-Guide](https://docs.uipath.com/automation-hub/automation-cloud/latest/api-guide/generate-your-token-from-automation-hub). Wenn du beim Erstellen einen App Key gesetzt hast, kopiere diesen ebenfalls.
  </Step>

  <Step title="Zu Integrationen in Langdock navigieren">
    Geh zu [Integrationen](https://app.langdock.com/integrations) und suche **UiPath Automation Hub**.
  </Step>

  <Step title="Zugangsdaten eingeben">
    Füge die Cloud URL, das Open-API-Credential (`Tenant ID/Token`) und ggf. den App Key ein. Lass das Feld leer, wenn du keinen App Key gesetzt hast.
  </Step>

  <Step title="Automation Hub in Langdock verwenden">
    Tagge die Integration mit `@` in einem beliebigen Agenten, um Ideen zu suchen, Pipeline-Kontext nachzuschlagen oder Kategorien und Anwendungen zu durchsuchen.
  </Step>
</Steps>

## Berechtigungen & Token-Management

Anders als Microsoft- oder Google-Integrationen unterstützt Automation Hub kein delegiertes per-User-OAuth. Dieser Abschnitt erklärt, was das bedeutet und wie du Tokens sicher verwaltest.

### Berechtigungstypen verstehen

| Modell                | Wer handelt                                           | Typische Langdock-Integrationen | Automation Hub  |
| --------------------- | ----------------------------------------------------- | ------------------------------- | --------------- |
| **Delegiert (OAuth)** | Angemeldeter Endnutzer                                | Microsoft, Google und ähnliche  | Nicht verfügbar |
| **Open-API-Token**    | Der Automation-Hub-User, dem das Token zugeordnet ist | (diese Integration)             | Erforderlich    |

<Info>
  **Langdock nutzt die Automation-Hub-Berechtigungen des Token-Users.** Jeder Request läuft als der User, dem das Open-API-Token zugeordnet ist, mit dessen Kategoriezugriff und Rollenberechtigungen. Langdock fügt keine eigene Privacy-Schicht hinzu und entfernt privilegierte Felder nicht.
</Info>

Die Open API von Automation Hub authentifiziert sich mit einem statischen Token, das ein Automation-Hub-Admin unter **Admin Console → Platform Setup → Open API** erzeugt. Einen Zustimmungsschritt pro User gibt es in Langdock nicht. Wer das verbundene Token nutzt, sieht das, was dieser Automation-Hub-User bereits in der UI sehen darf.

<Warning>
  Wenn der Token-User in Automation Hub Cost-Benefit-Analyse, Collaborators oder Detailed-Assessment-Daten sehen darf, können die zugehörigen Langdock-Actions diese Daten zurückgeben, sobald sie aktiviert sind.
</Warning>

### Empfohlene Einrichtung

Lege **getrennte Verbindungen** für den regulären Katalogzugriff und für privilegierte Arbeit des Center of Excellence (CoE) an. Verwende kein hochprivilegiertes CoE-Token als Standardverbindung für alle.

```mermaid theme={null}
flowchart LR
  subgraph AH["Automation Hub"]
    RU["Dedizierter regulärer User<br/>begrenzte Rollen + Kategorien"]
    COE["CoE / privilegierter User<br/>mehr Berechtigungen"]
  end
  subgraph LD["Langdock"]
    C1["Katalog-Verbindung"]
    C2["CoE-Verbindung"]
    A1["Geteilt oder fest im Agenten<br/>für reguläre User"]
    A2["Nur CoE-Agenten<br/>oder Workflows"]
  end
  RU -->|persönliches / user-assigned Token| C1 --> A1
  COE -->|separates Token| C2 --> A2
```

### Katalog-Verbindung für reguläre User

1. Erstelle einen Automation-Hub-User, dessen Rollen und Kategoriezugriff dem entsprechen, was reguläre Langdock-User sehen dürfen.
2. Vergib nur die Berechtigungen, die für Suche und grundlegende Ideen-Details nötig sind. Lass Berechtigungen für Cost-Benefit-Analyse, Collaborators und Detailed Assessment weg, sofern du sie nicht bewusst freigeben willst.
3. Erzeuge ein **persönliches** oder **user-assigned** Open-API-Token für diesen User (kein Tenant-Level-Token).
4. Verbinde es in Langdock und nutze eine der folgenden Optionen:
   * **Verbindung teilen** mit den Personen oder Gruppen, die den Katalog nutzen sollen ([Nicht-OAuth-Verbindungen direkt teilen](/de/using-langdock/integrations/connections#nicht-oauth-verbindungen-direkt-teilen)), oder
   * **Als feste Verbindung auf einem Agenten vorauswählen** ([Verbindungen über Agenten teilen](/de/using-langdock/integrations/connections#verbindungen-über-agenten-teilen)).

Beide Wege begrenzen die Sichtbarkeit auf das, was der dedizierte User in Automation Hub sehen darf. Strenger lässt sich die Sichtbarkeit über die API nicht steuern.

### CoE-Verbindung

Das CoE oder ein anderes privilegiertes Team kann zusätzlich **ein eigenes** Open-API-Token für einen User mit mehr Automation-Hub-Berechtigungen anlegen. Nutze diese Verbindung nur auf CoE-spezifischen Agenten oder Workflows.

### Was ein eingeschränktes Token sehen kann

| Erwartung                                  | Was passiert                                                                                                                            |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Kategoriebezogene Ideen**                | Ein typisches Standard-User-Token ohne CoE-Berechtigungen liefert nur Ideen aus Kategorien, die dieser User sehen kann                  |
| **Vollständiger Live- / Deployed-Katalog** | In der Regel unvollständig, es sei denn Explore oder die Kategorie-Sichtbarkeit zeigt diese Ideen dem User bereits                      |
| **Pipeline-Tabellen**                      | User ohne CoE-Berechtigungen haben meist keinen vollständigen Zugriff auf die Ansichten All / Review / Decision / Implementation / Live |
| **Privilegierte Felder**                   | Cost-Benefit-Analyse, Collaborators und Detailed Assessment bleiben über Automation-Hub-Berechtigungen gesteuert                        |

### Was jede Action zurückgeben kann

| Action                                      | Typische Daten                                                                                        | Hinweis zu Berechtigungen                                                                                          |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Search automations**                      | Name, Beschreibung, Phase/Status, Kategorien, Apps, Scores, geschätzte Benefit Hours, Submitter/Owner | Optional **Include advanced assessment** liefert Detailed-Assessment-Q\&A, sofern Automation Hub es erlaubt        |
| **Get automation**                          | Dieselben Kernfelder für eine Idee                                                                    | Optional Documents, Components und Collaborators; Collaborators brauchen View Idea Collaborators in Automation Hub |
| **List categories** / **List applications** | Taxonomie für Filter und Discovery                                                                    | Folgt dem, was der Token-User sehen darf                                                                           |
| **List idea flows**                         | Tenant-Phasen und Status (Namen/Keys)                                                                 | Zusammen mit Search-Ergebnissen für numerische Phase-/Status-IDs nutzen                                            |
| **Get cost-benefit analysis**               | Cost-Benefit-Zusammenfassung für eine Idee                                                            | Erfordert View Cost Benefit Analysis in Automation Hub                                                             |

Polling-Trigger (**New automation**, **Updated automation**) erben dieselbe Sichtbarkeit: Sie sehen nur Ideen, auf die der Token-User bereits Zugriff hat.

Aktiviere für die Katalog-Verbindung nur die Actions, die du brauchst, und lass privilegierte Optionen deaktiviert, sofern sie nicht nötig sind: **Get cost-benefit analysis**, **Include collaborators** und **Include advanced assessment**.

## Häufige Anwendungsfälle

<CardGroup cols={2}>
  <Card title="Ideen entdecken" icon="magnifying-glass">
    Suche Automatisierungsideen nach Text, Phase, Status, Kategorie oder Anwendung
  </Card>

  <Card title="Pipeline-Kontext" icon="diagram-project">
    Schlage aktuelle Phase und Status einer Idee nach, plus Kategorien und Apps
  </Card>

  <Card title="Taxonomie durchsuchen" icon="folder-tree">
    Liste Kategorien und Anwendungen, um die Organisation der Ideen zu verstehen
  </Card>

  <Card title="Auf Änderungen reagieren" icon="bell">
    Triggere Workflows, wenn Ideen innerhalb der Sichtbarkeit des Token-Users erstellt oder aktualisiert werden
  </Card>
</CardGroup>

## Fehlerbehebung

| Problem                                           | Lösung                                                                                                                                                    |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen**              | Prüfe, dass das Open-API-Credential der vollständige `Tenant ID/Token`-Wert von Copy to Clipboard ist und das Token noch aktiv sowie nicht abgelaufen ist |
| **Search liefert weniger Ideen als erwartet**     | Dem Token-User fehlt möglicherweise Kategorie- oder Explore/Pipeline-Sichtbarkeit für diese Ideen. Prüfe, was dieser User in der Automation-Hub-UI sieht  |
| **Tenant-Level-Token-Fehler bei Search**          | Nutze stattdessen ein persönliches oder user-assigned Token. Tenant-Level-Tokens können Automations nicht suchen                                          |
| **Cost-Benefit oder Collaborators schlagen fehl** | Vergib die passende Automation-Hub-Berechtigung an den Token-User, oder lass diese Actions für einen Katalog mit minimalen Berechtigungen deaktiviert     |
| **Cloud URL abgelehnt**                           | Nutze eine Automation Cloud URL (`cloud.uipath.com/...`). Automation Suite und andere Hosts werden nicht unterstützt                                      |
| **App Key erforderlich**                          | Wenn das Token mit App Key erstellt wurde, füge ihn im App-Key-Feld in Langdock ein                                                                       |