sql_gen.py

SQL-Generierung mit echter Validierung: erzeugtes SQL wird per EXPLAIN gegen PostgreSQL geprüft; bei Fehlern korrigiert sich der Agent selbst (Retry).

Für wen: Text-zu-SQL-Anwendungen mit Sicherheitsnetz.

So nutzt du es

Lauffähige Python-Beispiele: Datei herunterladen, pip install pydantic-ai und mit gesetztem API-Key ausführen. Gut kommentierter Einstieg in typsichere Agenten.

Im Detail

sql_gen.py demonstriert Text-zu-SQL mit eingebautem Sicherheitsnetz: Der Agent generiert eine SQL-Query aus einer natürlichsprachlichen Anfrage, lässt sie aber vor der Ausführung per EXPLAIN gegen eine echte PostgreSQL-Datenbank validieren. Schlägt das fehl, bekommt der Agent die Fehlermeldung zurück und korrigiert die Query selbst (Retry-Schleife) – statt kaputtes SQL einfach zurückzugeben, wie es viele einfache Text-zu-SQL-Demos tun. Das macht den Ansatz deutlich robuster für echte Anwendungen. Wichtig: EXPLAIN prüft nur Syntax/Plan, keine Berechtigungen oder Datenrisiken – für Produktionseinsatz sollten zusätzlich ein Read-only-DB-User und Query-Whitelisting ergänzt werden.

Praxis-Tipp

Mit einer Testdatenbank und ein paar absichtlich mehrdeutigen Fragen ausprobieren (z. B. “Umsatz nach Monat letztes Jahr”), um zu sehen, wie der Agent nach einem EXPLAIN-Fehler die Query anpasst.

Siehe auch

• rag.py
• weather_agent.py

Lizenz & Quelle

• Lizenz: MIT
• Quelle: pydantic/pydantic-ai

Lade …