Ticket-Classifier
Der Ticket-Classifier ordnet Support-Tickets, GitHub Issues oder andere Anfragen automatisch der passenden Dokumentations-Collection, dem Sub-Thema und dem Quell-Repository zu.
Der Classifier ist Teil des @processcube-io/knowledge-sdk SDK und kann sowohl ueber die
REST-API als auch als Library in eigenen Anwendungen genutzt werden.
Wie funktioniert es?
Der Classifier kombiniert zwei Strategien:
Fast Path (regelbasiert)
Bei eindeutigen Tickets (Konfidenz > 0.8) entscheidet das System sofort anhand von:
- Keyword-Matching — Ticket-Text gegen gewichtete Keywords pro Collection
- Tag-Matching — Tags/Markierungen gegen Collection-Namen
- Repo-Matching — Quell-Repository gegen Collection-Registry
- Feedback-Matching — Aehnliche korrigierte Tickets aus der Feedback-DB
Slow Path (LLM-Entscheider)
Bei unsicheren Tickets ruft das System einen LLM (z.B. GPT-4o-mini) auf, der die Top-3 Kandidaten, Doku-Treffer und Feedback-Hints analysiert.
Features
| Feature | Beschreibung |
|---|---|
| 12 Collections | Engine, Studio, Authority, LowCode, Cuby, Portal, PostgreSQL, AppTemplate, Clients, AppSDK, DevOps, Produkte |
| Sub-Themen | Feingranulare Zuordnung (z.B. engine/bpmn/timer-events) |
| Repo-Mapping | Automatische Zuordnung zum GitHub-Repository |
| Self-Improvement | Lernt aus Korrekturen ueber einen SQLite Feedback-Store |
| Relevante Doku | Liefert passende Dokumentations-Links zum Ticket |
| Begruendung | Erklaert warum die Zuordnung so getroffen wurde |
Schnittstellen
| Schnittstelle | Beschreibung |
|---|---|
| REST-API | POST /api/classify-ticket — fuer Webhooks, CI/CD, eigene UIs |
| MCP-Tool | classify_ticket — fuer KI-Agenten (Claude, etc.) |
| Library | TicketClassifier Klasse — fuer External Tasks, CLI-Tools |
Naechste Schritte
- Getting Started — Erster API-Call in 2 Minuten
- Klassifikations-Pipeline — Wie die Scoring-Engine funktioniert
- API-Referenz — Alle Endpoints mit Beispielen
- Als Library nutzen — Ohne API direkt in eigenen Anwendungen