In diesem Leitfaden lernst du:Documentation Index
Fetch the complete documentation index at: https://docs.itellico.ai/llms.txt
Use this file to discover all available pages before exploring further.
- Wie Wissensdatenbanken, Ordner und Items strukturiert sind
- Wie du Inhalte für beste Retrieval-Qualität organisierst
- Wo die Entscheidungen für Context- und RAG-Mode in der Hierarchie liegen
- Grenzen für Items, Dateien und Ordner
Übersicht
Wissensdatenbanken geben deinem KI-Agenten Zugriff auf echte Unternehmensinformationen - Richtlinien, Prozesse, Produktdetails und alles, worauf dein Business basiert. Wenn du diese Informationen in eine strukturierte Hierarchie organisierst, kann dein Agent sie während des Gesprächs sofort abrufen und referenzieren. Diese Seite erklärt die Struktur von Knowledge-Inhalten. Für die Entscheidungstabelle zum Zugriffsmodus nutze Context vs RAG.Wissens-Architektur
Die dreistufige Hierarchie
Knowledge in itellicoAI folgt einer dreistufigen Struktur: Wissensdatenbank -> Ordner -> Items Items können Text, Dateien (PDF, Word, Excel, Markdown, CSV, JSON, YAML, XML), URLs (eine Web-Seite) oder Website-Crawls (mehrere Seiten einer Website) sein. Siehe content types für Details zu jedem Format. Diese Hierarchie macht es leicht, große Informationsmengen zu organisieren und trotzdem gut zugreifbar und wartbar zu halten.Wissensdatenbank-Liste
Gehe in der linken Seitenleiste zu Wissensdatenbanken, um alle Wissensdatenbanken in einer Tabelle zu sehen. Zugriff: Klicke im Hauptmenü auf Wissensdatenbanken. Die Liste zeigt Name, Item-Anzahl, Token-Verbrauch, Verarbeitungsstatus und den Zeitpunkt der letzten Aktualisierung. Du kannst suchen, sortieren und mehrere Wissensdatenbanken für Sammelaktionen auswählen.Kopierte Wissensdatenbanken
Wenn eine Wissensdatenbank über unterstützte Import-Flows kopiert wird, enthält die Kopie auch ihre Ordner und Items. Das System übernimmt das Indexing automatisch mit den Standardwerten der Plattform.Jede Ebene verstehen
Wissensdatenbanken
Was ist eine Wissensdatenbank?
Eine Wissensdatenbank ist der oberste Container, der zusammengehörige Informationen bündelt. Sie steht für eine große Kategorie oder einen Bereich deines Unternehmenswissens.
- Customer Support FAQ - Alle kundenorientierten Support-Informationen
- Product Documentation - Technische Doku, Benutzerhandbücher, Feature-Beschreibungen
- Company Policies - HR-Richtlinien, Compliance-Dokumente, interne Prozesse
- Sales Resources - Preissheets, Wettbewerbsvergleiche, Pitch Decks
Ordner
Was ist ein Ordner?
Ordner sind organisatorische Einheiten innerhalb einer Wissensdatenbank. Sie bündeln zusammenhängende Items nach Thema, Kategorie oder Zweck.
- Billing & Payments - Fragen zu Rechnungen, Zahlungsmethoden, Rückerstattungen
- Technical Issues - Troubleshooting, Fehlermeldungen, Workarounds
- Product Information - Features, Spezifikationen, Kompatibilität
- Return Policies - Rückgabezeiträume, Bedingungen, Prozessschritte
Einträge
Was ist ein Knowledge Item?
Einträge sind die eigentlichen Informationsbausteine - Dokumente, FAQs, Richtlinien, Prozesse oder beliebige Inhalte, die dein Agent kennen soll.
- Text-Einträge - Direkt geschriebener Inhalt
- Datei-Uploads - PDF, Word (.doc, .docx), Excel (.xlsx), Text (.txt, .log), Markdown (.md), CSV/TSV, JSON, YAML, XML (bis 10MB)
- URL-Scrapes - Inhalte von einer einzelnen Web-Seite
- Website-Crawls - Mehrere gefundene Seiten einer Website, optional mit Aktualisieren-Einstellungen
- “Refund Policy for Digital Products”
- “How to Reset Password - Step by Step”
- “Product Specifications - Model X200”
- “Shipping Times by Region”
Wann Wissensdatenbanken sinnvoll sind
Dein Agent muss konkrete Fragen beantworten
Dein Agent muss konkrete Fragen beantworten
Wenn Kunden regelmäßig nach Richtlinien, Prozessen oder Produktdetails fragen, lege diese Informationen in einer Wissensdatenbank ab. Dein Agent kann dann immer genau darauf zugreifen.Beispiel: Ein Kunde fragt “Wie lautet eure Rückgaberegelung?” Der Agent holt die exakte Regelung aus der Wissensdatenbank und erklärt sie natürlich.
Du hast umfangreiche Dokumentation
Du hast umfangreiche Dokumentation
Wenn du bereits Dokumentation hast - Benutzerhandbücher, FAQs, Richtliniendokumente - kannst du sie direkt in verschiedenen Formaten hochladen (PDF, DOC, DOCX, TXT). Dein Agent kann sie dann durchsuchen und referenzieren.Beispiel: Lade dein 50-seitiges Produktmanual hoch. Wenn Kunden technische Fragen haben, findet und erklärt dein Agent die relevanten Abschnitte.
Informationen ändern sich häufig
Informationen ändern sich häufig
Wissensdatenbanken machen es leicht, Informationen zu aktualisieren, ohne die Kernanweisungen deines Agenten zu ändern. Aktualisiere ein Preissheet oder ein Richtliniendokument, und dein Agent hat sofort die neuen Informationen.Beispiel: Du aktualisierst dein Preisdokument einmal, und alle Agenten, die diese Wissensdatenbank nutzen, referenzieren sofort die neuen Preise.
Mehrere Agenten brauchen dieselben Informationen
Mehrere Agenten brauchen dieselben Informationen
Erstelle eine Wissensdatenbank und teile sie mit mehreren Agenten. Pflege Informationen an einem Ort und nutze sie überall.Beispiel: Deine Wissensdatenbank “Product Specifications” kann vom Sales-Agent, Support-Agent und Pre-Sales-Qualifizierungsagenten genutzt werden.
Du möchtest Verantwortlichkeiten trennen
Du möchtest Verantwortlichkeiten trennen
Halte den Prompt deines Agenten von den sachlichen Informationen getrennt. Der Prompt definiert Persönlichkeit und Verhalten; Wissensdatenbanken liefern Fakten und Details.Beispiel: Dein Agent-Prompt sagt “sei freundlich und professionell”. Deine Wissensdatenbank enthält die eigentlichen Produktspezifikationen, Preise und Richtlinien.
Best Practices für die Organisation
Mit klaren Kategorien starten
Nach Abteilung
- Sales Knowledge
- Support Knowledge
- Billing Knowledge
- Technical Documentation
Nach Thema
- Product Information
- Policies & Procedures
- Troubleshooting
- FAQs
Nach Customer Journey
- Pre-Sales Information
- Onboarding Guides
- Usage & Features
- Support & Troubleshooting
Nach Zielgruppe
- Customer-Facing Info
- Internal Procedures
- Partner Resources
- Technical Specs
Benennungskonventionen
Verwende klare, konsistente Namen, die für dein gesamtes Team Sinn ergeben: Gute Beispiele:- Wissensdatenbank: “Customer Support Resources”
- Ordner: “Billing & Payments”
- Item: “Refund Policy - Digital Products”
- Wissensdatenbank: “KB_001”
- Ordner: “Misc Docs”
- Item: “Policy_v2_final_UPDATED”
Beispiel für eine gut strukturierte Wissensdatenbank
Hier ist ein Beispiel für eine gut organisierte E-Commerce-Wissensdatenbank: Ordnerinhalte:- Orders & Shipping: Tracking, Versandzeiten, internationale Infos, Änderungen
- Returns & Refunds: Richtlinie, Rücksendeprozess, Bearbeitungszeiten, Umtausch
- Products & Inventory: Kategorien, Lagerbestand, Spezifikationen
- Payment & Billing: Zahlungsmethoden, Rechnungen, Zahlungspläne
- Klare, beschreibende Ordnernamen, die verwandte Inhalte bündeln
- Ausgewogene Verteilung (3-4 Items pro Ordner)
- Leicht zu navigieren und Informationen schnell zu finden
- Skaliert gut, wenn du mehr Inhalte hinzufügst
Nur relevante Inhalte extrahieren
Best Practice für große Dokumente: Lade nicht ganze Handbücher oder Richtliniendokumente hoch, sondern extrahiere nur die Seiten oder Abschnitte, die dein Agent wirklich braucht.❌ Vermeiden: komplettes 200-seitiges Mitarbeiterhandbuch hochladen
❌ Vermeiden: komplettes 200-seitiges Mitarbeiterhandbuch hochladen
Problem:
- Der Agent findet und mischt irrelevante Abschnitte mit der richtigen Antwort
- Es wird schwieriger, die wirklich relevanten Stellen zu bestimmen
- Unnötiger Verbrauch von Gesprächsraum durch themenfremde Inhalte
✅ Besser: spezifische Abschnitte extrahieren
✅ Besser: spezifische Abschnitte extrahieren
Vorgehen:
- “Return Policy - Pages 45-48”
- “Shipping Policy - Pages 52-55”
- “Warranty Terms - Pages 89-92”
- Der Agent findet nur kundenrelevante Inhalte
- Klarere, genauere Antworten
- Effizienterer Einsatz des Gesprächsraums
- Exportiere konkrete Seiten aus PDFs als separate Dateien
- Kopiere relevante Abschnitte in TEXT-Items
- Nutze Website-Crawls nur, wenn du mehrere Seiten derselben öffentlichen Website brauchst
Regelmäßige Pflege
Quartalsweise prüfen
Plane regelmäßige Reviews deiner Wissensdatenbanken, damit die Informationen aktuell bleiben.
Veraltete Inhalte entfernen
Lösche Items, die nicht mehr relevant sind, oder entkopple sie von Agenten. Veraltete Informationen können deinen Agenten verwirren und falsche Antworten erzeugen.
Praxisbeispiele
SaaS Support Agent
SaaS Support Agent
Wissensdatenbank: “SaaS Product Support”Ordner:
- Account Management (15 Items)
- Passwort-zurücksetzen
- Anweisungen für Upgrades
- Informationen zum Billing-Zyklus
- Planvergleichstabelle
- Feature Documentation (47 Items)
- Einzelne Feature-Guides
- Integrations-Tutorials
- API-Dokumentation
- Best Practices
- Troubleshooting (23 Items)
- Häufige Fehlermeldungen
- Verbindungsprobleme
- Browser-Kompatibilität
- Performance-Optimierung
Healthcare Appointment Agent
Healthcare Appointment Agent
Wissensdatenbank: “Patient Services”Ordner:
- Appointment Policies (8 Items)
- Terminrichtlinien
- Stornierungsregelung
- Versicherungsanforderungen
- Ablauf für neue Patienten
- Office Information (5 Items)
- Standorte und Öffnungszeiten
- Parkhinweise
- Barrierefreiheitsinformationen
- Kontaktverzeichnis
- Insurance & Billing (12 Items)
- Akzeptierte Versicherer
- Zahlungsoptionen
- Billing-Fragen
- Finanzielle Unterstützung
E-Commerce Sales Agent
E-Commerce Sales Agent
Wissensdatenbank: “Product Catalog & Sales”Ordner:
- Product Specifications (89 Items)
- Detaillierte Produktbeschreibungen
- Technische Spezifikationen
- Kompatibilitätsinformationen
- Größentabellen
- Pricing & Promotions (15 Items)
- Aktuelle Preise
- Laufende Aktionen
- Mengenrabatte
- Saisonale Angebote
- Shipping & Delivery (7 Items)
- Versandoptionen
- Lieferzeiten
- Internationaler Versand
- Tracking-Informationen
Nächste Schritte
Wissensdatenbanken erstellen
Erstelle und organisiere dein Wissen Schritt für Schritt
Inhaltstypen
Lerne Text-, Datei-, URL- und Website-Crawl-Items kennen
Agenten zuweisen
Wissensdatenbanken mit deinen Agenten verbinden
Kontext vs. RAG
Den passenden Zugriffsmodus für deinen Anwendungsfall wählen
Support-Agenten-Beispiel
Ein vollständiges Beispiel mit Knowledge-gestütztem Support ansehen