Add C# Azure AI analysis tool and document evaluation runs

README.md

@@ -96,3 +96,51 @@ Azurite speichert seine Daten im angegebenen lokalen Verzeichnis.
 
 Lokaler Prototyp mit synthetischen Daten.
 Cloud-Deployment und KI-Anbindung stehen noch aus.
+
+## KI-Analyse aus C#
+
+`ImportAssist.Analyze` liest Analyseprompt, Schnittstellenbeschreibung
+und einen gespeicherten JSON-Prüfbericht ein und ruft Azure OpenAI auf.
+
+### Lokale Konfiguration
+
+User Secrets für das Projekt initialisieren:
+
+```bash
+dotnet user-secrets init --project tools/ImportAssist.Analyze
+```
+
+Folgende Konfigurationswerte im zugehörigen User-Secrets-Speicher setzen:
+
+- AzureOpenAI:Endpoint – Azure-OpenAI-Basisadresse der Ressource
+- AzureOpenAI:Deployment – importassist-analysis
+- AzureOpenAI:ApiKey – Schlüssel der Ressource
+
+API-Schlüssel ausschließlich lokal hinterlegen.
+User Secrets liegen außerhalb des Repositorys, sind aber unverschlüsselt.
+
+### Ausführen
+
+Alle Befehle aus dem Repository-Hauptverzeichnis ausführen:
+
+```bash
+dotnet run --project tools/ImportAssist.Analyze -- \
+  samples/invoices-report.json
+
+dotnet run --no-build --project tools/ImportAssist.Analyze -- \
+  samples/invoices-rejected-report.json
+```
+
+Azurite und der Functions-Host werden für diese gespeicherten Berichte
+nicht benötigt. Der Modellaufruf benötigt eine Internetverbindung.
+
+Die Analyse erscheint auf stdout; Statusmeldungen und Tokenverbrauch
+erscheinen auf stderr.
+
+Exitcodes:
+- 0: Modellantwort regulär abgeschlossen; keine fachliche Qualitätsgarantie.
+- 1: Konfigurations-, Datei- oder Aufruffehler.
+- 2: Modellantwort nicht regulär abgeschlossen.
+
+Die Antwort ist Freitext. Eine automatische fachliche Bewertung und
+ein verbindliches JSON-Ausgabeformat sind noch nicht implementiert.