Slack-Bot für Coding-Agents: Integriere deinen Sharkly-Agent in Slack

TL;DR

Ein Slack-Bot für Coding-Agents ist eine Slack-App, die an einen einzigen KI-Agent gebunden ist: Direktnachrichten und Erwähnungen werden dadurch zu Agent-Konversationen, und jede Antwort landet im selben Thread. In Sharkly ist jeder Bot an genau einen Agent gebunden, und dieser Agent antwortet mit den Anweisungen, dem Modell, den Skills und den Repositories, die Sie für ihn konfiguriert haben.

1. Öffnen Sie api.slack.com/apps, generieren Sie ein App Configuration Token und kopieren Sie anschließend dessen Refresh Token.
2. Öffnen Sie in Sharkly Integrations, wählen Sie Slack und dann Connect Agent.
3. Wählen Sie den Agent aus, der gebunden werden soll, und vergeben Sie optional einen App-Namen (Slack begrenzt App-Namen auf 35 Zeichen).
4. Fügen Sie den Refresh Token ein und wählen Sie Create & Install.
5. Bestätigen Sie die OAuth-Abfrage in dem Fenster, das Slack öffnet.
6. Warten Sie, bis der Bot-Status von Installing auf Connected wechselt, und senden Sie ihm dann eine Direktnachricht.

Warum Ihre Coding-Agents in Slack antworten sollten

Ihr Team nutzt bereits Coding-Agents. Bei der einen läuft Claude Code in einem Terminal, der andere skriptet Codex-Läufe, und die Ergebnisse verschwinden in der Shell-Historie der jeweiligen Person. Die Fragen, die diese Agents beantworten könnten, werden derweil in Slack gestellt – denn in Slack spricht das Team.

Diese Lücke kostet Zeit. Wenn eine Produktmanagerin fragt, warum der Export-Endpoint plötzlich fehlschlägt, geht die Frage an eine Entwicklerin, die einen Agent befragt und die Antwort weiterleitet. Dieses Weiterreichen kostet eine Stunde für eine Frage, die der Agent in neunzig Sekunden beantwortet hat.

Sharkly schließt diese Lücke von der Plattformseite aus. Sharkly ist kein Ersatz für Claude Code, Codex oder andere Ausführungstools, sondern ergänzt sie um eine gemeinsame Ebene für Tasks, Kontext, Steuerung und Review. Die Slack-Integration bringt diese Ebene in Ihren Workspace, sodass Kolleginnen und Kollegen die Antwort dort bekommen, wo die Frage gestellt wurde.

Zwei Verbindungen, zwei Aufgaben

Die Integration bietet zwei unabhängige Verbindungstypen, und ihre Verwechslung ist die häufigste Ursache für Verwirrung:

Es handelt sich um getrennte Installationen auf Basis getrennter Slack-Apps, und jede funktioniert unabhängig von der anderen. Zwei weitere Abgrenzungen: Ein Slack-Workspace lässt sich jeweils nur mit einer Sharkly-Organisation verbinden, und Slack-Aktionen in Space-Automations nutzen eine dritte Verbindung, bei der Slack in diesem Release als Aktion dient, aber keinen Workflow starten kann. Dieser Leitfaden behandelt die Agent-Bot-Bindung.

Was ist ein Sharkly-Agent-Slack-Bot?

Ein Agent-Bot verbindet einen Sharkly-Agent mit einer Slack-App. Nachrichten werden zu einer Agent-Konversation, und die Antwort kehrt in dieselbe DM oder denselben Thread zurück. Der Agent, der antwortet, ist derselbe konfigurierte Teamkollege wie überall sonst in Sharkly: gleiche Anweisungen, gleiches Modell, gleiche Skills und gleiches Repository-Wissen.

Die Bindung ist strikt eins zu eins, und Sie können sowohl Ihre eigenen Personal Agents als auch die Space-weit geteilten Agents binden, die Sie verwenden dürfen.

Die Installation bringt zwei Oberflächen mit. Direktnachrichten erzeugen eine Chat-Session für diesen DM-Kanal, und weitere Nachrichten führen sie fort, sodass der Agent den Kontext behält, statt kalt zu starten. Kanal-Erwähnungen entfernen die Erwähnung, schicken den Rest an den Agent und antworten in einem Thread, der an Ihrer Nachricht hängt.

@ReleaseShark summarize the decision in this thread and list the next steps

Sharkly ignoriert Nachrichten von anderen Bots, Ereignisse zu bearbeiteten Nachrichten und Beitrittsereignisse. Das verhindert Antwortschleifen, sobald sich mehrere Apps einen Kanal teilen.

