Seminar Weaviate Query Agent und agentische Suche

Dieses praxisorientierte Seminar behandelt natürlichsprachliche Suchaufträge, Auswahl geeigneter Collections, Ask- und Search-Modi, Filter und Aggregationen, Abfrageplanung, Rückgaben, Quellenkontrolle, Sicherheitsgrenzen und Evaluation. Alle Arbeitsschritte werden an einer durchgängigen Referenzumgebung ausgeführt, geprüft und in wiederverwendbaren Arbeitsvorlagen dokumentiert.

Inhaltsübersicht

• Agentischer Suchauftrag
• Daten- und Collection-Vorbereitung
• Ask-Modus
• Search-Modus
• Kontrolle und Sicherheit
• Evaluation und Integration
• Lernziele und Abnahmekriterien
• Praxisübungen und Betriebsdokumentation

Lernziele

• Anforderungen in den Bereichen Agentischer Suchauftrag, Search-Modus und Evaluation und Integration strukturiert analysieren und in eine umsetzbare Weaviate-Konfiguration überführen.
• Collections, Daten, Abfragen oder Betriebsparameter nachvollziehbar konfigurieren und mit reproduzierbaren Prüfungen verifizieren.
• Fehlersituationen systematisch eingrenzen, geeignete Diagnoseinformationen erfassen und belastbare Korrekturmaßnahmen ableiten.
• Qualität, Leistung, Sicherheit und Wartbarkeit anhand definierter Kriterien bewerten und die Lösung für den Regelbetrieb dokumentieren.

Schritt-für-Schritt-Inhalte

1. Agentischer Suchauftrag

Schwerpunkt: Benutzerfrage, Informationsbedarf, zulässige Collections, Antwortform, Quellenanforderung und Sicherheitsgrenzen.

1. Anforderungen für Agentischer Suchauftrag erfassen: Benutzerfrage, Informationsbedarf, zulässige Collections, Antwortform, Quellenanforderung und Sicherheitsgrenzen; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

2. Daten- und Collection-Vorbereitung

Schwerpunkt: Beschreibungen, Properties, Datentypen, relevante Metadaten, Suchbarkeit, Filterbarkeit und Testdaten.

1. Anforderungen für Daten- und Collection-Vorbereitung erfassen: Beschreibungen, Properties, Datentypen, relevante Metadaten, Suchbarkeit, Filterbarkeit und Testdaten; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

3. Ask-Modus

Schwerpunkt: natürlichsprachliche Frage, Ziel-Collections, Antwortgenerierung, Quellenobjekte, Zusatzinformationen und Fehlerfälle.

1. Anforderungen für Ask-Modus erfassen: natürlichsprachliche Frage, Ziel-Collections, Antwortgenerierung, Quellenobjekte, Zusatzinformationen und Fehlerfälle; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

4. Search-Modus

Schwerpunkt: Suchplanung, strukturierte Ergebnisse, Filter, Aggregationen, Limits, Weiterverarbeitung und eigene Antwortlogik.

1. Anforderungen für Search-Modus erfassen: Suchplanung, strukturierte Ergebnisse, Filter, Aggregationen, Limits, Weiterverarbeitung und eigene Antwortlogik; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

5. Kontrolle und Sicherheit

Schwerpunkt: Collection-Freigaben, Mandantenkontext, Authentifizierung, sensible Properties, Prompt Injection und Ausgabekontrolle.

1. Anforderungen für Kontrolle und Sicherheit erfassen: Collection-Freigaben, Mandantenkontext, Authentifizierung, sensible Properties, Prompt Injection und Ausgabekontrolle; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

6. Evaluation und Integration

Schwerpunkt: Testfragen, Antworttreue, Retrieval-Abdeckung, Latenz, Kosten, Fallbacks und Service-Integration.

1. Anforderungen für Evaluation und Integration erfassen: Testfragen, Antworttreue, Retrieval-Abdeckung, Latenz, Kosten, Fallbacks und Service-Integration; Zielzustand, Eingaben, Abhängigkeiten und messbare Prüfkriterien in einer Arbeitsvorlage festhalten.
2. Technische Grundlage konfigurieren: passende Collections, Properties, Clients, Modelle, Indizes oder Infrastrukturparameter auswählen und jede Einstellung mit ihrem Zweck dokumentieren.
3. Vorgehen mit repräsentativen Daten ausführen: Ausgangszustand prüfen, Operation schrittweise durchführen, Rückgaben protokollieren und das erwartete Verhalten gegen die Prüfkriterien vergleichen.
4. Fehler- und Grenzfälle untersuchen: ungültige Eingaben, fehlende Berechtigungen, leere Ergebnisse, Zeitüberschreitungen oder Ressourcenengpässe gezielt auslösen und diagnostizieren.
5. Ergebnis absichern: Qualität, Latenz, Ressourcenbedarf, Sicherheit und Wartbarkeit bewerten; Konfiguration und Wiederholungsablauf als wiederverwendbares Runbook festhalten.

Praxisübungen

1. Übung 1: Agentischer Suchauftrag – Benutzerfrage, Informationsbedarf, zulässige Collections, Antwortform, Quellenanforderung und Sicherheitsgrenzen in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
2. Übung 2: Daten- und Collection-Vorbereitung – Beschreibungen, Properties, Datentypen, relevante Metadaten, Suchbarkeit, Filterbarkeit und Testdaten in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
3. Übung 3: Ask-Modus – natürlichsprachliche Frage, Ziel-Collections, Antwortgenerierung, Quellenobjekte, Zusatzinformationen und Fehlerfälle in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
4. Übung 4: Search-Modus – Suchplanung, strukturierte Ergebnisse, Filter, Aggregationen, Limits, Weiterverarbeitung und eigene Antwortlogik in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.

Zielgruppe

AI Engineers, RAG-Entwickler, Data Scientists, Search Engineers und technische Produktteams.

Voraussetzungen

Gute Weaviate-Grundkenntnisse, Erfahrung mit Retrieval und grundlegendes Verständnis generativer Modelle.