Per iniziare
Collegamento di app esterne ai tuoi Agents
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Che Cosa È una Connessione
Una connessione è un collegamento autenticato tra uno dei tuoi esperti e un'app esterna. Una volta connesso, quell'esperto può usare gli strumenti dell'app in una conversazione: leggere un documento, redigere un messaggio, verificare un record. Senza una connessione, l'esperto non ha accesso.
Due aspetti meritano precisione:
- Una connessione concede accesso a quell'app, non al tuo account Kapsule. I due set di autorizzazioni non si mescolano mai.
- Qualsiasi cosa che modifichi qualcosa nell'app connessa passa comunque per la stessa scheda di conferma di una modifica sul tuo account Kapsule. La lettura è immediata; la scrittura chiede prima il permesso.
Le connessioni si trovano in Agents, poi Manage Connections, oppure vai direttamente a /agents/connections. La home page di Agents mostra anche una scheda Connessioni con alcuni esempi di app.
Quali Esperti Possono Usare Quali App
L'elenco è volutamente 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 potrebbe fare di più:
| Esperto | App esterne raggiungibili |
|---|---|
| Mara, Business Advisor | Stripe (sola lettura) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (sola lettura) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (sola lettura) |
| Pip, Policy and Docs | Nessuno |
Connettere un'app non la mette a disposizione di tutto il team. Diventa disponibile solo agli esperti nella riga sopra.
Connessione di un'App
- Apri Agents, poi Manage Connections.
- Sfoglia la scheda Popular, passa a All Apps, oppure digita nella casella di ricerca. Ogni scheda mostra il nome dell'app e quanti strumenti espone.
- Fai clic su Connect sull'app che vuoi. Il pulsante cambia in Opening... mentre la finestra di accesso viene preparata.
- Accedi all'app e approva l'accesso che richiede.
- Torni sulla pagina Connessioni con una conferma [app] Connected.
Una volta connessa, la scheda mostra una pillola Connected, l'etichetta dell'account con cui hai effettuato l'accesso, e quando la connessione è stata utilizzata per l'ultima volta, oppure Not used yet.
Stati di Connessione
| Stato | Cosa significa | Cosa fare |
|---|---|---|
| Connected | Funzionante. I tuoi esperti possono usarla. | Nulla |
| Pending | L'accesso è stato avviato ma mai completato. | Fai clic su Finish Connecting |
| Reconnect Needed | L'accesso è scaduto o è stato revocato dall'app. | Fai clic su Reconnect |
Lo stato Reconnect Needed è normale nel tempo: la maggior parte delle app revoca l'accesso concesso secondo una pianificazione. La riconnessione lo ripristina senza perdere nulla.
Come Rimane Sicuro
La pagina Connessioni espone il modello di sicurezza in tre righe, e vale la pena capirlo piuttosto che scorrerlo velocemente:
- Gestito da un partner certificato. L'accesso a un'app è gestito dal nostro partner di integrazione certificato, che tiene la concessione. La tua password dell'app non tocca mai Kapsule.
- Conferma prima dell'azione. Gli Agents chiedono prima di agire. Qualsiasi cosa che modifichi qualcosa ha bisogno del tuo consenso.
- Revoca istantanea. Disconnettere taglia l'accesso subito, sia qui che con l'app.
Tratta una connessione come una chiave che hai fatto fare per qualcuno. Connetti gli account in cui vuoi che i tuoi esperti lavorino, non ogni account che possiedi. Se non sei sicuro che un esperto abbia bisogno di un'app per fare il lavoro che hai in mente, non connetterla: chiedi prima, poi connetti.
Disconnessione di un'App
- Apri Agents, poi Manage Connections.
- Fai clic su Disconnect sull'app connessa.
- Appare una conferma: Il tuo team perde accesso a [app] subito. Qualsiasi cosa abbia già utilizzato rimane nelle tue chat passate.
- Fai clic su Disconnect per confermare.
L'accesso termina immediatamente. Quello che non fa è rimuovere il contenuto dell'app dalle conversazioni che hai già avuto: se un esperto ha inserito un documento in una chat la settimana scorsa, quel testo è ancora nella trascrizione della chat. Disconnettere riguarda l'accesso futuro, non la cancellazione retroattiva.
Quando le Connessioni Non Sono Disponibili nel Tuo Account
Se la pagina Connessioni mostra una singola scheda tranquilla che dice Connections Are Not Available Yet, la connessione di app esterne non è stata attivata per il tuo account. La scheda esplicita che nulla è connesso e nulla ha accesso, il che è esattamente la verità in quello stato. I tuoi esperti continuano a lavorare; semplicemente non possono raggiungere l'esterno di Kapsule.
Il resto di Agents non è interessato. Le chat, le Skills e le letture di account funzionano tutte normalmente.
Se Non Funziona
"L'autorizzazione non è stata concessa, quindi nulla è stato connesso." Hai annullato o rifiutato sulla schermata di approvazione dell'app stessa. Nulla è 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 è stato raggiunto. Questo è deliberatamente chiuso in caso di errore: piuttosto che mostrare un elenco mezzo costruito, la pagina non mostra nulla. Aspetta un minuto e ricarica.
"Impossibile caricare le connessioni." Le tue impostazioni sono al sicuro. Aggiorna la pagina. Se persiste, apri un ticket di supporto.
Un esperto dice che non può raggiungere un'app connessa. Controlla la tabella sopra. Non tutti gli esperti sono autorizzati per tutte le app, e un'app connessa per Cora non è automaticamente disponibile per Mara.
Una connessione rimane in Pending. La finestra di accesso è stata chiusa prima di completare. Fai clic su Finish Connecting e completala.
Che Cosa Costano le Connessioni
Usare un'app connessa in una conversazione è misurato come qualsiasi altro lavoro. Ogni chiamata che un esperto fa a un'app esterna viene addebitata al peso della chiamata di connessione, che è una frazione di quello che costa scrivere un lungo brano. Le letture sul tuo account Kapsule rimangono gratuite. La ponderazione completa è in How Agent Credits Work.