Zum Hauptinhalt springen
Connic
Verbindungen

Slack

Ein mit Connic verbundener Slack-Bot startet Agenten über Erwähnungen und sendet deren Ausgaben an Slack-Channels.

Zuletzt aktualisiert
Inbound-Modus
Ein app_mention-Event startet jeden Agenten, der mit der Verbindung verknüpft ist. Der Inbound-Modus liefert die Ausgabe eines Agenten nicht selbst aus.

Funktionsweise

Slack signiert jede Anfrage an die Events API. Connic prüft Signatur und Zeitstempel, entfernt die Bot-Erwähnung aus dem Text, startet verknüpfte Agenten mit Metadaten zu Workspace, Channel, Nutzer und Thread und fügt der Slack-Nachricht anschließend 👀 hinzu, sobald der Start erfolgreich war.

Verknüpfe den Agenten für automatische Antworten mit einer Outbound-Verbindung, die dieselbe Slack-Verbindung verwendet. Connic sendet die Ausgabe dieses Runs dann an den ursprünglichen Slack-Thread zurück.

Einrichtung

1

Slack-Verbindung erstellen

Installiere Slack aus dem Marketplace für Verbindungen, wähle Create Slack connection, gib der App einen Namen und erstelle die Slack-Verbindung.

2

Slack-App erstellen und verifizieren

Öffne das generierte Manifest in Slack, speichere das Signing Secret in Connic und verifiziere anschließend die Events Request URL auf der App-Manifest-Seite von Slack. Connic erkennt die signierte Verifizierungsanfrage von Slack automatisch.

3

App installieren

Installiere die App im Workspace und speichere das xoxb- Bot User OAuth Token der App in Connic.

4

Verbindung erstellen und verknüpfen

Wähle den Inbound-Modus und die verifizierte Slack-Verbindung, erstelle die Verbindung und verknüpfe einen oder mehrere Agenten. Lade den Bot in jeden Channel ein, in dem Erwähnungen Runs starten sollen.

Input-Payload für den Agenten

payload.json
{
  "text": "Can you summarize today's incidents?",
  "user_id": "U01234567",
  "team_id": "T01234567",
  "channel_id": "C01234567",
  "thread_ts": "1724418000.123456",
  "event_id": "Ev01234567"
}

Beispiel-Agent

agents/slack-assistant.yaml
version: "1.0"
name: slack-assistant
type: llm
model: connic/gpt-5.6-terra
description: Answers questions from Slack mentions.
system_prompt: |
  Answer Slack questions clearly and concisely.

# input["text"] contains the mention text.
# A linked outbound Slack connector using the same Connection
# returns output to the originating thread.
Outbound-Modus
Verwende diesen Modus als automatische Outbound-Verbindung, Agent-Tool-Outbound-Verbindung oder Middleware-Outbound-Verbindung.

Funktionsweise

Automatische Outbound-Verbindungen senden die finale Ausgabe eines abgeschlossenen Runs und lassen sich auf ausgewählte Inputs beschränken. Agent-Tool- und Middleware-Outbound-Verbindungen senden nur, wenn sie aufgerufen werden. Connic übernimmt Slack-Formatierung, Routing, Zugangsdaten, Umgang mit Rate Limits und Wiederholungsversuche.

Einrichtung

1

Bot einladen

Lade die installierte App in jeden öffentlichen oder privaten Channel ein, der als Outbound-Ziel dienen soll.

2

Outbound-Verbindung erstellen

Wähle den Outbound-Modus und die Slack-Verbindung. Optional lässt sich aus den Channels, denen der Bot beigetreten ist, ein Standard-Channel auswählen. Erstelle anschließend die Verbindung.

3

Agenten verknüpfen

Verknüpfe alle Agenten, deren abgeschlossene Ausgabe über diese Slack-Verbindung ausgeliefert werden soll.

Agent-Tool- und Middleware-Outbound-Verbindungen

Eine Agent-Tool-Outbound-Verbindung stellt einen editierbaren Tool-Namen bereit, standardmäßig send_to_<connector_name>. Rufe eine Middleware-Outbound-Verbindung über send_connector mit ihrem konfigurierten Namen auf. Beide verwenden das nachfolgende Payload-Schema. text ist erforderlich; channel_id und thread_ts sind optional.

connector-payload.json
{
  "text": "Daily incident review complete: 3 resolved, 1 monitoring.",
  "channel_id": "C01234567",
  "thread_ts": "1724418000.123456"
}

Eine explizite Route hat Vorrang. Andernfalls antworten passende Inbound- und Outbound-Verbindungen mit derselben Slack-Verbindung im ursprünglichen Thread. Danach verwendet die Verbindung ihren optionalen Standard-Channel. Gespeicherte Channel- und Verbindungswerte werden dem KI-Modell nicht offengelegt.

Automatisches Ausgabeformat

output.json
{
  "text": "Daily incident review complete: 3 resolved, 1 monitoring.",
  "channel_id": "C01234567",
  "thread_ts": "1724418000.123456"
}

Bestehende Verknüpfungen ohne Einstellungen für Outbound-Verbindungen bleiben auf Automatic / All runs. Eine einfache finale Antwort wird als Text gesendet; JSON kann text, message oder body sowie die optionalen Routing-Felder oben verwenden.

Authentifizierung und Zugriff
  • Eingehende Anfragen werden über das Slack Signing Secret verifiziert und gegen Replay-Angriffe geschützt.
  • Signing Secrets und Bot-Tokens werden verschlüsselt und nach dem Speichern maskiert.
  • Slack akzeptiert nur Outbound-Ziele, in denen der Bot des Kunden posten darf.
  • Dieselbe verifizierte Slack-Verbindung kann von mehreren Verbindungen und Agenten wiederverwendet werden.