dschlueter/my_voice_assistant_v3_jamulix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs: Weg-2 (Web-Suche) dokumentiert + Version 0.3.0

Browse source 
Web-Such-/Tool-Calling-Funktion in der Doku nachgezogen: CHANGELOG (0.3.0),
README, CLAUDE.md (Querschnitt), Architektur-Doc (§6.1), Bedienungsanleitung
(§5.5 Nutzer/Admin) und DEPLOYMENT (Tool-Faehigkeit des Modells).
Version 0.2.0 -> 0.3.0 (pyproject.toml).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-06-30 08:11:40 +02:00
commit eea25455cb
7 changed files with 78 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Docs/voice-assistant-architecture.md
View file

@ -159,6 +159,21 @@ geschrieben (`open → write_chunk → flush → close`) und **gleichzeitig** al
HTTP-Stream zurückgegeben (additiv). Bei lokalen Geräten ist `write_chunk` heute
ein No-op; `LoopbackOutput` sammelt die Chunks (testbar ohne Hardware).
### 6.1 Web-Suche / Tool-Calling („Weg 2")
`ToolCallingLLM` (`app/providers/llm/tool_calling.py`) ist ein LLMProvider, der
eine Agenten-Schleife abwickelt: das Modell entscheidet selbst, ob es das
`web_search`-Tool (`app/tools/web_search.py`, perplexity/sonar) ruft, und
formuliert die Antwort in Persona (Tool-Ergebnis hat Vorrang). Eingehängt als
Registry-Eintrag `openrouter-tools`; das geschichtete Flag `web_search_enabled`
(global an, pro Nutzer/Profil abschaltbar) wählt in `build_orchestrator`
tool-fähig vs. plain — selbe Präzedenz wie die Route. Ein deterministischer
**Backstop** (`app/pipeline/search_backstop.py`) erzwingt die Suche für heikle
Kategorien. Querschnitt: ephemere Beruhigungssätze (`fillers.py`),
Koreferenz-Vorstufe (`decontextualizer.py`), Citations im Trace, zentrale
Datum/Uhrzeit (`app/core/clock.py`). **Ausführliche Referenz:
[`weg2-tool-calling.md`](weg2-tool-calling.md).**
## 7. FastAPI-Endpunkte (umgesetzt)
| Methode & Pfad | Zweck |