Files
Homme/WISSENSBASIS_PLAN.md
Mohammad Zwaib daf48f3f91 WordPress
2026-07-15 20:47:58 +02:00

148 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# HOEMMA Wissensbasis: Basisfakten-Plan
Stand: 15.07.2026 — Problem: Fragen zu Öffnungszeiten/Adresse erreichen die
lokale Wissensbasis nicht (bestDistance 0.610.70 > Schwelle 0.60) und laufen
teuer über die Websuche. Lösung: atomare Fakten-Dateien (ein Thema = eine Datei
= ein reiner Chunk).
---
## Schritt 1: Alte Sammeldatei aus der Datenbank entfernen
```sql
-- IDs der Chunks der alten Sammeldatei finden und löschen:
DELETE FROM document_chunck
WHERE document_id = (SELECT id FROM document WHERE source_url ILIKE '%basisfakten%');
DELETE FROM document
WHERE source_url ILIKE '%basisfakten%';
```
*(Sonst konkurriert die alte Misch-Datei mit den neuen atomaren Dateien.)*
---
## Schritt 2: Fünf atomare Word-Dateien erstellen
Jede Datei in Word anlegen, NUR den jeweiligen Text einfügen, als .docx
speichern und in den Humbee-Projektordner hochladen.
### Datei 1: `Borsig11_Oeffnungszeiten_AKTUELL.docx`
```
Wann ist das Büro geöffnet? Wie sind die Öffnungszeiten von Borsig11?
(AKTUELL, Stand: Juli 2026)
Die offiziellen aktuellen Öffnungszeiten des Büros der Machbarschaft Borsig11:
Montag bis Freitag von 11 bis 16 Uhr, sowie nach Vereinbarung.
Vor 11 Uhr ist das Büro geschlossen. Wer morgens früher kommen möchte,
sollte vorher telefonisch einen Termin vereinbaren.
Hinweis: Ältere Artikel auf der Website nennen teilweise veraltete
Öffnungszeiten (zum Beispiel aus dem Jahr 2021). Maßgeblich sind die hier
genannten aktuellen Zeiten: Montag bis Freitag, 11 bis 16 Uhr.
```
### Datei 2: `Borsig11_Adresse_AKTUELL.docx`
```
Wo befindet sich Borsig11? Adresse und Anfahrt (AKTUELL, Stand: Juli 2026)
Die Machbarschaft Borsig11 e.V. befindet sich in der Flurstraße 10,
44145 Dortmund. Das Büro liegt in der Dortmunder Nordstadt, direkt am
Borsigplatz, in den Gemeinderäumen der Heiligen Dreifaltigkeits-Kirche
(der BVB-Gründerkirche). Wer uns besuchen möchte: Flurstraße 10,
44145 Dortmund.
Hinweis: Bis Ende 2020 war das Büro am Borsigplatz 9 — diese alte Adresse
gilt nicht mehr.
```
### Datei 3: `Borsig11_Kontakt.docx`
```
Wie erreiche ich Borsig11? Kontakt, Telefonnummer und E-Mail
Telefon: 0231 / 80 41 81 50
E-Mail: info@borsig11.de
Adresse: Flurstraße 10, 44145 Dortmund
Website: www.borsig11.de
```
### Datei 4: `Borsig11_UeberUns.docx`
```
Was ist die Machbarschaft Borsig11? Wer seid ihr?
Die Machbarschaft Borsig11 e.V. ist ein gemeinnütziger Verein in der
Dortmunder Nordstadt am Borsigplatz. Der Verein macht Kultur- und
Nachbarschaftsprojekte mit und für die Bewohnerinnen und Bewohner des
Borsigplatz-Quartiers — zum Beispiel die Nordstadt Sessions (offene
Musikabende), kreative Workshops, die Givebox (Tauschregal), das
Schach-Café, die Schneiderei 103 und den Vollmond Talk.
```
### Datei 5: `HOEMMA_UeberDasProjekt.docx`
```
Was ist HOEMMA? Was ist die Human Library Ruhr?
HOEMMA Human Library Ruhr ist ein Projekt der Machbarschaft Borsig11.
HOEMMA ist ein KI-basierter Gesprächsbegleiter, der Erinnerungen,
Geschichten und Erfahrungen von Menschen aus Dortmund und dem Ruhrgebiet
sammelt und für Seniorinnen und Senioren zugänglich macht. Der Name kommt
vom Ruhrgebiets-Ausdruck "Hömma!" ("Hör mal!").
```
---
## Schritt 3: Einlesen
```
GET http://localhost:9192/knowledge-base/build
```
Prüfen, dass 5 neue Dokumente angelegt wurden:
```sql
SELECT id, source_url FROM document
WHERE source_url ILIKE '%oeffnungszeiten%'
OR source_url ILIKE '%adresse%'
OR source_url ILIKE '%kontakt%'
OR source_url ILIKE '%ueberuns%'
OR source_url ILIKE '%ueberdasprojekt%';
```
---
## Schritt 4: Testfragen (Postman, POST /chat/ask)
| Frage | Erwartung |
|---|---|
| Wie sind eure Öffnungszeiten? | bestDistance deutlich niedriger, `true`, Antwort 1116 |
| Wann habt ihr geöffnet? | dito |
| Kann ich morgen um 9 Uhr vorbeikommen? | "Büro öffnet erst um 11" |
| Bis wann ist das Büro heute offen? | "bis 16 Uhr" |
Log-Zeile je Frage notieren: `bestDistance … hatRelevantenKontext …`
---
## Falls Distanzen knapp über 0.60 bleiben
Schwelle in `RagService` moderat anheben (z. B. 0.65) — jetzt vertretbar,
weil der 2021-Chunk annotiert ist (VERALTET-Hinweis) und die atomaren
Chunks die nächsten Treffer sind.
---
## Zukunftsaufgabe (systemische Verbesserung, ~1 Tag)
**Cohere `input_type` einführen** (asymmetrisches Embedding):
- `AzureEmbeddingService.createEmbedding(text, inputType)` — Request um
`"input_type": "query"` bzw. `"document"` erweitern
- `RagService` (Nutzerfrage) → `"query"`
- `DocumentStorageService` (Chunks) → `"document"`
- Danach: ALLE Embeddings neu berechnen (Build + Ingest erneut ausführen)
Erwarteter Effekt: global bessere/niedrigere Distanzen im ganzen System.