Seminar Weaviate JavaScript- und TypeScript-Client

Dieses praxisorientierte Seminar behandelt typisierte Client-Verbindungen, Collection-Verwaltung, Datenoperationen, Batch-Import, Suchabfragen, Filter, generative Abfragen, Fehlerbehandlung, Tests und serviceorientierte Integration. Alle Arbeitsschritte werden an einer durchgängigen Referenzumgebung ausgeführt, geprüft und in wiederverwendbaren Arbeitsvorlagen dokumentiert.

Inhaltsübersicht

• Projekt und Verbindung
• Collections verwalten
• Datenoperationen
• Retrieval implementieren
• Generative Funktionen
• Anwendungsintegration
• Lernziele und Abnahmekriterien
• Praxisübungen und Betriebsdokumentation

Lernziele

• Anforderungen in den Bereichen Projekt und Verbindung, Retrieval implementieren und Anwendungsintegration 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. Projekt und Verbindung

Schwerpunkt: Paket, Laufzeit, TypeScript-Konfiguration, Cloud- oder lokale Verbindung, Zugangsdaten, HTTP und gRPC.

1. Anforderungen für Projekt und Verbindung erfassen: Paket, Laufzeit, TypeScript-Konfiguration, Cloud- oder lokale Verbindung, Zugangsdaten, HTTP und gRPC; 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. Collections verwalten

Schwerpunkt: Collection-Erstellung, Properties, Vektorisierung, Generativkonfiguration, vorhandene Collections und sichere Initialisierung.

1. Anforderungen für Collections verwalten erfassen: Collection-Erstellung, Properties, Vektorisierung, Generativkonfiguration, vorhandene Collections und sichere Initialisierung; 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. Datenoperationen

Schwerpunkt: Objekte anlegen, lesen, ändern, löschen, UUIDs, selbst bereitgestellte Vektoren und Batch-Import.

1. Anforderungen für Datenoperationen erfassen: Objekte anlegen, lesen, ändern, löschen, UUIDs, selbst bereitgestellte Vektoren und Batch-Import; 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. Retrieval implementieren

Schwerpunkt: Keyword-, Vektor- und Hybridabfragen, Filter, Zielvektoren, Metadaten, Paging und Aggregationen.

1. Anforderungen für Retrieval implementieren erfassen: Keyword-, Vektor- und Hybridabfragen, Filter, Zielvektoren, Metadaten, Paging und Aggregationen; 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. Generative Funktionen

Schwerpunkt: Single- und Grouped-Task, Prompt-Daten, Modellparameter, Quellenbindung, Fehlerfälle und Antwortobjekte.

1. Anforderungen für Generative Funktionen erfassen: Single- und Grouped-Task, Prompt-Daten, Modellparameter, Quellenbindung, Fehlerfälle und Antwortobjekte; 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. Anwendungsintegration

Schwerpunkt: Service-Schicht, Validierung, Timeouts, Retry, Logging, automatisierte Tests und Konfigurationsmanagement.

1. Anforderungen für Anwendungsintegration erfassen: Service-Schicht, Validierung, Timeouts, Retry, Logging, automatisierte Tests und Konfigurationsmanagement; 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: Projekt und Verbindung – Paket, Laufzeit, TypeScript-Konfiguration, Cloud- oder lokale Verbindung, Zugangsdaten, HTTP und gRPC in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
2. Übung 2: Collections verwalten – Collection-Erstellung, Properties, Vektorisierung, Generativkonfiguration, vorhandene Collections und sichere Initialisierung in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
3. Übung 3: Datenoperationen – Objekte anlegen, lesen, ändern, löschen, UUIDs, selbst bereitgestellte Vektoren und Batch-Import in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.
4. Übung 4: Retrieval implementieren – Keyword-, Vektor- und Hybridabfragen, Filter, Zielvektoren, Metadaten, Paging und Aggregationen in einer vorbereiteten Referenzumgebung konfigurieren, ausführen, mit Negativtests prüfen und in einem Abnahmeprotokoll dokumentieren.

Zielgruppe

JavaScript- und TypeScript-Entwickler, Backend-Teams und Entwickler von Web-, API- oder RAG-Anwendungen.

Voraussetzungen

Sichere JavaScript- oder TypeScript-Kenntnisse und grundlegendes Verständnis von Weaviate.