Integration von Dust mit GitHub und Zendesk: Ein Leitfaden für Support-Ticketing und Issue-Triage

Technischer Kundensupport und Technical Operations (TechOps) leiden häufig unter einer schmerzhaften Systemtrennung: Kundenanfragen, Service-Level-Agreements (SLAs) und Ticketverläufe werden in Zendesk verwaltet, während Code-Fixes, Fehlerverfolgung, Pull Requests (PRs) und Entwicklerdiskussionen in GitHub stattfinden. Wenn diese beiden Plattformen isoliert arbeiten, verbringen Support-Mitarbeiter Stunden damit, zwischen Browser-Tabs zu wechseln, GitHub-Repositories manuell nach Fehlermeldungen zu durchsuchen, Stack-Traces zu kopieren und Ingenieure in Slack nach dem Bearbeitungsstand zu fragen. Dies führt zu redundanten Bug-Reports und verzögerten Antwortzeiten.

Dust (dust.tt) überwindet diese Hürde nicht durch starre Punkt-zu-Punkt-Feldzuordnungen, sondern durch kontextbezogene KI-Orchestrierung. Durch die Anbindung von Zendesk und GitHub an Dust können Teams maßgeschneiderte KI-Agenten erstellen, die sowohl die Kundenkommunikationshistorie als auch die technische Codebasis verstehen. Diese Agenten triagieren eingehende Support-Tickets automatisch, verknüpfen Kundenbeschwerden mit bekannten GitHub-Issues, verfassen interne Fehleranalyse-Notizen und erstellen bei Bedarf standardisierte Entwicklungs-Issues – ganz ohne manuellen Kontextwechsel.

In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie eine integrierte Triage- und Eskalationsarchitektur mit Dust, Zendesk und GitHub aufsetzen.

Architekturüberblick: Wie Dust Support und Engineering verbindet

Um das Zusammenspiel von Dust mit Zendesk und GitHub zu verstehen, hilft die Unterscheidung der drei Funktionsschichten der Plattform:

Diese Architektur stellt sicher, dass Dust nicht bloß Daten spiegelt. Die Plattform fungiert als analytische Brücke: Sie interpretiert Kundensymptome in Zendesk vor dem Hintergrund des aktuellen Software-Entwicklungsstands in GitHub und führt kontrollierte Aktionen in beiden Systemen durch.

Schritt 1: Arbeitsbereichs-Datenverbindungen (Connections) einrichten

Damit Agenten eine präzise Diagnose stellen können, benötigt Dust Lesezugriff auf das historische Support-Wissen und die technischen Fehlerprotokolle.

1. Zendesk mit Dust verbinden

