Was eine Verbindung ist
Eine Verbindung ist eine angemeldete Verbindung zwischen einem Ihrer Experten und einer externen App. Nach der Verbindung kann dieser Experte die Tools der App in einer Unterhaltung nutzen: ein Dokument lesen, eine Nachricht entwerfen, einen Datensatz überprüfen. Ohne eine Verbindung hat der Experte überhaupt keinen Zugriff.
Zwei Dinge sollten präzise sein:
- Eine Verbindung gewährt Zugriff auf diese App, nicht auf Ihr KapsuleHost-Konto. Die beiden Berechtigungssätze vermischen sich niemals.
- Alles, das etwas in der verbundenen App ändert, wird immer noch durch die gleiche Bestätigungskarte wie eine Änderung an Ihrem KapsuleHost-Konto durchgeführt. Lesen erfolgt sofort; Schreiben fragt zuerst nach.
Verbindungen befinden sich unter Agents, dann Manage Connections, oder gehen Sie direkt zu /agents/connections. Die Agents-Startseite zeigt auch eine Connections-Karte mit einigen Beispiel-Apps.
Welche Experten welche Apps nutzen können
Das Angebot ist bewusst konservativ, und jeder Experte sieht nur die Apps, die seine Arbeit benötigt. Einige sind auf schreibgeschützte Tools beschränkt, auch wenn die App selbst mehr kann:
| Experte | Externe Apps, die erreichbar sind |
|---|---|
| Mara, Business Advisor | Stripe (schreibgeschützt) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (schreibgeschützt) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (schreibgeschützt) |
| Pip, Policy and Docs | Keine |
Das Verbinden einer App übergibt sie nicht dem ganzen Team. Sie wird nur den Experten in der obigen Zeile zur Verfügung gestellt.
Eine App verbinden
- Öffnen Sie Agents, dann Manage Connections.
- Durchsuchen Sie die Registerkarte Popular, wechseln Sie zu All Apps, oder geben Sie in das Suchfeld ein. Jede Karte zeigt den App-Namen und wie viele Tools sie freigibt.
- Klicken Sie auf Connect auf der gewünschten App. Die Schaltfläche wechselt zu Opening..., während das Anmelde-Fenster vorbereitet wird.
- Melden Sie sich bei der App selbst an und genehmigen Sie den angeforderten Zugriff.
- Sie landen auf der Connections-Seite mit einer Bestätigung [App] Connected.
Nach der Verbindung zeigt die Karte ein Connected-Badge, die Kontokennung, unter der Sie sich angemeldet haben, und wann die Verbindung zuletzt verwendet wurde, oder Not used yet.
Verbindungsstatus
| Status | Was es bedeutet | Was zu tun ist |
|---|---|---|
| Connected | Funktioniert. Ihre Experten können es nutzen. | Nichts |
| Pending | Die Anmeldung wurde gestartet, aber nie abgeschlossen. | Klicken Sie auf Finish Connecting |
| Reconnect Needed | Der Zugriff ist abgelaufen oder wurde von der App-Seite entzogen. | Klicken Sie auf Reconnect |
Der Status Reconnect Needed ist normal im Laufe der Zeit: Die meisten Apps lassen den Zugriff, den sie gewähren, nach einem Zeitplan ablaufen. Das erneute Verbinden stellt ihn wieder her, ohne etwas zu verlieren.
Wie das sicher bleibt
Die Connections-Seite erklärt das Sicherheitsmodell in drei Zeilen, und es lohnt sich zu verstehen, anstatt es nur zu überfliegen:
- Von einem zertifizierten Partner gehandhabt. Die Anmeldung bei einer App wird von unserem zertifizierten Integrations-Partner gehandhabt, der die Berechtigung hält. Ihr App-Passwort berührt niemals KapsuleHost.
- Bestätigung vor dem Handeln. Agents fragen, bevor sie handeln. Alles, das etwas ändert, braucht Ihre Zustimmung.
- Sofortige Sperrung. Das Trennen der Verbindung beendet den Zugriff sofort, sowohl hier als auch bei der App.
Behandeln Sie eine Verbindung wie einen Schlüssel, den Sie für jemanden anfertigen lassen. Verbinden Sie die Konten, in denen Ihre Experten arbeiten sollen, nicht jedes Konto, das Sie besitzen. Wenn Sie sich nicht sicher sind, ob ein Experte eine App für die vorgesehene Aufgabe braucht, verbinden Sie sie nicht: fragen Sie zuerst, dann verbinden Sie.
Eine App trennen
- Öffnen Sie Agents, dann Manage Connections.
- Klicken Sie auf Disconnect auf der verbundenen App.
- Eine Bestätigung erscheint: Ihr Team verliert sofort Zugriff auf [App]. Alles, das es bereits verwendet hat, bleibt in Ihren vergangenen Chats.
- Klicken Sie auf Disconnect, um zu bestätigen.
Der Zugriff endet sofort. Das bedeutet nicht, dass der App-Inhalt aus Gesprächen gelöscht wird, die Sie bereits geführt haben: Wenn ein Experte letzte Woche ein Dokument in einen Chat zitiert hat, ist dieser Text immer noch im Chat-Transkript. Das Trennen betrifft zukünftigen Zugriff, nicht nachträgliche Löschung.
Wenn Connections in Ihrem Konto nicht verfügbar ist
Wenn die Connections-Seite eine einzelne ruhige Karte anzeigt, die Connections Are Not Available Yet liest, wurde das Verbinden externer Apps für Ihr Konto nicht aktiviert. Die Karte besagt eindeutig, dass nichts verbunden ist und nichts Zugriff hat, was genau der Wahrheit in diesem Zustand entspricht. Ihre Experten arbeiten immer noch; sie können nur nicht aus KapsuleHost hinausgehen.
Der Rest von Agents ist unberührt. Chats, Skills und Kontolesevorgänge funktionieren wie gewohnt.
Wenn es fehlschlägt
"Permission was not granted, so nothing was connected." Sie haben auf dem Genehmigungsbildschirm der App abgebrochen oder abgelehnt. Nichts wurde erstellt. Klicken Sie erneut auf Connect und genehmigen Sie den Zugriff.
"Connections are unavailable right now. Try again in a moment." Der Integrationsdienst konnte nicht erreicht werden. Dies ist bewusst fehlgeschlossen: Anstatt eine halb erstellte Liste anzuzeigen, zeigt die Seite nichts an. Warten Sie eine Minute und laden Sie neu.
"Connections could not be loaded." Ihre Einstellungen sind sicher. Aktualisieren Sie die Seite. Wenn das Problem weiterhin besteht, öffnen Sie ein Support-Ticket.
Ein Experte sagt, er kann eine verbundene App nicht erreichen. Überprüfen Sie die obige Tabelle. Nicht jeder Experte darf auf jede App zugreifen, und eine für Iris verbundene App ist nicht automatisch für Mara verfügbar.
Eine Verbindung verharrt auf Pending. Das Anmelde-Fenster wurde geschlossen, bevor es fertig war. Klicken Sie auf Finish Connecting und schließen Sie es ab.
Was Connections kostet
Die Verwendung einer verbundenen App in einer Unterhaltung wird wie jede andere Aufgabe gemessen. Jeder Aufruf, den ein Experte an eine externe App durchführt, wird mit der Connection-Call-Gewichtung berechnet, die einen Bruchteil dessen kostet, was ein langer Text kostet. Lesevorgänge auf Ihrem KapsuleHost-Konto bleiben kostenlos. Die vollständige Gewichtung finden Sie unter How Agent Credits Work.