Integrationen verbinden
Über Integrationen arbeiten Agenten mit Systemen, die du schon nutzt: Postfach, Kalender, Ablage oder Repositorys. Jede Person verbindet dafür ihr eigenes Konto. Welche Integrationen du siehst, legt deine Administration fest.
- Den Katalog durchsuchen
- Was die Markierungen bedeuten
- Ein Konto beim Anbieter verbinden
- Microsoft-Kacheln verbinden
- Ein E-Mail-Postfach verbinden
- Verbundene Konten verwalten
- Das Konto in der Unterhaltung wählen
- Ein Konto fest an einen Agenten binden
- Synchronisierte Ordner
- Schreibende Aktionen absichern
- Wenn etwas nicht klappt
Den Katalog durchsuchen
- Wähle in der Seitenleiste Integrationen.
- Grenz die Liste mit den Filtern ein: Alle, Verbunden oder Einrichtung nötig. Von mir erstellt ist ausgegraut und zeigt beim Darüberfahren Bald verfügbar.
- Gib einen Begriff in das Suchfeld Integrationen suchen... ein. Gesucht wird in Name, Anbieter und Beschreibung.
- Wähle eine Kachel, um ihre Detailseite zu öffnen. Das geht auch bei Kacheln mit Einrichtung nötig.
Abbildung vergrößern
Abbildung vergrößernJe nach Instanz findest du Kacheln für Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Tasks und Google Contacts, für Outlook Email, Outlook Calendar, Microsoft Teams, SharePoint, OneDrive und Excel, außerdem für GitHub, GitLab, Slack, FILERO DMS, E-Mail (IMAP/SMTP) und MCP Utilities sowie eigene Konnektoren, die deine Administration hinzugefügt hat. MCP Utilities liefert Hilfsfunktionen für Datum, Rechnen und Kodierung und braucht keine Anmeldung. Die Namen gehören ihren jeweiligen Inhabern.
Was die Markierungen bedeuten
| Auf der Kachel | Bedeutung |
|---|---|
| Verbinden | Die Integration ist eingerichtet. Du kannst dein Konto verbinden. |
| Verbunden | Dein Konto ist verbunden. Agenten können die Integration nutzen. MCP Utilities braucht kein Konto und zeigt immer Verbunden. |
| Einrichtung nötig | Deine Administration muss die Integration erst einrichten. Bis dahin kannst du kein Konto verbinden. |
| Beta | Die Integration ist als Beta gekennzeichnet. Deine Administration kann die Markierung pro Integration ein- oder ausschalten. |
Fehlt eine Integration ganz, hat deine Administration sie abgeschaltet oder nur für bestimmte Gruppen oder Mandanten freigegeben. Fehlt der Eintrag Integrationen in der Seitenleiste, ist der Bereich auf deiner Instanz nicht freigeschaltet.
Ein Konto beim Anbieter verbinden
So verbindest du Google, Microsoft, GitHub, GitLab, Slack und eigene Konnektoren deiner Administration. Du meldest dich dabei auf der Seite des Anbieters an, nicht in Intra AI.
- Öffne die Kachel. Unter Aktionen steht, was die Integration kann. Jede Aktion ist gekennzeichnet mit Nur lesen, Nimmt Änderungen vor, Löscht Daten oder Nicht eingestuft.
- Wähle im Bereich Verbindungen die Schaltfläche Verbindung hinzufügen.
- Im Dialog steht, dass du zum Anbieter weitergeleitet wirst. Wähle zum Beispiel Mit Google verbinden.
- Melde dich beim Anbieter an und erteile die angefragten Berechtigungen.
- Du landest wieder auf der Detailseite der Kachel. Die Seite zeigt jetzt Verbunden, und im Bereich Verbindungen steht dein Konto.
Klappt die Verbindung nicht, erscheint auf der Detailseite ein roter Hinweis mit dem Grund. Mit Ausblenden schließt du ihn.
Steht im Bereich Verbindungen ein Hinweis statt der Schaltfläche, ist die Integration auf deiner Instanz noch nicht eingerichtet. Wende dich an deine Administration.
Abbildung vergrößernFür FILERO DMS gibt es einen eigenen Assistenten. Er ist unter FILERO DMS verbinden beschrieben.
Microsoft-Kacheln verbinden
Auf einer Microsoft-Kachel, die noch nicht verbunden ist, steht vor dem Verbinden der Kasten Bevor Sie verbinden. Er nennt die Anmeldeschritte und jede Berechtigung, die diese Kachel anfragt. Bei Outlook Calendar steht dort zusätzlich die Liste Was Sie nach dem Verbinden tun können.
Jede Microsoft-Kachel fragt ihre eigenen Berechtigungen an. Eine Kachel zeigt erst dann Verbunden, wenn dein Standard-Microsoft-Konto mindestens die Berechtigungen dieser Kachel erteilt hat. Kacheln mit denselben Berechtigungen werden dabei gemeinsam verbunden: Wer SharePoint verbindet, hat damit auch OneDrive und Excel verbunden. Hast du Outlook Email verbunden und brauchst auch Teams, öffne die Teams-Kachel und verbinde dort noch einmal mit demselben Microsoft-Konto. Berechtigungen mit dem Zusatz „Admin-Zustimmung“ muss zusätzlich die Microsoft-Administration deines Unternehmens freigeben.
Unten im Kasten steht, eine Verbindung gelte für alle Microsoft-Kacheln. Darauf kannst du dich nicht verlassen. Maßgeblich ist, ob die Kachel selbst Verbunden zeigt.
Ein E-Mail-Postfach verbinden
Mit E-Mail (IMAP/SMTP) bindest du ein Postfach auf einem eigenen Mailserver an. Agenten können darin suchen, Nachrichten lesen, Entwürfe anlegen und Nachrichten senden. Vor dem Senden fragt der Agent standardmäßig nach, außer die Person, die den Agenten baut, hat das Senden auf ohne Nachfrage ausführen gestellt. Mehr dazu unter „Schreibende Aktionen absichern“ weiter unten.
- Öffne die Kachel E-Mail (IMAP/SMTP) und wähle Verbindung hinzufügen.
- Wähle unter Mailserver eine Voreinstellung deiner Administration oder Eigener Server (IMAP/SMTP).
- Gib E-Mail-Adresse und Passwort ein. Bietet dein Mailserver App-Passwörter an, verwende eines. Benutzername füllst du nur aus, wenn er von der Adresse abweicht.
- Trag bei einem eigenen Server IMAP-Server, IMAP-Port (993 oder 143), SMTP-Server und SMTP-Port (465 oder 587) ein, so wie in Outlook. Die Verbindung ist immer verschlüsselt.
- Wähle Speichern. Die Meldung „Verbindung gespeichert.“ bestätigt die Verbindung.
Für ein weiteres Postfach wählst du erneut Verbindung hinzufügen.
Verbundene Konten verwalten
Auf einer verbundenen Kachel steht im Bereich Verbindungen eine Zeile pro Konto. Die Zeile zeigt die Adresse, die Zahl der erteilten Berechtigungen und wann die Anmeldung zuletzt aktualisiert wurde. Das erste Konto, das du verbindest, wird dein Standard.
- Als Standard festlegen macht ein anderes Konto zum Standard. Agenten nutzen es, wenn weder die Unterhaltung noch der Agent ein Konto vorgibt.
- Trennen entfernt das Konto. Vorher fragt Intra AI nach.
Bei Google, Microsoft, FILERO DMS und E-Mail (IMAP/SMTP) kannst du mehrere Konten verbinden, etwa mit Weiteres Google-Konto verbinden. GitHub, GitLab, Slack und eigene Konnektoren halten ein Konto pro Person. Dort ersetzt eine erneute Anmeldung die bestehende Verbindung, auch mit einem anderen Konto.
Steht in einer Zeile Anmeldung erneut nötig, ist deine Anmeldung abgelaufen. Agenten und Workflows können das Konto dann nicht nutzen. Bei Microsoft-Konten erhältst du dazu eine Nachricht unter Nachrichten und Ankündigungen. Wähle Weiteres Google-Konto verbinden (bei Microsoft Weiteres Microsoft-Konto verbinden, bei E-Mail Verbindung hinzufügen) und melde dich mit demselben Konto an. Intra AI erneuert dann die bestehende Verbindung, statt ein zweites Konto anzulegen.
Nach dem Trennen greifen Agenten und Unterhaltungen, die das Konto genutzt haben, bei der nächsten Nachricht auf den Konto-Chip zurück. Synchronisierte Ordner aus dem Konto werden nicht mehr aktualisiert und nach 60 Tagen entfernt, wenn du das Konto nicht neu verbindest. Das Trennen gilt für das ganze Konto: Ein Microsoft-Konto ist danach auf allen Microsoft-Kacheln getrennt.
Hinweis: Trennen entfernt das Konto aus Intra AI. Ob der Zugriff auch beim Anbieter widerrufen wurde, zeigt Intra AI nicht an. Prüfe im Zweifel die App-Berechtigungen in den Kontoeinstellungen des Anbieters und entzieh den Zugriff dort.
Das Konto in der Unterhaltung wählen
Braucht ein Agent eine Integration, die du noch nicht verbunden hast, steht vor der ersten Nachricht über dem Eingabefeld „… braucht Zugriff auf …“. Verbinden öffnet die passende Kachel. Steht dort stattdessen „Muss von Ihrer Administration eingerichtet werden“, kannst du die Integration noch nicht verbinden.
Nutzt ein Agent Microsoft, Google, FILERO DMS oder E-Mail (IMAP/SMTP), zeigt die Unterhaltung über dem Eingabefeld einen Chip mit dem aktiven Konto.
- Hast du mehrere Konten verbunden, wähle den Chip.
- Wähle die Adresse, mit der der Agent arbeiten soll. Die Wahl gilt für diese Unterhaltung.
- Im selben Menü führt Weiteres Konto verbinden zu den Integrationen. Mit nur einem Konto hat der Chip kein Menü. Ein weiteres Konto verbindest du dann direkt unter Integrationen.
Intra AI nimmt das Konto in dieser Reihenfolge: die Wahl in der Unterhaltung, dann die Konto-Bindung des Agenten, dann dein Standardkonto. Gibt es keines davon, wirst du gefragt.
Ein Konto fest an einen Agenten binden
Soll ein eigener Agent immer mit derselben Adresse arbeiten, zum Beispiel einem Sammelpostfach, bindest du das Konto an ihn.
- Öffne den Agenten im Builder und schalte den Expertenmodus ein.
- Geh zum Schritt Werkzeuge und dort zu Konto-Bindung.
- Wähle das Konto oder lass Kein festes Konto (Chip, sonst Standard oder Nachfrage) stehen.
Konto-Bindung erscheint nur bei privaten Agenten, die du nicht geteilt hast, und nur wenn du mehr als ein Konto des Anbieters verbunden hast. Die Einstellung gilt nur für dich. Wie du einem Agenten Aktionen einer Integration gibst, steht unter Werkzeuge, Wissen und Sub-Agenten.
Synchronisierte Ordner
Google Drive und FILERO DMS können ganze Ordner aktuell halten. Auf der Kachel listet der Bereich Synchronisierte Ordner diese Ordner mit der Zahl ihrer Dateien. Die Ordner erscheinen auch unter Dateien.
Verbinde zuerst das Konto. Mit Ordner synchronisieren wählst du direkt auf der Kachel einen Ordner. In Dateien verwalten führt zur Ordnerverwaltung unter Dateien. Mehr dazu unter Dateien verwalten. Bietet deine Instanz die Synchronisierung für diese Integration nicht an, steht im Bereich stattdessen ein Hinweis.
Schreibende Aktionen absichern
Ein Agent nutzt immer die verbundenen Konten der Person, die gerade mit ihm arbeitet, nie die Konten der Person, die ihn erstellt hat. Lesende Aktionen laufen ohne Rückfrage.
Für jede Aktion, die etwas anlegt, ändert, sendet oder löscht, legt die Person, die den Agenten baut, im Schritt Werkzeuge unter Was der Agent selbst tun darf fest, wie sich die Aktion verhält: vor Ausführung immer nachfragen oder ohne Nachfrage ausführen. Bei ohne Nachfrage ausführen kann sie eine Begründung eintragen. Außerdem darf der Agent dann nur innerhalb eines Verfahrens schreiben, das er schon mitbringt. Im Builder lässt sich derzeit keines anlegen. Ein Agent ohne Verfahren lässt sich erst fertigstellen, wenn die Aktion auf vor Ausführung immer nachfragen steht. Bei einem geteilten Agenten gilt die Wahl für alle, die ihn nutzen. Auf deiner Instanz kann das Ausführen ohne Nachfrage auch ganz abgeschaltet sein, oder einzelne Werkzeuge fragen immer nach.
In der Unterhaltung hält eine solche Aktion an und zeigt eine Karte, etwa „Nachricht senden?“. Prüfe Empfänger, Betreff und Inhalt, bevor du bestätigst. Was ohne Rückfrage lief, trägt die Markierung Ohne Bestätigung ausgeführt. Die Karte selbst ist unter Werkzeuge im Chat: Rückfragen und Fehler beschrieben.
Achtung: Eine bestätigte Aktion wirkt direkt im verbundenen System. Eine gesendete E-Mail oder ein gelöschter Eintrag lässt sich in Intra AI nicht zurücknehmen.
Wenn etwas nicht klappt
- „Sie haben die Berechtigungsanfrage bei Google abgelehnt – es wurde nichts verbunden.“: Starte die Verbindung neu und stimm den Berechtigungen zu.
- „Der Verbindungsversuch ist abgelaufen oder wurde in einem anderen Tab gestartet.“ oder „Diese Verbindung wurde in einem anderen Browser oder Fenster gestartet.“: Wähle im selben Fenster erneut Verbindung hinzufügen.
- „Diese Integration ist noch nicht konfiguriert. Bitte den Admin, den OAuth-Client einzurichten.“: Die Integration ist sichtbar, aber deine Administration hat die Anmeldung beim Anbieter noch nicht eingerichtet.
- „Anmeldung am IMAP-Server abgelehnt – Passwort prüfen.“: Prüfe das Passwort. Verlangt dein Mailserver ein App-Passwort, verwende dieses.
- „Mailserver nicht erreichbar (IMAP).“ oder „Mailserver nicht erreichbar (SMTP).“: Prüfe Servername und Port.
- „… muss auf eine öffentliche Internetadresse zeigen.“ bei IMAP-Server oder SMTP-Server: Ein selbst eingetragener Server muss eine öffentliche Internetadresse haben. Ist dein Mailserver nur im Firmennetz erreichbar, bitte deine Administration, ihn als Vorlage einzurichten.
- Der Agent nutzt das falsche Konto: Prüfe den Konto-Chip in der Unterhaltung, die Konto-Bindung des Agenten und dein Standardkonto, in dieser Reihenfolge.
- Eine Integration fehlt im Katalog: Frag deine Administration, ob sie für deine Gruppe oder deinen Mandanten freigegeben ist.