So verbinden Sie einen KI-Agent mit Slack

Sie benötigen einen Agent, den Sie konfigurieren können (siehe Erste-Schritte-Anleitung), sowie die Berechtigung, ein Slack App Configuration Token zu generieren und eine App für das Ziel-Team zu installieren.

1. Öffnen Sie api.slack.com/apps und suchen Sie den Bereich Your App Configuration Tokens.
2. Generieren Sie ein App Configuration Token und kopieren Sie dessen Refresh Token (Slack-Doku). Behandeln Sie ihn wie ein Geheimnis und übermitteln Sie ihn ausschließlich über das Verbindungsformular von Sharkly.
3. Öffnen Sie in Sharkly Integrations und wählen Sie Slack.
4. Wählen Sie Connect Agent und dann den Agent, der gebunden werden soll.
5. Geben Sie optional einen App-Namen ein. Bleibt das Feld leer, wird der Name des Agent verwendet.
6. Fügen Sie den Refresh Token ein und wählen Sie Create & Install.
7. Schließen Sie die Slack-OAuth-Autorisierung in dem Fenster ab, das sich öffnet. Erscheint nichts, erlauben Sie Pop-ups und versuchen Sie es erneut.
8. Warten Sie, bis der Bot-Status von Installing auf Connected wechselt.

Sharkly tauscht den Refresh Token gegen ein kurzlebiges Configuration Access Token, erstellt die App anhand eines Manifests, das Bot-Identität, Slack-Assistant-Ansicht, OAuth-Redirect, Events-API-Callback und Scopes abdeckt, und öffnet dann Slack, um sie zu installieren.

Zum Prüfen senden Sie dem Bot eine DM. Eine Antwort bestätigt den gesamten Weg: Ereignis empfangen, Session erstellt, Lauf abgeschlossen, Antwort zugestellt. Bleibt der Bot im Status Installing hängen, hat der OAuth-Callback das Bot-Token noch nicht gespeichert – öffnen Sie das Installationsfenster erneut und schließen Sie die Abfrage ab. Lässt sich der Agent nicht auswählen, ist er bereits an eine andere App gebunden.

Slack-Bot-Trigger: Erwähnung, Emoji-Reaktion, jede Nachricht

Standardmäßig reagiert der Bot nur auf Direktnachrichten und Kanal-Erwähnungen, auf nichts anderes. In den Slack-Einstellungen des Agent ist jeder Trigger eine Zeile, die Sie umschalten können:

• Im Kanal erwähnt ist die Standardeinstellung. Der Agent läuft nur, wenn jemand den Bot nennt, und die Antwort landet in einem Thread unter der Erwähnung.
• Emoji-Reaktion im Kanal macht eine Reaktion zum Trigger. Reagieren Sie mit dem konfigurierten Emoji, und der Bot öffnet einen Thread mit dem umliegenden Kontext.
• Jede Kanalnachricht lässt den Agent auf gewöhnliche Nachrichten in Kanälen los, die Sie ausdrücklich auswählen. Das lässt sich nicht auf alle Kanäle anwenden, und andere Apps, die dort posten, können ihn auslösen.

Die entscheidende Kombination, die das Ganze sinnvoll hält: In geteilten Kanälen bleibt es bei reiner Erwähnung, denn breites Auslösen erzeugt Lärm und gibt dem Agent zusammenhanglosen Kontext preis. Schalten Sie Jede Kanalnachricht nur in einem dedizierten Kanal ein, in dem alle erwarten, dass Nachrichten den Agent erreichen. Der Emoji-Trigger liegt zwischen diesen Extremen, denn nichts erreicht den Agent, solange nicht jemand bewusst reagiert.

Jeder Kanal-Thread ist seine eigene Agent-Konversation: Zwei Threads in einem Kanal sind also zwei Sessions mit getrenntem Kontext, und man kann einen Thread fortsetzen, ohne den Bot erneut zu erwähnen. Die App aktiviert außerdem den Slack Assistant, den Bereich, den Slack für KI-Apps bereitstellt.

Eine Slack-Konversation ist kein Task

Agent-Bot-Konversationen erzeugen nie von selbst Tasks, und diese Grenze ist gewollt. Die Regel aus Chat versus Task-Zuweisung gilt unverändert: Chatten Sie, wenn Sie eine Antwort brauchen; weisen Sie einen Task zu, wenn Sie ein Ergebnis brauchen, das jemand prüft.

