Slack- & Teams-Bots

Organization Bot tab: Slack connected, Teams, channel scope with #payments scoped to a team, and MCP tools

Bring Archyl in die Tools, die dein Team ohnehin nutzt. Erwähne @Archyl in Slack oder Microsoft Teams und stelle Fragen zu deiner Software-Architektur — dem C4-Modell, ADRs, Abhängigkeiten, Verantwortlichkeiten und mehr — und erhalte direkt im Kanal Antworten, die auf deinen echten Daten beruhen.

Überblick

Der Bot wird pro Organisation verbunden. Sobald ein Administrator einen Workspace verbunden hat, kann jeder darin den Bot durch Erwähnen befragen. Der Bot antwortet mit den Berechtigungen des Administrators, der ihn verbunden hat, und sein Geltungsbereich sind die Projekte deiner Organisation.

Standardmäßig umfasst dieser Rahmen alle Projekte der Organisation. Ein Administrator kann jeden Kanal auf ein Team oder eine Auswahl von Projekten beschränken — siehe Einen Kanal auf ein Team oder Projekte beschränken weiter unten.

Der Bot antwortet auf zwei Arten:

Modus Wann Was du siehst
Direkt Kein API-Schlüssel ausgewählt Eine einzelne KI-Antwort, erstellt aus dem Kontext deiner Architektur.
Agentisch (MCP-Tools) Ein API-Schlüssel ist ausgewählt Der Bot ruft Live-MCP-Tools auf, um nachzuschlagen und zu handeln, und zeigt die Schritte (🔧 …) vor der endgültigen Antwort.

Du wechselst zwischen beiden, indem du unter Organisation → Bot → MCP-Tools einen API-Schlüssel auswählst (siehe MCP-Tools aktivieren unten).

Slack verbinden

  1. Gehe in Archyl zu Organisation → Bot.
  2. Klicke auf Zu Slack hinzufügen. Du wirst zu Slack weitergeleitet, um die Archyl-App zu autorisieren und einen Workspace auszuwählen.
  3. Nach der Zustimmung kehrst du zu Archyl zurück und der Workspace erscheint unter Verbunden.
  4. Lade den Bot in Slack in einen Kanal ein und erwähne ihn:
    @Archyl was hängt vom Payment-Service ab?

Der Bot antwortet in einem Thread, um Kanäle übersichtlich zu halten. Erwähne ihn erneut (im Kanal oder im Thread), um eine Folgefrage zu stellen.

  • Bearbeiten führt die Slack-Installation erneut aus (aktualisiert die Verbindung).
  • Trennen entfernt die Integration.

Microsoft Teams verbinden

Teams verwendet ein App-Paket und einen Einmal-Verbindungscode.

  1. Gehe in Archyl zu Organisation → Bot und klicke auf Teams-App herunterladen, um archyl-teams-app.zip zu erhalten.
  2. Installiere die App in Teams: Apps → Eigene Apps verwalten → Benutzerdefinierte App hochladen und wähle die .zip. (Falls du diese Option nicht siehst, muss ein Teams-Administrator das Hochladen benutzerdefinierter Apps erlauben oder sie in den App-Katalog deiner Organisation hochladen.)
  3. Klicke in Archyl auf Teams verbinden. Du erhältst einen Code wie @Archyl link 6GXH6NKL.
  4. Sende in Teams genau diese Nachricht an den Archyl-Bot (in einem 1:1-Chat einfach link 6GXH6NKL). Der Bot antwortet ✅ Mit deiner Archyl-Organisation verbunden.
  5. Erwähne ihn nun mit Fragen:
    @Archyl welches Team besitzt das API-Gateway?

Der Verbindungscode ist 15 Minuten gültig und einmalig verwendbar. Generiere jederzeit einen neuen über den Bot-Tab.

Hinweis: Microsoft-Teams-Bots erfordern ein Geschäfts- oder Schulkonto (Microsoft 365) — sie funktionieren nicht mit einem privaten Microsoft-Konto.

MCP-Tools aktivieren (agentischer Modus)

Standardmäßig antwortet der Bot direkt aus dem Kontext deiner Architektur. Damit er Live-MCP-Tools nutzen kann — Projekte per Name nachschlagen, Abhängigkeiten verfolgen, ADRs oder Dokumentation erstellen und mehr — gib ihm einen API-Schlüssel:

  1. Erstelle einen API-Schlüssel unter Profil → API-Schlüssel (oder verwende einen vorhandenen).
  2. Gehe zu Organisation → Bot → MCP-Tools und wähle diesen Schlüssel aus.
  3. Das war's — wenn das nächste Mal jemand den Bot erwähnt, schlussfolgert er mit den Tools des MCP-Servers über deine Architektur und zeigt jede Aktion vor der Antwort.