1. Navigieren Sie in Ihrem Dust-Workspace zu Spaces > Connections und wählen Sie Zendesk aus.
2. Geben Sie die Subdomain Ihrer Zendesk-Instanz ein (https://<subdomain>.zendesk.com).
3. Führen Sie die OAuth-Autorisierung mit einem Konto durch, das Administratorrechte sowohl in Dust als auch in Zendesk (mindestens für Support und Guide) besitzt.
4. Öffnen Sie die Verbindungseinstellungen unter Manage, um die Synchronisation anzupassen:
   • Ticket-Umfang & Aufbewahrungsfrist: Standardmäßig synchronisiert Dust gelöste (Solved) und geschlossene (Closed) Tickets der letzten 180 Tage mit einer rollierenden Löschung nach 120 Tagen. Falls Agenten auch laufende Incidents einbeziehen müssen, aktivieren Sie Sync Unresolved Tickets.
   • Datenschutz (PII-Maskierung): Aktivieren Sie Hide Customer Information, um Kundennamen und E-Mail-Adressen aus den Metadaten zu entfernen, während die technischen Fehlerbeschreibungen im Ticket erhalten bleiben.
   • Tag- und Feldfilterung: Verwenden Sie Included Tags (z. B. tier-2 oder bug), um die Synchronisation auf technische Tickets zu beschränken. Wenn Sie in Zendesk benutzerdefinierte Felder für betroffene Services oder Schweregrade nutzen, hinterlegen Sie die numerische ID unter Custom Field Tags. Dust erzeugt daraus filterbare Labels im Format fieldName:value.
   • Ratenbegrenzung: Legen Sie bei Bedarf ein Limit für Transaktionen pro Sekunde (TPS) fest, um strikte Zendesk-API-Limits nicht zu überschreiten.

2. GitHub mit Dust verbinden

1. Gehen Sie in Dust auf Spaces > Connections > GitHub und klicken Sie auf Connect.
2. Autorisieren Sie die Verbindung als Administrator der GitHub-Organisation.
3. Wählen Sie gezielt die Repositories aus, auf die Dust Zugriff erhalten soll (z. B. Backend-Dienste, Web-Frontends und SDK-Bibliotheken).
4. Aktivieren Sie optional Code synchronization: Dadurch kann der Agent Quellcode-Dateien im Standard-Branch analysieren. Der Code wird alle 8 Stunden neu indexiert, während Issues und PRs nahezu in Echtzeit aktualisiert werden.
5. Speichern Sie die Konfiguration. Dust erzeugt automatisch semantische Suchindizes basierend auf Titeln, Beschreibungen, Tags und Autoren.

Schritt 2: Aktions-Tools für Zendesk und GitHub aktivieren

Datenverbindungen verleihen dem Agenten Leserechte. Um Tickets aktiv abzufragen, interne Notizen zu verfassen und GitHub-Issues anzulegen, müssen die entsprechenden Tools aktiviert werden:

1. Gehen Sie zu Spaces > Tools und wählen Sie Add Tools.
2. Fügen Sie die Zendesk Tools hinzu:
   • Search Tickets: Suche über Abfragesyntax (z. B. status:open priority:urgent tags:bug).
   • Get Ticket: Abruf des vollständigen Kommentarverlaufs, der Metadaten und der SLA-Reaktionszeiten.
   • Draft Reply: Erstellung einer privaten internen Notiz (Private Comment) im Ticket, die für den Endkunden unsichtbar bleibt und dem Support-Mitarbeiter zur Prüfung vorgelegt wird.
3. Fügen Sie die GitHub Tools hinzu:
   • Wählen Sie den Berechtigungsmodus: Für automatisierte Workflows empfiehlt sich Workspace Credentials, wodurch alle Aktionen und Issues unter dem offiziellen Bot @dust-agent dokumentiert werden (alternativ Personal Credentials, um die individuellen Rechte des Benutzers zu nutzen).

Schritt 3: Triage-Agenten im Agent Builder konfigurieren

Erstellen Sie nun im Agent Builder einen spezialisierten Assistenten für technischen Support und Triage (z. B. mit dem Namen @tier2-triage).

Konfigurationsleitfaden

• Modell: Wählen Sie ein leistungsstarkes Modell mit exzellentem logischen Verständnis und Code-Analysefähigkeiten (z. B. Claude 3.5 Sonnet, GPT-4o oder Gemini 1.5 Pro).
• Wissensquellen (Knowledge): Verknüpfen Sie die Zendesk-Verbindung (Tickets und Help Center) und die GitHub-Verbindung (Repositories und Code).
• Tools: Aktivieren Sie Search Tickets, Get Ticket, Draft Reply von Zendesk sowie die GitHub-Tools zum Suchen und Erstellen von Issues.
• Systemanweisungen (Prompt): Definieren Sie eine klare Diagnosekette, Deduplizierungsregeln und Antwortstrukturen.

Du bist der Tier-2 Support und Issue Triage Copilot. Deine Aufgabe ist es, eingehende Zendesk-Tickets zu analysieren, sie mit unseren GitHub-Repositories abzugleichen und eine fundierte technische Fehlerdiagnose zu liefern.

Befolge bei der Analyse eines Zendesk-Tickets diese Schritte:
1. Extrahiere Fehlermeldungen, Stack-Traces oder unerwartetes Systemverhalten und prüfe im zuständigen GitHub-Repository (Standard: dust-tt/app-backend), ob bereits ein passendes offenes oder kürzlich geschlossenes Issue existiert.
2. Durchsuche historische Zendesk-Tickets, um festzustellen, ob dieses Problem bereits aufgetreten ist und ob ein verifizierter Workaround existiert.
3. Falls ein passendes GitHub-Issue gefunden wird:
   - Nutze das Zendesk-Tool "Draft Reply", um eine private interne Notiz (Private Comment) zu erstellen.
   - Die Notiz muss enthalten: (a) URL des GitHub-Issues und aktueller Status, (b) Zusammenfassung der Ursache, (c) Empfohlene technische Erklärung oder Übergangslösung für den Kunden.
4. Falls es sich um einen neuen, reproduzierbaren Softwarefehler handelt:
   - Erstelle über das GitHub-Tool ein neues Issue im Ziel-Repository im Format: [Triage] Kurzbeschreibung des Fehlers. Dokumentiere im Text die Zendesk-Ticket-ID, Systemumgebung, Reproduktionsschritte und vollständige Logs.
   - Erstelle eine interne Notiz in Zendesk mit Verweis auf die neu erstellte GitHub-Issue-Nummer.
5. Sende niemals direkte öffentliche Antworten an den Endkunden. Alle Ausgaben müssen als private interne Notizen oder als Antworten in der Dust-Seitenleiste formuliert werden, damit ein menschlicher Mitarbeiter sie vorab freigeben kann.

Schritt 4: Benutzeroberfläche und automatisierte Webhook-Trigger bereitstellen

Der fertige Agent kann in zwei sich ergänzenden Betriebsmodi eingesetzt werden: als On-Demand-Assistent in Zendesk und vollautomatisiert via Webhooks.

Modus A: Interaktiver Copilot in der Zendesk-Seitenleiste

1. Installieren Sie die offizielle Dust-App aus dem Zendesk Marketplace.
2. Öffnen Sie im Zendesk Admin Center die Einstellungen der Dust-App.
3. Tragen Sie Ihre Dust Workspace ID und einen von einem Administrator erstellten API Key ein.
4. Hinterlegen Sie im Feld Default Agent IDs die ID Ihres @tier2-triage-Agenten. Dadurch wird dieser Spezialist standardmäßig geladen, sobald ein Mitarbeiter ein Ticket öffnet.
5. Stellen Sie sicher, dass die E-Mail-Adresse des Zendesk-Benutzers mit seinem Dust-Konto übereinstimmt. Der Mitarbeiter kann nun direkt in der Seitenleiste fragen: "Gibt es für diesen Timeout-Fehler beim Checkout bereits einen Fix im Repository?", und erhält sekundenschnell eine Auswertung samt PR-Links.

Modus B: Autonome Triage über Webhook-Trigger

Um zeitkritische Tickets unmittelbar nach Eingang automatisch zu diagnostizieren:

1. Gehen Sie in Dust auf Spaces > Triggers und klicken Sie auf Add source.
2. Wählen Sie Zendesk als integrierten Provider und verknüpfen Sie Ihr Konto.
3. Navigieren Sie im Agent Builder von @tier2-triage zu Triggers > Add triggers und wählen Sie die erstellte Quelle aus.
4. Richten Sie die Trigger-Bedingungen ein:
   • Ereignis: Ticket Created (Ticket erstellt) oder Ticket Updated (Ticket aktualisiert).
   • Bedingung: Formulieren Sie den Filter in natürlicher Sprache (z. B. "priority is urgent or tags contain technical-escalation").
   • Payload übergeben: Aktivieren Sie Include webhook payload, damit Ticket-Titel, Beschreibung und Tags direkt an den Agenten übermittelt werden.
   • Ratenbegrenzung: Legen Sie ein 24-Stunden-Ausführungslimit fest, um Kostenexplosionen bei unvorhergesehenen Ticket-Spitzen zu verhindern.
5. Speichern Sie den Agenten. Geht nun ein relevantes Ticket ein, führt Dust die Analyse im Hintergrund aus und hinterlegt die interne Diagnose im Ticket, noch bevor ein Mitarbeiter es geöffnet hat.

Vergleich: KI-gestützte Dust-Triage vs. klassische Synchronisations-Plugins

Governance, Kostenplanung und Best Practices

1. Human-in-the-Loop-Prinzip wahren: Beschränken Sie automatisierte Agenten stets auf Draft Reply (private interne Notizen). Die finale Kommunikation mit dem Endkunden sollte immer durch einen menschlichen Support-Mitarbeiter autorisiert und versendet werden.
2. Webhook-Filter präzise definieren: Vermeiden Sie es, komplexe Sprachmodelle bei trivialen Anfragen (wie Passwort-Resets oder Rechnungsfragen) auszulösen. Begrenzen Sie Automatisierungen durch klare Tags und Prioritätsstufen auf echte technische Incidents.
3. Pläne und Credit-Verbrauch kalkulieren: Die Business-Tarife von Dust umfassen Pro (24 €/Sitz/Monat bei jährlicher Zahlung mit 8.000 Credits/Monat) und Max (120 €/Sitz/Monat bei jährlicher Zahlung mit 40.000 Credits/Monat). Für größere Teams bietet der Enterprise-Tarif gemeinsame Credit-Pools, SCIM-Provisionierung, Audit-Logs und dedizierte SLAs. Planen Sie das monatliche Credit-Budget passend zum erwarteten Webhook-Volumen.

Durch die intelligente Zusammenführung von Zendesk-Tickets und GitHub-Entwicklungsdaten mit Dust beseitigen Teams manuelle Reibungsverluste, beschleunigen die Fehlerbehebung und schaffen eine reibungslose Schnittstelle zwischen Support und Engineering.

Referenzen

• Zendesk Tools - Dust Docs
• GitHub Tools - Dust Docs
• Zendesk Connection - Dust Docs
• GitHub Connection - Dust Docs
• Dust in Zendesk - Dust Docs
• Webhooks - Dust Docs
• Customer Support - Dust Docs
• Dust Pricing: Business and Enterprise Plans for AI Agents