Agent Apps verbinden en beheren
Zoek een Agent App, kies de toegestane tools en beheer de toegang.
Agent Apps stellen de Runner Agent in staat een externe service te gebruiken terwijl deze aan uw project werkt. U kunt de tools van de app inspecteren en tools uitschakelen die u niet wilt gebruiken.
Voordat u begint
Invoerpad: Project → Apps → Agent-apps
Agent Apps zijn voorwaardelijk. De sectie kan verborgen zijn, een afzonderlijke app kan niet beschikbaar zijn, of de catalogus kan niet laden. De beschikbaarheid kan variëren per werkruimte, project, provider en gefaseerde producttoegang.
U hebt nodig:
- toegang tot het project;
- een account of referentie die door de geselecteerde provider wordt geaccepteerd; en
- toestemming om Runner de tools te laten gebruiken die u ingeschakeld laat.
Controleer elke tool voordat u verbinding maakt. Tooltoegangis van toepassing op het huidige project en kan de Agent toestaan gegevens in de externe service te lezen of te wijzigen.
De externe accountverbinding behoort tot uw aangemelde Runner-account, terwijl toolschakelaars voor het huidige project worden opgeslagen. Het verbreken van de verbinding kan daarom de verbinding verwijderen die door andere projecten wordt gebruikt, ook al zijn hun toolkeuzes afzonderlijk.
Een app zoeken en inspecteren
| Besturingselement of status | Waarom het nuttig is | Wat gebeurt er vervolgens |
|---|---|---|
| Apps zoeken | Filtert Store Apps en Agent Apps samen. | De catalogus toont overeenkomende namen en beschrijvingen. |
| Categoriekiezer | Beperkt de Agent Apps-catalogus. | Kies Alles om het categoriefilter te verwijderen. |
| Vorige en Volgende | Navigeert door een lange catalogus. | Runner toont de vorige of volgende pagina met overeenkomende apps. |
| App-kaart | Toont de appnaam, beschrijving en verbindingsstatus. | Als u deze selecteert, opent u App-details. |
| Geen apps gevonden | Toont dat huidige filters geen overeenkomst hebben. | Zoekopdracht wissen stelt de zoekopdracht en categorie opnieuw in. |
| Laadplaceholders | Toont dat Runner de catalogus ophaalt. | Wacht op kaarten voordat u een app kiest. |
Besturingselementen voor app-details
| Besturingselement of status | Waarom het nuttig is | Wat gebeurt er vervolgens |
|---|---|---|
| App-beschrijving en categorie | Helpt u te bevestigen dat u de beoogde service hebt geopend. | Er wordt geen externe toegang verleend door details te bekijken. |
| Toolschakelaar | Beperkt wat Runner de verbonden app kan vragen te doen. | Voordat u verbinding maakt, slaat Runner uw keuzes op met de verbinding. Na verbinding wordt een wijziging onmiddellijk opgeslagen. |
| Vorige en Volgende in de toollijst | Bekijkt apps met veel tools. | Navigeert door tools zonder het dialoogvenster te sluiten. |
| Vereiste referentievelden | Ondersteunt apps die geen browserautorisatie gebruiken. | Verbinden blijft niet beschikbaar totdat vereiste velden zijn ingevuld. Velden die op geheimen lijken, zijn gemaskeerd. |
| Verbinden | Verzendt providerreferenties wanneer die strategie vereist is. | Runner probeert de verbinding met uw gekozen tooltoegangstatus. |
| Verbinden en autoriseren | Start providerautorisatie. | Runner opent een autorisatievenster. |
| Verbinding wordt tot stand gebracht... | Toont dat autorisatie in uitvoering is. | De actie blijft niet beschikbaar totdat Runner een resultaat ontvangt. |
| Verbonden | Bevestigt dat Runner het account herkent. | Sluit het dialoogvenster of beheer de tooltoegangstatus. |
| Beheren | Opent een verbonden app opnieuw. | Controleer en wijzig de ingeschakelde tools of verbreek de verbinding. |
| Verbinding verbreken | Start verwijdering. | Runner vraagt Weet u zeker dat u de verbinding wilt verbreken? |
| Annuleren of Bevestigen | Lost de verbreekingswaarschuwing op. | Annuleren behoudt toegang; Bevestigen verwijdert de Agent App-verbinding op accountniveau van Runner. Projecttoolinstellingen zijn afzonderlijk. |
Een Agent App verbinden
- Open Project → Apps en scrol naar Agent-apps.
- Zoek de app of kies een categorie.
- Selecteer de app-kaart om App-details te openen.
- Lees de beschrijving en inspecteer elke beschikbare tool.
- Schakel alle tools uit die Runner niet in dit project mag gebruiken.
- Voer vereiste providerreferenties in of selecteer Verbinden en autoriseren.
- Voltooi de providerstap. Als uw browser het autorisatievenster blokkeert, staat u het pop-upvenster voor Runner toe en begint u opnieuw.
- Keer terug naar het dialoogvenster en bevestig dat het Verbonden zegt.
- Selecteer Beheren later om de tooltoegangstatus te controleren of de app te verbreken.
Het verbindingsdialoogvenster stelt dat providerreferenties via de verbindingsservice worden verzonden en niet door Runner worden opgeslagen. U moet echter elke referentie als geheim behandelen en deze alleen in de referentievelden van de app invoeren.
Tooltoegangstatus wijzigen
- Selecteer Beheren op de verbonden app.
- Zoek de tool die u wilt wijzigen.
- Schakel de schakelaar in of uit.
- Wacht op Tool ingeschakeld of Tool uitgeschakeld.
- Als Runner Kan tool niet bijwerken toont, laat u het dialoogvenster open, controleert u de huidige schakelaar nadat deze is vernieuwd, en probeert u het opnieuw alleen als de opgeslagen status duidelijk is.
Het uitschakelen van een tool beperkt het gebruik van die tool door Runner. Het verwijdert geen gegevens die eerder in de externe service zijn gemaakt.
Een verbinding herstellen of verbreken
Als de catalogus geen bruikbare verbinding meer toont, opent u de app en start u Verbinden of Verbinden en autoriseren opnieuw, en bevestigt u vervolgens Verbonden.
Om toegang te verwijderen, selecteert u Beheren → Verbinding verbreken, controleert u de bevestiging en selecteert u Bevestigen. Dit verwijdert de Agent App-verbinding van het aangemelde account, niet alleen de tooltoegangstatus van het huidige project. Als het verbreken mislukt, behoudt Runner de verbonden status; ga niet ervan uit dat het externe account is verwijderd.
Als Agent Apps ontbreken
- De functie is mogelijk niet ingeschakeld voor de werkruimte.
- Wis de zoekopdracht en stel de categorie in op Alles.
- Vernieuw Apps als de catalogus nooit uit de laadstatus komt.
- Een afzonderlijke app kan melden dat deze nog niet beschikbaar is om verbinding mee te maken.
- Als de toollijst mislukt, selecteert u Opnieuw proberen in App-details.
- Geen specifieke catalogusvermelding mag worden beloofd totdat deze in de huidige werkruimte verschijnt.