Connections ti permettono a un esperto di Kapsule Agents di lavorare all'interno di app che usi già, con il tuo permesso, e sono completamente separate da quello che un esperto può fare sul tuo account KapsuleHost.
Che cos'è una Connection
Una connection è un collegamento firmato tra uno dei tuoi esperti e un'app esterna. Una volta collegata, quell'esperto può usare gli strumenti dell'app in una conversazione: leggere un documento, redigere un messaggio, controllare un record. Senza una connection, l'esperto non ha alcun accesso.
Due cose vale la pena di essere precisi:
- Una connection concede accesso a quell'app, non al tuo account KapsuleHost. I due insiemi di autorizzazioni non si mescolano mai.
- Qualsiasi cosa che cambi qualcosa nell'app collegata passa comunque attraverso la stessa scheda di conferma di una modifica sul tuo account KapsuleHost. La lettura è immediata; la scrittura chiede prima il permesso.
Le connections si trovano in Agents, poi Gestisci Connessioni, oppure vai direttamente a /agents/connections. La home page di Agents mostra anche una scheda Connections con alcuni esempi di app.
Quali Esperti Possono Usare Quali App
L'elenco è deliberatamente conservatore, e ogni esperto vede solo le app di cui ha bisogno per il suo lavoro. Alcuni sono limitati a strumenti di sola lettura anche quando l'app stessa può fare di più:
| Esperto | App esterne che può raggiungere |
|---|---|
| Mara, Business Advisor | Stripe (sola lettura) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (sola lettura) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (sola lettura) |
| Pip, Policy and Docs | Nessuna |
Collegare un'app non la mette a disposizione dell'intero team. Diventa disponibile solo per gli esperti nella riga sopra.
Collegare un'App
- Apri Agents, poi Gestisci Connessioni.
- Sfoglia la scheda Popular, passa a Tutte le app, oppure digita nella casella di ricerca. Ogni scheda mostra il nome dell'app e quanti strumenti espone.
- Fai clic su Connect sull'app che desideri. Il pulsante diventa Opening... mentre viene preparata la finestra di accesso.
- Accedi all'app stessa e approva l'accesso che ti chiede.
- Torni sulla pagina Connections con una conferma [app] Connected.
Una volta collegata, la scheda mostra una pillola Connected, l'etichetta dell'account a cui hai effettuato l'accesso, e quando la connection è stata utilizzata l'ultima volta, oppure Non ancora utilizzato.
Stati della Connection
| Stato | Che cosa significa | Che cosa fare |
|---|---|---|
| Connected | Funzionante. I tuoi esperti possono usarla. | Niente |
| Pending | L'accesso è stato avviato ma non è mai stato completato. | Fai clic su Completa la connessione |
| Reconnect Needed | L'accesso è scaduto o è stato revocato da parte dell'app. | Fai clic su Riconnetti |
Lo stato Riconnessione Necessaria è normale nel tempo: la maggior parte delle app fa scadere l'accesso che concedono secondo una pianificazione. La riconnessione lo ripristina senza perdere nulla.
Come Rimane Sicuro
La pagina Connections espone il modello di sicurezza in tre righe, ed è utile comprenderlo piuttosto che scorrerlo rapidamente:
- Gestito da un partner certificato. L'accesso a un'app è gestito dal nostro partner di integrazione certificato, che detiene l'autorizzazione. La tua password dell'app non tocca mai KapsuleHost.
- Conferma prima dell'azione. Agents chiede prima di agire. Qualsiasi cosa che cambi qualcosa ha bisogno del tuo consenso.
- Revoca istantanea. Disconnettere taglia l'accesso subito, sia qui che nell'app.
Tratta una connection come una chiave che hai fatto fare per qualcuno. Collega gli account in cui vuoi che i tuoi esperti lavorino, non ogni account che possiedi. Se non sei sicuro se un esperto ha bisogno di un'app per fare il lavoro che hai in mente, non collegarla: chiedi prima, poi collega.
Disconnettere un'App
- Apri Agents, poi Gestisci Connessioni.
- Fai clic su Disconnect sull'app collegata.
- Appare una conferma: Il tuo team perde l'accesso a [app] subito. Qualsiasi cosa l'abbia già utilizzato rimane nelle tue chat passate.
- Fai clic su Disconnect per confermare.
L'accesso termina immediatamente. Quello che questo non fa è cancellare il contenuto dell'app dalle conversazioni che hai già avuto: se un esperto ha citato un documento in una chat la scorsa settimana, quel testo è ancora nella trascrizione della chat. Disconnettere riguarda l'accesso futuro, non l'eliminazione retroattiva.
Quando Connections Non è Disponibile sul Tuo Account
Se la pagina Connections mostra una singola scheda calma che legge Le connessioni non sono ancora disponibili, il collegamento delle app esterne non è stato attivato per il tuo account. La scheda è esplicita nel dire che niente è collegato e niente ha accesso, che è esattamente la verità in questo stato. I tuoi esperti lavorano ancora; semplicemente non riescono a raggiungere fuori da KapsuleHost.
Il resto di Agents non è influenzato. Le chat, le Skills e le letture dell'account funzionano tutte normalmente.
Che Cosa Fare Se Fallisce
"L'autorizzazione non è stata concessa, quindi niente è stato collegato." Hai annullato o rifiutato nella schermata di approvazione dell'app stessa. Niente è stato creato. Fai clic su Connect di nuovo e approva l'accesso.
"Le connessioni non sono disponibili in questo momento. Riprova tra un momento." Il servizio di integrazione non ha potuto essere raggiunto. Questo è deliberatamente fail-closed: piuttosto che mostrare un elenco semi-costruito, la pagina non mostra nulla. Aspetta un minuto e ricarica.
"Le connessioni non potevano essere caricate." Le tue impostazioni sono sicure. Aggiorna la pagina. Se persiste, apri un ticket di supporto.
Un esperto dice che non riesce a raggiungere un'app collegata. Controlla la tabella sopra. Non ogni esperto è autorizzato a usare ogni app, e un'app collegata per Iris non è automaticamente disponibile per Mara.
Una connection rimane in Pending. La finestra di accesso è stata chiusa prima che finisse. Fai clic su Completa la connessione e completala.
Cosa Costano le Connections
Usare un'app collegata in una conversazione è misurato come qualsiasi altro lavoro. Ogni chiamata che un esperto fa a un'app esterna viene addebitata al peso della connection-call, che è una frazione di quello che costa un lungo pezzo di scrittura. Le letture sul tuo account KapsuleHost rimangono gratuite. La ponderazione completa è in Come Funzionano i Crediti dell'Agent.