Connetti e controlla le app Agent
Trova un'app Agent, scegli i suoi strumenti consentiti, collegala e gestisci l'accesso.
Le app Agent consentono all'Agent Runner di utilizzare un servizio esterno mentre lavora sul tuo progetto. Puoi ispezionare gli strumenti dell'app e disattivare gli strumenti che non desideri che l'Agent utilizzi.
Prima di iniziare
Percorso di accesso: Progetto → App → Agent Apps
Le app Agent sono condizionali. La sezione può essere nascosta, un'app singola può non essere disponibile o il catalogo può non riuscire a caricarsi. La disponibilità può variare in base all'area di lavoro, al progetto, al provider e all'accesso al prodotto in fase.
Hai bisogno di:
- accesso al progetto;
- un account o una credenziale accettati dal provider selezionato; e
- autorizzazione per consentire a Runner di utilizzare gli strumenti che lasci abilitati.
Rivedi ogni strumento prima di connetterti. L'accesso agli strumenti si applica al progetto corrente e può consentire all'Agent di leggere o modificare i dati nel servizio esterno.
La connessione dell'account esterno appartiene al tuo account Runner con accesso effettuato, mentre gli interruttori degli strumenti vengono salvati per il progetto corrente. La disconnessione può quindi rimuovere la connessione utilizzata da altri progetti anche se le loro scelte di strumenti sono separate.
Trova e ispeziona un'app
| Controllo o stato | Perché è utile | Cosa succede dopo |
|---|---|---|
| Cerca app | Filtra le app Store e le app Agent insieme. | Il catalogo mostra nomi e descrizioni corrispondenti. |
| Selettore di categoria | Restringe il catalogo delle app Agent. | Scegli Tutto per rimuovere il filtro di categoria. |
| Precedente e Successivo | Si sposta attraverso un catalogo lungo. | Runner mostra la pagina precedente o successiva delle app corrispondenti. |
| Scheda app | Mostra il nome dell'app, la descrizione e lo stato della connessione. | Selezionandola si apre Dettagli app. |
| Nessun'app trovata | Mostra che i filtri correnti non hanno corrispondenze. | Cancella ricerca ripristina la ricerca e la categoria. |
| Segnaposti di caricamento | Mostra che Runner sta recuperando il catalogo. | Attendi le schede prima di scegliere un'app. |
Controlli dei dettagli dell'app
| Controllo o stato | Perché è utile | Cosa succede dopo |
|---|---|---|
| Descrizione dell'app e categoria | Aiuta a confermare che hai aperto il servizio desiderato. | Nessun accesso esterno viene concesso visualizzando i dettagli. |
| Interruttore dello strumento | Limita ciò che Runner può chiedere all'app connessa di fare. | Prima di connetterti, Runner salva le tue scelte con la connessione. Dopo la connessione, una modifica viene salvata immediatamente. |
| Precedente e Successivo nell'elenco degli strumenti | Rivede le app con molti strumenti. | Si sposta attraverso gli strumenti senza chiudere la finestra di dialogo. |
| Campi credenziali richiesti | Supporta le app che non utilizzano l'autorizzazione del browser. | Connetti rimane non disponibile fino a quando i campi richiesti non vengono compilati. I campi simili a segreti sono mascherati. |
| Connetti | Invia le credenziali del provider quando quella strategia è richiesta. | Runner tenta la connessione con l'accesso agli strumenti scelto. |
| Connetti e autorizza | Avvia l'autorizzazione del provider. | Runner apre una finestra di autorizzazione. |
| Connessione in corso... | Mostra che l'autorizzazione è in corso. | L'azione rimane non disponibile fino a quando Runner riceve un risultato. |
| Connesso | Conferma che Runner riconosce l'account. | Chiudi la finestra di dialogo o gestisci l'accesso agli strumenti. |
| Gestisci | Riapre un'app connessa. | Rivedi e modifica i suoi strumenti abilitati o disconnettilo. |
| Disconnetti | Avvia la rimozione. | Runner chiede Sei sicuro di voler disconnettere? |
| Annulla o Conferma | Risolve l'avviso di disconnessione. | Annulla mantiene l'accesso; Conferma rimuove la connessione dell'app Agent a livello di account da Runner. Le impostazioni degli strumenti del progetto sono separate. |
Connetti un'app Agent
- Apri Progetto → App e scorri fino ad App Agent.
- Cerca l'app o scegli una categoria.
- Seleziona la scheda dell'app per aprire Dettagli app.
- Leggi la sua descrizione e ispeziona ogni strumento disponibile.
- Disattiva qualsiasi strumento che Runner non dovrebbe utilizzare in questo progetto.
- Immetti le credenziali del provider richieste o seleziona Connetti e autorizza.
- Completa il passaggio del provider. Se il tuo browser blocca la finestra di autorizzazione, consenti il popup per Runner e ricomincia.
- Torna alla finestra di dialogo e conferma che dice Connesso.
- Seleziona Gestisci in seguito per rivedere l'accesso agli strumenti o disconnettere l'app.
La finestra di dialogo di connessione afferma che le credenziali del provider vengono inviate attraverso il servizio di connessione e non vengono archiviate da Runner. Dovresti comunque trattare ogni credenziale come un segreto e inserirla solo nei campi credenziali dell'app.
Modifica l'accesso agli strumenti
- Seleziona Gestisci sull'app connessa.
- Trova lo strumento che desideri modificare.
- Attiva o disattiva il suo interruttore.
- Attendi Strumento abilitato o Strumento disabilitato.
- Se Runner mostra Impossibile aggiornare lo strumento, lascia la finestra di dialogo aperta, controlla lo stato dell'interruttore corrente dopo l'aggiornamento e riprova solo se lo stato salvato è chiaro.
Disabilitare uno strumento limita l'uso di quello strumento da parte di Runner. Non elimina i dati creati in precedenza nel servizio esterno.
Ripara o disconnetti una connessione
Se il catalogo non mostra più una connessione utilizzabile, apri l'app e avvia Connetti o Connetti e autorizza di nuovo, quindi conferma Connesso.
Per rimuovere l'accesso, seleziona Gestisci → Disconnetti, rivedi la conferma e seleziona Conferma. Questo rimuove la connessione dell'app Agent dell'account con accesso effettuato, non solo l'accesso agli strumenti del progetto corrente. Se la disconnessione non riesce, Runner mantiene lo stato connesso; non presumere che l'account esterno sia stato rimosso.
Se le app Agent mancano
- La funzione potrebbe non essere abilitata per l'area di lavoro.
- Cancella la ricerca e imposta la categoria su Tutto.
- Aggiorna le app se il catalogo non esce mai dal suo stato di caricamento.
- Un'app singola può segnalare che non è ancora disponibile per la connessione.
- Se l'elenco degli strumenti non riesce, seleziona Riprova all'interno di Dettagli app.
- Nessuna voce di catalogo specifica dovrebbe essere promessa fino a quando non appare nell'area di lavoro corrente.