Wissensbasis organisieren¶
DeskAgent nutzt eine Wissensbasis, um dein Unternehmen zu verstehen. Je mehr Kontext du bereitstellst, desto besser kann die KI dir helfen.
Warum Wissen hinzufuegen?¶
Eine KI ohne Firmenwissen ist wie ein neuer Mitarbeiter am ersten Tag: motiviert, aber ahnungslos. Die Wissensbasis macht DeskAgent zu deinem Assistenten, der dein Unternehmen kennt.
Der Unterschied in der Praxis¶
| Ohne Wissensbasis | Mit Wissensbasis |
|---|---|
| Generische Antworten | Personalisiert fuer dein Unternehmen |
| "Sehr geehrter Kunde..." | "Sehr geehrter Herr Schmidt..." |
| Raet bei Preisen | Nutzt deine echte Preisliste |
| Standard-Vorlagen | Dein Firmen-Stil und Ton |
| Fragt staendig nach | Arbeitet selbststaendig |
Praxis-Beispiel
Du sagst: "Erstelle ein Angebot fuer die Pro Edition"
- Ohne Wissen: "Ich kenne deine Produkte nicht. Bitte gib Details an."
- Mit Wissen: Erstellt ein komplettes Angebot mit deinem Preis (999 EUR), deinen Firmendaten und deinen Standard-Konditionen.
Was die Wissensbasis ermoeglicht¶
- E-Mail-Antworten im Stil deines Unternehmens
- Angebote erstellen mit korrekten Preisen und Artikelnummern
- Kundenfragen beantworten basierend auf deinen FAQs
- Termine koordinieren mit Wissen ueber dein Team
- Rechnungen pruefen gegen deine Lieferanten-Daten
Ordnerstruktur¶
Alle Wissensdateien liegen im knowledge/ Ordner:
knowledge/
├── company.md <- Deine Firmeninformationen
├── products.md <- Produkte, Services und Preise
├── faq.md <- Haeufige Fragen und Antworten
├── customers.md <- Wichtige Kundeninformationen
└── templates.md <- E-Mail-Vorlagen und Signaturen
Was sollte enthalten sein?¶
| Datei | Beispiel-Inhalte |
|---|---|
company.md | Firmenname, Adresse, Kontaktdaten, Teammitglieder |
products.md | Produktnamen, Preise, Beschreibungen, Artikelnummern |
faq.md | Haeufige Kundenfragen mit Antworten |
customers.md | Wichtige Kunden, deren Praeferenzen, Sondervereinbarungen |
templates.md | E-Mail-Signaturen, Standard-Antworten, Grussformeln |
Wissen hinzufuegen¶
Option 1: Manuell bearbeiten¶
- Navigiere zu deinem
knowledge/Ordner - Erstelle oder bearbeite
.mdDateien mit einem Texteditor - Nutze einfache Markdown-Formatierung
- Starte DeskAgent neu, um Aenderungen zu laden
Option 2: DeskAgent machen lassen¶
Du kannst deine Wissensbasis auch direkt ueber DeskAgent verwalten:
"Erstelle eine neue Wissensdatei products.md mit unserer aktuellen Preisliste"
"Fuege die neue Mitarbeiterin Anna zur company.md hinzu"
"Aktualisiere die FAQ mit der Frage zu Rueckerstattungen"
DeskAgent hat eingebaute Tools zum Lesen, Schreiben und Aktualisieren von Wissensdateien. Beschreibe einfach, was du hinzufuegen oder aendern moechtest.
Das Beste aus beiden Welten
Starte mit manuellem Setup fuer die Grundstruktur, dann lass DeskAgent die Updates uebernehmen, wenn sich dein Unternehmen weiterentwickelt. Sag einfach "Merk dir, dass unsere neue Support-E-Mail help@firma.de ist" und DeskAgent aktualisiert die entsprechende Wissensdatei.
Beispieldateien¶
company.md¶
# Firmeninformationen
- **Name:** Muster GmbH
- **Adresse:** Musterstrasse 123, 10115 Berlin
- **Telefon:** +49 30 12345678
- **E-Mail:** info@muster.de
- **Website:** www.muster.de
## Team
| Name | Rolle | E-Mail |
|------|-------|--------|
| Max Mustermann | Geschaeftsfuehrer | max@muster.de |
| Anna Schmidt | Vertrieb | anna@muster.de |
| Tom Weber | Support | tom@muster.de |
## Bankverbindung
- **Bank:** Deutsche Bank
- **IBAN:** DE89 3704 0044 0532 0130 00
- **BIC:** COBADEFFXXX
products.md¶
# Produkte & Services
## Software-Lizenzen
| Produkt | Preis | Artikel-Nr. | Beschreibung |
|---------|-------|-------------|--------------|
| Pro Edition | 999 EUR | PRO-001 | Alle Funktionen, 1 Benutzer |
| Team Edition | 2.499 EUR | TEAM-001 | Alle Funktionen, 5 Benutzer |
| Enterprise | 4.999 EUR | ENT-001 | Unbegrenzte Benutzer |
## Services
| Service | Preis | Artikel-Nr. |
|---------|-------|-------------|
| Beratung | 150 EUR/Stunde | SVC-CON |
| Schulung | 1.200 EUR/Tag | SVC-TRN |
| Support-Paket | 500 EUR/Monat | SVC-SUP |
## Bundles
- **Starter Bundle:** Pro Edition + 4h Beratung = 1.500 EUR
- **Business Bundle:** Team Edition + 1 Tag Schulung = 3.500 EUR
faq.md¶
# Haeufig gestellte Fragen
## Lizenzierung
**F: Kann ich von Pro auf Team Edition upgraden?**
A: Ja, du zahlst nur die Differenz. Kontaktiere sales@muster.de.
**F: Laufen Lizenzen ab?**
A: Nein, Lizenzen sind unbefristet. Nur Support muss erneuert werden.
## Technisches
**F: Was sind die Systemanforderungen?**
A: Windows 10/11, 8GB RAM, 2GB Festplatte.
**F: Gibt es eine Mac-Version?**
A: Aktuell nicht. Wir empfehlen Parallels oder Boot Camp.
## Support
**F: Wie bekomme ich Hilfe?**
A: E-Mail an support@muster.de oder Anruf unter +49 30 12345678.
**F: Wie schnell antwortet ihr?**
A: Wir antworten innerhalb von 24 Stunden an Werktagen.
templates.md¶
# E-Mail-Vorlagen
## Signatur
Mit freundlichen Gruessen,
[NAME]
Muster GmbH
Telefon: +49 30 12345678
E-Mail: info@muster.de
www.muster.de
## Standard-Begruessung
Sehr geehrte/r [ANREDE] [NAME],
vielen Dank fuer Ihre Nachricht.
## Angebots-Einleitung
Anbei erhalten Sie unser Angebot basierend auf Ihren Anforderungen.
Dieses Angebot ist 30 Tage gueltig.
## Nachfassen
Ich wollte mich bezueglich meiner letzten E-Mail zu [THEMA] erkundigen.
Bitte lassen Sie mich wissen, wenn Sie Fragen haben.
Warum Wissen pflegen?¶
Die Wissensbasis ist kein einmaliges Setup - sie waechst mit deinem Unternehmen. Gepflegtes Wissen bedeutet bessere Ergebnisse.
Wann aktualisieren?¶
| Ereignis | Aktion |
|---|---|
| Neue Preise | products.md aktualisieren |
| Neuer Mitarbeiter | company.md ergaenzen |
| Haeufige Kundenfrage | In faq.md aufnehmen |
| Neues Produkt | products.md erweitern |
| Mitarbeiter verlaesst Firma | Aus company.md entfernen |
Veraltetes Wissen schadet
Wenn DeskAgent mit falschen Preisen oder ehemaligen Mitarbeitern antwortet, wirkt das unprofessionell. Lieber weniger Wissen als falsches Wissen.
Der Pflegeaufwand¶
- Initial: 30-60 Minuten fuer Grundsetup
- Laufend: 5 Minuten bei Aenderungen
- Quartalsweise: Kurzer Review ob alles aktuell ist
Best Practices¶
Empfohlen
- Halte es einfach - Nutze Tabellen und Aufzaehlungen
- Sei spezifisch - Echte Preise angeben, nicht "auf Anfrage"
- Bleib aktuell - Aktualisieren bei Preis- oder Teamaenderungen
- Nutze echte Beispiele - DeskAgent lernt von deinen Mustern
Vermeiden
- Sensible Daten - Keine Passwoerter oder API-Keys einfuegen
- Veraltete Infos - Alte Produkte oder ehemalige Mitarbeiter entfernen
- Zu viele Details - Fokus auf das, was fuer taegliche Aufgaben noetig ist
So funktioniert es¶
Wenn du DeskAgent startest:
- Alle
.mdDateien inknowledge/werden geladen - Der Inhalt wird Teil des KI-Kontexts
- Jede Antwort kann auf dein Wissen zugreifen
Automatisches Laden
DeskAgent laedt automatisch alle .md Dateien aus dem knowledge/ Ordner beim Start. Nach dem Bearbeiten von Dateien starte DeskAgent neu, um Aenderungen zu uebernehmen.
Unterordner¶
Du kannst zusammengehoeriges Wissen in Unterordnern organisieren:
knowledge/
├── company.md
├── products.md
└── linkedin/ <- Unterordner fuer Social Media
├── style.md <- Dein LinkedIn-Schreibstil
└── examples.md <- Beispiel-Posts
Unterordner werden automatisch beim Laden der Wissensbasis einbezogen.
Warum Agent-spezifisches Wissen?¶
Nicht jeder Agent braucht das gesamte Firmenwissen. Durch gezielte Zuweisung erreichst du:
Vorteile der Filterung¶
| Vorteil | Erklaerung |
|---|---|
| Schnellere Antworten | Weniger Kontext = schnellere Verarbeitung |
| Geringere Kosten | Weniger Tokens pro Anfrage |
| Praezisere Ergebnisse | Agent fokussiert auf relevantes Wissen |
| Bessere Sicherheit | Sensible Daten nur wo noetig |
Praxis-Beispiele¶
- Angebots-Agent: Braucht Preise und Firmendaten, aber keine LinkedIn-Vorlagen
- LinkedIn-Agent: Braucht Schreibstil-Beispiele, aber keine Bankdaten
- Rechnungs-Agent: Braucht nur Artikelnummern und Steuersaetze
- System-Agent: Braucht gar kein Firmenwissen
Faustregel
Lade nur das Wissen, das der Agent fuer seine Aufgabe wirklich braucht. Weniger ist oft mehr.
Agent-spezifisches Wissen konfigurieren¶
Du kannst in config/agents.json festlegen, welche Wissensdateien jeder Agent nutzt:
{
"create_offer": {
"knowledge": "company|products"
},
"linkedin_post": {
"knowledge": "linkedin"
},
"technical_agent": {
"knowledge": ""
}
}
Pattern-Referenz¶
| Pattern | Was wird geladen |
|---|---|
"company\|products" | company.md UND products.md |
"linkedin" | Alle Dateien im linkedin/ Unterordner |
"linkedin/style" | Nur linkedin/style.md |
"" (leer) | Nichts - Wissensbasis deaktiviert |
| (nicht angegeben) | Alle .md Dateien inkl. Unterordner |
Wann Wissen deaktivieren?
Technische Agents, die keinen Geschaeftskontext brauchen (wie Dateikonverter oder Systemchecks), koennen "knowledge": "" nutzen, um Tokens zu sparen und die Antwortzeit zu verbessern.
Naechste Schritte¶
-
Erste Aufgabe ausprobieren
Teste DeskAgent mit deinem neuen Wissen
-
Eigene Agents erstellen
Baue Workflows, die dein Wissen nutzen