---
title: Verbinden und steuern Sie Agent Apps
description: Finden Sie eine Agent App, wählen Sie ihre zulässigen Tools aus, verbinden Sie sie und verwalten Sie den Zugriff.
---

Agent Apps ermöglichen es dem Runner Agent, einen externen Dienst zu nutzen, während er an Ihrem Projekt arbeitet. Sie
können die Tools der App überprüfen und Tools ausschalten, die der Agent nicht verwenden soll.

## Bevor Sie beginnen

**Eingabepfad:** **Projekt → Apps → Agent Apps**

Agent Apps sind bedingt. Der Abschnitt kann verborgen sein, eine einzelne App kann nicht verfügbar sein oder
der Katalog kann nicht geladen werden. Die Verfügbarkeit kann je nach Arbeitsbereich, Projekt,
Anbieter und gestaffeltem Produktzugriff variieren.

Sie benötigen:

- Zugriff auf das Projekt;
- ein Konto oder Anmeldedaten, die vom ausgewählten Anbieter akzeptiert werden; und
- die Berechtigung, Runner die Tools zu verwenden, die Sie aktiviert lassen.

Überprüfen Sie jeden Tool, bevor Sie verbinden. Der Tool-Zugriff gilt für das aktuelle Projekt und kann
dem Agent ermöglichen, Daten im externen Dienst zu lesen oder zu ändern.

Die externe Kontoverbindung gehört zu Ihrem angemeldeten Runner-Konto, während Tool-Schalter
für das aktuelle Projekt gespeichert werden. Das Trennen kann daher die Verbindung entfernen, die von
anderen Projekten verwendet wird, obwohl ihre Tool-Auswahl separat ist.

## Finden und überprüfen Sie eine App

| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert danach |
| --- | --- | --- |
| **Apps durchsuchen** | Filtert Store Apps und Agent Apps zusammen. | Der Katalog zeigt passende Namen und Beschreibungen. |
| Kategorienwähler | Verengt den Agent Apps-Katalog. | Wählen Sie **Alle**, um den Kategoriefilter zu entfernen. |
| **Zurück** und **Weiter** | Bewegt sich durch einen langen Katalog. | Runner zeigt die vorherige oder nächste Seite passender Apps. |
| App-Karte | Zeigt den App-Namen, die Beschreibung und den Verbindungsstatus. | Die Auswahl öffnet **App-Details**. |
| **Keine Apps gefunden** | Zeigt, dass aktuelle Filter keine Übereinstimmung haben. | **Suche löschen** setzt die Suche und Kategorie zurück. |
| Lade-Platzhalter | Zeigt, dass Runner den Katalog abruft. | Warten Sie auf Karten, bevor Sie eine App auswählen. |

## App-Details-Steuerelemente

| Steuerelement oder Zustand | Warum es nützlich ist | Was passiert danach |
| --- | --- | --- |
| App-Beschreibung und Kategorie | Hilft zu bestätigen, dass Sie den beabsichtigten Dienst geöffnet haben. | Kein externer Zugriff wird durch das Anzeigen von Details gewährt. |
| Tool-Schalter | Begrenzt, was Runner den verbundenen App zu tun bitten kann. | Vor dem Verbinden speichert Runner Ihre Auswahl mit der Verbindung. Nach dem Verbinden wird eine Änderung sofort gespeichert. |
| **Zurück** und **Weiter** in der Tool-Liste | Überprüft Apps mit vielen Tools. | Bewegt sich durch Tools, ohne den Dialog zu schließen. |
| Erforderliche Anmeldedatenfelder | Unterstützt Apps, die keine Browser-Autorisierung verwenden. | **Verbinden** bleibt nicht verfügbar, bis erforderliche Felder ausgefüllt sind. Geheimnisähnliche Felder sind maskiert. |
| **Verbinden** | Reicht Anbieter-Anmeldedaten ein, wenn diese Strategie erforderlich ist. | Runner versucht die Verbindung mit Ihrem gewählten Tool-Zugriff. |
| **Verbinden & Autorisieren** | Startet die Anbieter-Autorisierung. | Runner öffnet ein Autorisierungsfenster. |
| **Verbindung wird hergestellt...** | Zeigt, dass die Autorisierung läuft. | Die Aktion bleibt nicht verfügbar, bis Runner ein Ergebnis erhält. |
| **Verbunden** | Bestätigt, dass Runner das Konto erkennt. | Schließen Sie den Dialog oder verwalten Sie den Tool-Zugriff. |
| **Verwalten** | Öffnet eine verbundene App erneut. | Überprüfen und ändern Sie ihre aktivierten Tools oder trennen Sie sie. |
| **Trennen** | Startet die Entfernung. | Runner fragt **Sind Sie sicher, dass Sie trennen möchten?** |
| **Abbrechen** oder **Bestätigen** | Löst die Trennwarnung auf. | Abbrechen behält den Zugriff; Bestätigen entfernt die Agent App-Verbindung auf Kontoebene von Runner. Projekt-Tool-Einstellungen sind separat. |