Wenn ein Agent aus Slack heraus einen Task erstellt, können Sie gleichzeitig den aktuellen Thread binden. Nach dem Binden bleiben Task-Kommentare und Thread-Nachrichten synchron. Genau diese Thread-Bindung macht die Integration wertvoll: Eine Diskussion beginnt in Slack, wird zu einem Task, und von da an fließen Fortschritt, Blocker und Ergebnisse in den Task zurück, während der Thread für die Beteiligten aktuell bleibt.

Wann ein Slack-Bot das falsche Werkzeug ist

Sie wollen nur Task-Erstellung und Link-Vorschauen. Dann nutzen Sie allein die Workspace-Verbindung. Slash-Befehle, Shortcuts, Linkbacks und Unfurls stammen alle aus der geteilten App.

Sie wollen geplante oder ereignisgesteuerte Kanalnachrichten. Das ist eine Slack-Aktion innerhalb eines Automations-Workflows, keine Konversation. Da Slack-Ereignisse in diesem Release keine Workflows auslösen können, starten Sie über einen Zeitplan, eine Statusänderung, ein Kommentar-Schlüsselwort oder einen Webhook.

Die Arbeit erfordert die Ausführung gegen ein Repository mit Review am Ende. Dann weisen Sie einen Task zu. Nutzen Sie den Bot zum Fragen und Tasks zum Bauen.

Sie wollen einen einzigen Bot, der Ihr gesamtes Aufgebot vertritt. Diese Bindung gibt es nicht. Mehrere Spezialisten, die bei echter Arbeit zusammenwirken, gehören in eine Crew, die an einem Task arbeitet – nicht in einen Kanal voller Bots.

Sicherheit und Berechtigungen

• Der App Configuration Refresh Token wird während des Setups ausgetauscht und nicht als installiertes Bot-Token verwendet. Das generierte Client Secret, das Signing Secret und das OAuth-Bot-Token werden verschlüsselt gespeichert.
• Events-API-Callbacks werden mit dem gespeicherten Signing Secret verifiziert; ungültige Signaturen werden abgelehnt und Event-Bodies sind in ihrer Größe begrenzt.
• Prüfen Sie die angeforderten Scopes vor der Autorisierung: Erwähnungen, Direktnachrichten, Thread-Verlauf in Kanälen und privaten Kanälen, Senden von Nachrichten, Öffnen von DMs und Assistant-Statusaktualisierungen.
• Owner und Admins verwalten den geteilten Workspace und alle Bindungen; Members verwalten Bindungen für Agents, die sie verwenden dürfen.

Das Trennen der Verbindung ist nicht destruktiv: Der Agent erhält über diesen Bot keine Nachrichten mehr, aber der Slack-Verlauf bleibt unangetastet und keine vergangene Nachricht wird zu einem Task.

Fazit

Ein Slack-Bot für Coding-Agents ist dann sinnvoll, wenn er ändert, wo die Konversation stattfindet, ohne zu ändern, wo die Arbeit liegt. Binden Sie einen Agent, dem Sie bereits vertrauen, behalten Sie die Standardeinstellung „nur bei Erwähnung“ bei, bis ein Kanal mehr verlangt, und nutzen Sie die Thread-Bindung, sobald aus einem Chat Arbeit wird. Falls Sie noch keinen Agent haben, legen Sie zuerst einen an.

Häufig gestellte Fragen

Muss ich erst einen Slack-Workspace verbinden, bevor ich einen Agent-Bot binde?

Nein. Die beiden Verbindungstypen sind unabhängig. Die Workspace-Verbindung brauchen Sie nur für die Task-Erstellung aus Slack, Linkbacks, Link-Vorschauen und Inbox-Benachrichtigungen per DM.

Kann ein Slack-Bot mehrere Sharkly-Agents bedienen?

Nein. Jeder Bot ist an genau einen Agent gebunden, und ein Agent hat immer nur eine Bindung. Um mehrere Agents in Slack zu bringen, legen Sie für jeden einen eigenen Bot an.

Entstehen beim Chatten mit dem Bot automatisch Tasks?

Nein. Wenn aus einer Konversation Arbeit wird, die einen Verantwortlichen, einen Status oder ein Review braucht, erstellen Sie den Task bewusst. Legt der Agent ihn aus Slack heraus an, können Sie den Thread binden, damit Kommentare und Nachrichten synchron bleiben.

Kann eine Slack-Nachricht einen Sharkly-Automations-Workflow starten?

In diesem Release nicht. Slack steht in Workflows als Aktion zur Verfügung, aber Slack-Trigger über die Events API sind noch nicht angebunden.