Slack (schreibgeschützte Tools)
Eine schreibgeschützte Slack-Tool-Familie, Kanäle auflisten, Verlauf und Threads lesen, Nutzer nachschlagen und Nachrichten durchsuchen. Owner-only, veröffentlicht nie etwas.
Dieselbe Slack-Verbindung, mit der dein Agent DMs und @Erwähnungen beantwortet, dient zugleich als schreibgeschützte Tool-Familie: Dein Agent kann Kanäle auflisten, den Verlauf von Kanälen und Threads lesen, Nutzer des Workspace nachschlagen und Nachrichten durchsuchen, alles während er eine Aufgabe bearbeitet. Diese Tools lesen nur; sie veröffentlichen nie etwas. Das Veröffentlichen bleibt Aufgabe des Slack-Kanals.
Verbinden
Hier gibt es nichts Neues zu verbinden, die Tools nutzen dieselbe Verbindung wie der Slack-Kanal. Ist Slack bereits als Kanal verbunden, sind die Lese-Tools verfügbar; falls nicht, verbinde es einmal und beide Oberflächen werden aktiv.
- Folge Slack als Kanal verbinden, füge den Bot Token und das Signing Secret deiner Slack-App ein.
- Aktiviere die Slack-Lese-Tools für den Agenten, der sie verwenden soll.
- Der Agent kann Slack jetzt lesen, während er eine Aufgabe bearbeitet, veröffentlichen kann er über diese Tools weiterhin nicht.
Der entscheidende Haken: Diese Tools sind owner-only, sie laufen nur auf internen/Owner-Oberflächen (deinem eigenen Dashboard-Agenten), niemals für einen öffentlichen Website-Besucher. Und die Suche braucht mehr als einen Bot Token: slack_search_messages erfordert einen nutzerbezogenen Token mit search:read. Ein Workspace, der nur mit einem Bot Token verbunden ist, erhält die anderen sechs Tools, aber die Suche gibt einen klaren Fehler „requires a user token“ zurück.
Tools
| Tool | Zugriff | Typ | Funktion |
|---|---|---|---|
slack_list_channels | Nur Inhaber | Read | Listet öffentliche und private Kanäle auf, die der Bot sehen kann, id, Name, Thema/Zweck, Mitgliederanzahl und Archivierungsstatus. Per Cursor paginiert. |
slack_channel_history | Nur Inhaber | Read | Liest aktuelle Nachrichten aus einem Kanal: Absender, Text, Zeitstempel, Thread-Infos und Reaktionen. Nutze list_channels, um die Kanal-id zu finden. |
slack_thread_replies | Nur Inhaber | Read | Ruft die Antworten in einem Thread ab, ausgehend vom Zeitstempel der übergeordneten Nachricht aus dem Kanalverlauf. |
slack_channel_members | Nur Inhaber | Read | Listet die Teilnehmer eines Kanals auf und löst optional Nutzer-ids in Namen und E-Mail-Adressen auf. |
slack_list_users | Nur Inhaber | Read | Listet die Nutzer des Workspace auf, id, Name, echter Name, E-Mail (sofern verfügbar) und Bot-/Deaktiviert-Kennzeichen. Per Cursor paginiert. |
slack_user_info | Nur Inhaber | Read | Schlägt einen einzelnen Nutzer per id nach: Name, E-Mail, Zeitzone, Titel und Status. |
slack_search_messages | Nur Inhaber | Read | Durchsucht Nachrichten im gesamten Workspace mit Modifikatoren wie in-channel und from-user. Benötigt einen user token mit search:read. |
Das ist die gesamte Oberfläche: Jedes Tool oben ist schreibgeschützt, und hier schreibt nichts.
Public-safe vs. owner-only
Anders als Web Search ist keines der Slack-Tools public-safe. Jedes ist owner-only, der Agent erreicht sie nur auf einer internen/Owner-Oberfläche, und ein Besucher auf einem öffentlichen KI-Agenten löst sie nie aus. Das ist Absicht: Workspace-Kanäle, Nachrichtenverlauf und E-Mail-Adressen von Mitgliedern sind sensibel, deshalb sind die Tool-Aufrufe auch aus dem Unterhaltungsstream verborgen. Wenn du willst, dass der Agent in Slack für die Öffentlichkeit handelt, in DMs und auf @Erwähnungen antwortet, ist das der Slack-Kanal, eine separate Funktion.
Praxisbeispiel
Du fragst deinen eigenen Dashboard-Assistenten: „Was hat der Kanal #launch letzte Woche zur Preisseite entschieden?“ Der Agent führt slack_list_channels aus, um die id von #launch zu finden, slack_channel_history, um aktuelle Nachrichten zu holen, folgt einer Entscheidung mit slack_thread_replies in ihren Thread und fasst für dich zusammen, nur lesend, ohne je ein Wort in Slack zu veröffentlichen.
Schreibgeschützt, so gewollt
In dieser Familie gibt es keine Schreib-Tools. Der Agent kann auflisten, lesen und suchen, aber er kann nicht veröffentlichen, bearbeiten, reagieren, einladen oder archivieren. Alles, was der Agent in Slack sagen soll, läuft stattdessen über den Kanal.
Fehlerbehebung
- Die Tools erscheinen nicht. Sie sind owner-only, stelle sicher, dass du auf einer internen/Owner-Oberfläche bist (nicht auf einem öffentlichen Kanal) und dass Slack zuerst als Kanal verbunden ist.
- Die Suche gibt „requires a user token“ zurück.
slack_search_messagesbenötigt einen nutzerbezogenen Token mitsearch:read; ein Workspace mit nur einem Bot Token kann die anderen sechs Tools nutzen, aber nicht die Suche. - Private Kanäle fehlen. Der Bot sieht nur Kanäle, in denen er Mitglied ist, lade ihn in den privaten Kanal ein und liste dann erneut auf.
- Mitglieder erscheinen als IDs, nicht als Namen. Lass die Namensauflösung für
slack_channel_membersaktiviert, oder löse eine einzelne id mitslack_user_infoauf, Slack liefert Namen nicht immer inline mit.
FAQ
Kann der Agent über diese Tools veröffentlichen? Nein, sie sind streng schreibgeschützt. Das Veröffentlichen ist Aufgabe des Slack-Kanals.
Verbinde ich Slack zweimal? Nein. Eine Slack-Verbindung treibt sowohl den Kanal als auch diese Lese-Tools an.
Warum kann mein öffentlicher KI-Agent sie nicht nutzen? Sie legen Workspace-Daten offen, deshalb sind sie per Design owner-only und laufen nie für einen Besucher.
Nächste Schritte
- Slack-Kanal, die Verbindung, die diese Tools teilen, und wie der Agent in Slack spricht
- Custom API, verbinde jedes andere System mit deinem Agenten
- Übersicht der Integrationen, jede verbindbare App und Tool-Familie
E-Mail-Tools
Ein verbundenes Postfach ist auch eine Tool-Familie für den Agenten, E-Mails lesen, durchsuchen, öffnen, senden, beantworten, markieren und verschieben. Alle owner-only und getrennt von E-Mail-als-Kanal.
Wise
Verbinde Wise mit einem schreibgeschützten API-Token, damit dein Agent Wechselkurse nennen und Salden, Empfänger und Transaktionen lesen kann, er bewegt niemals Geld.