Erste Schritte
Externe Apps mit deinen Agenten verbinden
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.
Was ist eine Verbindung
Eine Verbindung ist ein anmeldungsverknüpfter Link zwischen einem deiner Experten und einer externen App. Nach der Verbindung kann dieser Experte die Tools der App in einem Gespräch nutzen: ein Dokument lesen, eine Nachricht verfassen, einen Datensatz prüfen. Ohne Verbindung hat der Experte keinen Zugriff.
Zwei Punkte sollten präzise sein:
- Eine Verbindung gewährt Zugriff auf diese App, nicht auf deinen Kapsule-Account. Die beiden Berechtigungssätze vermischen sich nie.
- Alles, das etwas in der verbundenen App ändert, durchläuft immer noch die gleiche Bestätigungskarte wie eine Änderung in deinem Kapsule-Account. Lesen ist unmittelbar; Schreiben fragt zuerst.
Verbindungen sind unter Agents, dann Manage Connections zu finden, oder gehe direkt zu /agents/connections. Die Agents-Startseite zeigt auch eine Connections-Karte mit einigen Beispielapps.
Welche Experten welche Apps nutzen können
Die Liste ist bewusst konservativ, und jeder Experte sieht nur die Apps, die sein Job benötigt. Einige sind auf Nur-Lesen-Tools beschränkt, auch wenn die App selbst mehr kann:
| Experte | Externe Apps, die er erreichen kann |
|---|---|
| Mara, Business Advisor | Stripe (nur Lesen) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (nur Lesen) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (nur Lesen) |
| Pip, Policy and Docs | Keine |
Eine App zu verbinden bedeutet nicht, sie dem ganzen Team zu überlassen. Sie ist nur für die Experten in der obigen Zeile verfügbar.
Eine App verbinden
- Öffne Agents, dann Manage Connections.
- Durchsuche den Tab Popular, wechsle zu All Apps, oder gib in das Suchfeld ein. Jede Karte zeigt den App-Namen und wie viele Tools sie bereitstellt.
- Klicke auf Connect bei der App, die du verbinden möchtest. Der Button ändert sich zu Opening..., während das Anmeldungsfenster vorbereitet wird.
- Melde dich bei der App selbst an und genehmige den geforderten Zugriff.
- Du landest auf der Connections-Seite mit einer [App] Connected-Bestätigung.
Nach der Verbindung zeigt die Karte ein Connected-Abzeichen, die Kontobezeichnung, unter der du angemeldet bist, und wann die Verbindung zuletzt verwendet wurde, oder Not used yet.
Verbindungsstatus
| Status | Was das bedeutet | Was du tun solltest |
|---|---|---|
| Connected | Funktioniert. Deine Experten können sie nutzen. | Nichts |
| Pending | Die Anmeldung wurde gestartet, aber nie abgeschlossen. | Klicke auf Finish Connecting |
| Reconnect Needed | Der Zugriff ist abgelaufen oder wurde von der App-Seite entzogen. | Klicke auf Reconnect |
Der Zustand Reconnect Needed ist normal im Laufe der Zeit: Die meisten Apps laufen den gewährten Zugriff zeitgesteuert ab. Eine erneute Verbindung stellt ihn wieder her, ohne etwas zu verlieren.
Wie das sicher bleibt
Die Connections-Seite stellt das Sicherheitsmodell in drei Zeilen dar, und es lohnt sich zu verstehen, statt nur zu überfliegen:
- Abgewickelt durch einen zertifizierten Partner. Die Anmeldung bei einer App wird von unserem zertifizierten Integrationspartner abgewickelt, der die Berechtigung hält. Dein App-Passwort berührt niemals Kapsule.
- Bestätigung vor Aktion. Agents fragen vor dem Handeln. Alles, das etwas ändert, braucht deine Zustimmung.
- Sofortige Widerruf. Eine Trennung beendet den Zugriff sofort, hier und bei der App.
Behandle eine Verbindung wie einen Schlüssel, den du für jemanden anfertigen lässt. Verbinde die Accounts, in denen deine Experten arbeiten sollen, nicht jeden Account, den du besitzt. Wenn du nicht sicher bist, ob ein Experte eine App für den angestrebten Job braucht, verbinde sie nicht: frage zuerst, dann verbinde.
Eine App trennen
- Öffne Agents, dann Manage Connections.
- Klicke auf Disconnect bei der verbundenen App.
- Eine Bestätigung erscheint: Dein Team verliert sofort Zugriff auf [App]. Alles, das es bereits verwendet hat, bleibt in deinen vergangenen Chats.
- Klicke auf Disconnect, um zu bestätigen.
Der Zugriff endet unmittelbar. Das nicht tut eine Trennung ist, den App-Inhalt aus Gesprächen zu löschen, die du bereits hattest: wenn ein Experte letzte Woche ein Dokument in einen Chat zitiert hat, ist dieser Text immer noch im Chat-Transcript. Eine Trennung betrifft zukünftigen Zugriff, nicht rückwirkende Löschung.
Wenn Connections in deinem Account nicht verfügbar ist
Wenn die Connections-Seite eine einzelne ruhige Karte anzeigt, die lautet Connections Are Not Available Yet, wurde das Verbinden von externen Apps für deinen Account nicht aktiviert. Die Karte ist eindeutig, dass nichts verbunden ist und nichts Zugriff hat, was in diesem Zustand genau der Wahrheit entspricht. Deine Experten arbeiten immer noch; sie können nur nicht außerhalb von Kapsule hinausreichen.
Der Rest von Agents ist nicht betroffen. Chats, Skills und Account-Lesevorgänge funktionieren normal.
Wenn es fehlschlägt
"Permission was not granted, so nothing was connected." Du hast auf dem Genehmigungsbildschirm der App selbst abgebrochen oder abgelehnt. Nichts wurde erstellt. Klicke erneut auf Connect und genehmige den Zugriff.
"Connections are unavailable right now. Try again in a moment." Der Integrationsdienst konnte nicht erreicht werden. Dies ist bewusst fehlersicher: statt eine halb aufgebaute Liste zu zeigen, zeigt die Seite nichts. Warte eine Minute und lade die Seite neu.
"Connections could not be loaded." Deine Einstellungen sind sicher. Aktualisiere die Seite. Wenn das Problem weiterhin besteht, öffne ein Support-Ticket.
Ein Experte sagt, er kann eine verbundene App nicht erreichen. Prüfe die obige Tabelle. Nicht jeder Experte darf jede App nutzen, und eine App, die für Cora verbunden ist, ist nicht automatisch für Mara verfügbar.
Eine Verbindung sitzt auf Pending. Das Anmeldungsfenster wurde geschlossen, bevor es fertig war. Klicke auf Finish Connecting und schließe es ab.
Was Connections kostet
Die Verwendung einer verbundenen App in einem Gespräch wird wie jede andere Aufgabe gemessen. Jeder Aufruf, den ein Experte an eine externe App tätigt, wird mit dem Connection-Call-Gewicht berechnet, was ein Bruchteil dessen ist, was ein längeres Schreiben kostet. Lesevorgänge in deinem Kapsule-Account bleiben kostenlos. Die vollständige Gewichtung ist unter How Agent Credits Work zu finden.