Der Geltungsbereich zählt:

  • Ein Lese-Schlüssel erlaubt dem Bot das Nachschlagen, aber keine Änderungen.
  • Ein Schreib-Schlüssel erlaubt zusätzlich das Erstellen oder Aktualisieren von Elementen, ADRs, Dokumentation usw. Wähle einen Schreibschlüssel nur, wenn der Bot Änderungen vornehmen soll.

Wähle jederzeit Keiner, um den agentischen Modus zu deaktivieren und zu direkten Antworten zurückzukehren.

Einen Kanal auf ein Team oder Projekte beschränken

Standardmäßig sieht jeder Kanal alle Projekte Ihrer Organisation. Oft ist das gewünscht — ein Kanal #zahlungen sollte aber in der Regel keine Fragen zur Kreditplattform beantworten.

Um ihn zu beschränken, gehen Sie zu Organisation → Bot → Kanal-Geltungsbereich und klicken Sie auf Kanal beschränken:

  1. Was der Kanal sieht — ein Team oder ein oder mehrere Projekte.
  2. Welcher Kanal — wählen Sie die Plattform, geben Sie dem Kanal einen Namen für die Liste und klicken Sie auf Befehl abrufen.
  3. Befehl einfügen — senden Sie @Archyl scope <code> in diesem Kanal. Der Bot bestätigt, und der Kanal erscheint in der Liste, sobald die Beschränkung angewendet wurde.

Codes sind 15 Minuten gültig und einmalig nutzbar. Um einen Kanal wieder zu öffnen, klicken Sie in der Liste neben ihm auf Aufheben.

Warum ein Code und kein Button? Der Bot antwortet mit den Berechtigungen des Administrators, der ihn verbunden hat, und kann nicht erkennen, wer in einem Kanal schreibt. Der Code ist die Autorisierung: Er wurde von einem Administrator in Archyl erzeugt, sodass der Geltungsbereich nicht von jedem geändert werden kann, der einfach im Kanal schreibt.

Einige Punkte, die Sie kennen sollten:

  • Der Team-Geltungsbereich folgt dem Team. Ein Projekt, das später zu einem beschränkten Team hinzukommt, ist automatisch abgedeckt — ohne den Kanal neu zu beschränken.
  • Der Geltungsbereich wird erzwungen, nicht vorgeschlagen. Er gilt für jeden Tool-Aufruf und jede Auflistung: Ein beschränkter Kanal kann kein anderes Projekt lesen, auch nicht auf Nachfrage per ID.
  • ADRs, Dokumente und API-Verträge auf Organisationsebene bleiben sichtbar — sie gehören der Organisation, nicht einem Projekt.
  • Der Name ist nur eine Bezeichnung. Der Bot hat keinen Zugriff auf Kanalnamen; der eingegebene Name ist das, was die Liste zeigt, gebunden wird der Kanal, in den Sie den Befehl einfügen.

Wie Berechtigungen funktionieren

  • Der Bot antwortet mit den Berechtigungen des Administrators, der den Workspace verbunden hat, im Rahmen der Projekte deiner Organisation.
  • Ein beschränkter Kanal sieht nur die Projekte seines Teams oder seiner Liste. Das wird bei jedem Tool-Aufruf und jeder Auflistung erzwungen, nicht dem Prompt überlassen.
  • Im agentischen Modus wird das, was der Bot lesen und ändern kann, zusätzlich durch den Geltungsbereich des ausgewählten API-Schlüssels bestimmt.
  • Jede Frage zählt zur KI-Nutzung deiner Organisation, genau wie der Chat in der App.

Tipps

  • Sei präzise mit Namen. Du kannst Projekte, Systeme, ADRs und Dokumente beim Namen nennen — der Bot ordnet sie den richtigen Elementen zu.
  • Frage im Thread weiter. Erwähne den Bot erneut, um eine Fragenreihe fortzusetzen.
  • Markdown funktioniert direkt. Antworten werden für jede Plattform formatiert (fett, Listen, Links, Code).
  • Beschränke geteilte Kanäle. Begrenze #zahlungen auf das Zahlungsteam, und die falsche Antwort landet nie mehr im falschen Kanal (Einen Kanal auf ein Team oder Projekte beschränken).

Nächste Schritte