Verbinden und steuern Sie Agent Apps
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
- Öffnen Sie Projekt → Apps und scrollen Sie zu Agent-Apps.
- Suchen Sie die App oder wählen Sie eine Kategorie.
- Wählen Sie die App-Karte aus, um App-Details zu öffnen.
- Lesen Sie ihre Beschreibung und überprüfen Sie jeden verfügbaren Tool.
- Schalten Sie jeden Tool aus, den Runner in diesem Projekt nicht verwenden sollte.
- Geben Sie erforderliche Anbieter-Anmeldedaten ein oder wählen Sie Verbinden & Autorisieren.
- Schließen Sie den Anbieter-Schritt ab. Wenn Ihr Browser das Autorisierungsfenster blockiert, erlauben Sie das Popup für Runner und starten Sie erneut.
- Kehren Sie zum Dialog zurück und bestätigen Sie, dass es Verbunden sagt.
- 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
- Wählen Sie Verwalten auf der verbundenen App.
- Finden Sie den Tool, den Sie ändern möchten.
- Schalten Sie seinen Schalter ein oder aus.
- Warten Sie auf Tool aktiviert oder Tool deaktiviert.
- 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.