## Verbinden Sie eine Agent App

1. Öffnen Sie **Projekt → Apps** und scrollen Sie zu **Agent-Apps**.
2. Suchen Sie die App oder wählen Sie eine Kategorie.
3. Wählen Sie die App-Karte aus, um **App-Details** zu öffnen.
4. Lesen Sie ihre Beschreibung und überprüfen Sie jeden verfügbaren Tool.
5. Schalten Sie jeden Tool aus, den Runner in diesem Projekt nicht verwenden sollte.
6. Geben Sie erforderliche Anbieter-Anmeldedaten ein oder wählen Sie **Verbinden & Autorisieren**.
7. Schließen Sie den Anbieter-Schritt ab. Wenn Ihr Browser das Autorisierungsfenster blockiert, erlauben Sie das
   Popup für Runner und starten Sie erneut.
8. Kehren Sie zum Dialog zurück und bestätigen Sie, dass es **Verbunden** sagt.
9. Wählen Sie später **Verwalten**, um den Tool-Zugriff zu überprüfen oder die App zu trennen.

Der Verbindungsdialog besagt, dass Anbieter-Anmeldedaten durch den Verbindungsdienst gesendet werden und nicht
von Runner gespeichert werden. Sie sollten dennoch jede Anmeldedaten als Geheimnis behandeln
und sie nur in den Anmeldedatenfeldern der App eingeben.

## Ändern Sie den Tool-Zugriff

1. Wählen Sie **Verwalten** auf der verbundenen App.
2. Finden Sie den Tool, den Sie ändern möchten.
3. Schalten Sie seinen Schalter ein oder aus.
4. Warten Sie auf **Tool aktiviert** oder **Tool deaktiviert**.
5. Wenn Runner **Fehler beim Aktualisieren des Tools** anzeigt, lassen Sie den Dialog offen, überprüfen Sie den aktuellen
   Schalter nach dem Aktualisieren und versuchen Sie es nur erneut, wenn der gespeicherte Zustand klar ist.

Das Deaktivieren eines Tools begrenzt Runners Verwendung dieses Tools. Es löscht keine Daten, die zuvor
im externen Dienst erstellt wurden.

## Reparieren oder trennen Sie eine Verbindung

Wenn der Katalog keine verwendbare Verbindung mehr anzeigt, öffnen Sie die App und starten Sie **Verbinden** oder
**Verbinden & Autorisieren** erneut, und bestätigen Sie dann **Verbunden**.

Um den Zugriff zu entfernen, wählen Sie **Verwalten → Trennen**, überprüfen Sie die Bestätigung und wählen Sie
**Bestätigen**. Dies entfernt die Agent App-Verbindung des angemeldeten Kontos, nicht nur den Tool-Zugriff des aktuellen
Projekts. Wenn das Trennen fehlschlägt, behält Runner den verbundenen Zustand; gehen Sie nicht davon aus, dass das
externe Konto entfernt wurde.

## Wenn Agent Apps fehlen

- Die Funktion ist möglicherweise nicht für den Arbeitsbereich aktiviert.
- Löschen Sie die Suche und setzen Sie die Kategorie auf **Alle**.
- Aktualisieren Sie Apps, wenn der Katalog seinen Ladezustand nie verlässt.
- Eine einzelne App kann melden, dass sie noch nicht verbunden werden kann.
- Wenn die Tools-Liste fehlschlägt, wählen Sie **Erneut versuchen** in **App-Details**.
- Keine spezifische Katalogeinträge sollten versprochen werden, bis sie im aktuellen Arbeitsbereich angezeigt werden.

## Verwandte Leitfäden

- [Apps und Integrationen Übersicht](../apps-and-integrations)
- [Verbinden, verwalten und erneut verbinden Sie eine App](./connect-manage-reconnect)
- [Fehlerbehebung bei einer App-Verbindung](./troubleshooting)