Files
planer2/daten/RAG/agenten.md
2026-07-29 15:19:41 +02:00

9.8 KiB

Agenten

kern

Steuert Agentenaktivitaet und prueft deren Komponenten automatisiert

  • JSON-Ausgabe bei gesetztem --json Flag
  • Self-TestsFuehrenKeineMCPTransportAufrufeAus
  • AgentenaktivitaetSeiteAusQueryParameterPage
  • LimitZwischen1Und200Standardmaessig50
  • StreamingGibtJedesTokenSofortAus
  • Inspector liefert paths, meta und ndjson
  • paths zeigen konfigurierte Agentenlogikdateien
  • meta enthält Statistiken zur Agentenaktivität
  • ndjson enthält paginierte Aktivitätseinträge

Agentenaktivität anzeigen

Zeigt eine liste der agentenaktivitäten

  • Seite aus Query-Parameter page
  • Limit zwischen 1 und 200
  • Standardlimit 50
  • Admin-System-Agent abrufen
  • Antwort ist 200
  • Debug-Count zeigt Itemanzahl

Chat-Auswahl-Guard testen

Validiert dass der Chat-Auswahl-Guard korrekt funktioniert

  • Command mto:agent:knowledge-space:chat-selection-guard-self-test
  • json gibt strukturierte Daten aus
  • Exit-Code 0 bei Status OK, sonst 1
  • Command mit --json Flag ausführen
  • JSON mit status summary cases enthält
  • Exit-Code entspricht Status

Fähigkeiten ermitteln

Listet verfügbare Resources, Tools und Prompts eines Admin-MCP-Servers auf

  • Benötigt gespeicherten Admin-MCP-Server
  • read liest Resource-URIs metadaten
  • json maschinelles Format
  • Status ready bei erfolgreicher Erkennung
  • Runtime-Calls gezählt
  • Befehl mit gespeichertem Servernamen ausführen
  • Ausgabe auf Status ready prüfen
  • Resources, Tools und Prompts in Ausgabe

Hybrid-Tool-Auswahl testen

Stellt sicher, dass LLM-Vorschlag und RetrieX-Validierung bei der Tool-Auswahl zusammenarbeiten

  • Planner besteht eigenen Self-Test
  • AgentRunner nutzt LLM für Vorschlag vor RetrieX-Validierung
  • Loader zeigt Status beim Tool-Auswählen
  • Model-Config enthält dediziertes mcp_tool_selection-Modell
  • mto:agent:mcp:hybrid-tool-selection-planner-self-test --json ausführen
  • JSON-Ausgabe auf status OK prüfen
  • Alle vier Cases mit Status PASS vorhanden

MCP-Gateway trocken ausführen

Prüft ob eine Resource die Gateway-Policy erfüllt und welches Evidence erzeugt wird

  • Kein MCP-Transport wird geöffnet
  • fixture nutzt eingebaute Testdaten
  • Exit-Code 0 bei Status ready
  • json gibt Ergebnis als JSON aus
  • bin console mto agent mcp gateway-dry-run --fixture ausführen
  • Ausgabe zeigt status ready

MCP-Laufzeit-Gate prüfen

Prüft ob ein MCP-Read-Only-Zugriff erlaubt ist, ohne Transport zu öffnen

  • Gate ohne Transport öffnen
  • fixture nutzt eingebaute Testdaten
  • assume-enabled simuliert aktivierte MCP-Konfiguration
  • JSON-Ausgabe verfügbar
  • Console-Befehl mit --json ausführen
  • Exit-Code auf SUCCESS prüfen
  • JSON auf Status ready und Fehler prüfen

MCP-Laufzeitgrenze testen

Validiert, dass MCP-Server nur Admin-gesteuert und begrenzt in der Antwort-Runtime verwendet werden

  • McpDataRoomStore nur in Admin, CLI, ReadModels referenziert
  • Keine externen MCP-Abrufe in Runtime-Boundary
  • Keine Chat-, Retrieval- oder Evidence-Beruehrung
  • Tool-Nachweise unterscheiden sichtbare Tool-Ausfuehrung
  • Tool-first-Inhalts-Fallback bleibt im Statusprotokoll sichtbar
  • Live-Inhalts-Fallback buendelt MCP-JSON-RPC-Resource-Reads
  • Rueckgabewert pruefen: Exitcode 0 bestaetigt OK
  • Rueckgabewert pruefen: Exitcode 1 bestaetigt FAIL

MCP-Quelle prüfen

Prüft eine gespeicherte Admin-MCP-Quelle als registrierungskompatible Richtlinie

  • Lokale Prüfung ohne MCP-Transport
  • server wählt die gespeicherte Quelle
  • audit-all prüft alle Quellen
  • online führt einen Nur-Lese-Netzwerktest durch
  • json gibt nur Metadaten aus
  • mto:agent:mcp:admin-source-check --server=my_source
  • Ergebnis zeigt Status, Label und Fehler

Mit Agent chatten

Stellt Fragen an den KI-Agenten und empfängt Antworten in Echtzeit

  • Streaming-Ausgabe jedes Tokens sofort
  • Beendet auf Eingabe von exit
  • Beendet auf Strg+C
  • Leerer Prompt beendet
  • user-id Standardwert ist cli
  • mto:agent:chat ausführen
  • Frage eingeben
  • Antwort tokenweise empfangen
  • exit eingeben
  • CLI beendet

Performance-Cache leeren

Leert alle RetrieX Runtime-Caches und den Python Vector-Service-Query-Cache

  • Löscht den PHP Runtime-Cache
  • Löscht optional den Vector-Service-Query-Cache
  • skip-vector-service überspringt den Vector-Service-Cache
  • json gibt maschinenlesbare Ausgabe aus
  • php bin console mto:agent:performance:cache:clear json

Produktlabel-Formatierer testen

Validiert die p465-Formatter-Extraktion ohne Laufzeiteffekte

  • Liest nur lokale Quelldateien
  • Ruft keine Chat-, Retrieval-, Shop-, MCP- oder LLM-Dienste auf
  • Prüft AgentRunner-Delegation an ProductLabelFormatter
  • Prüft Formatter-Besitz reiner Anzeige-Methoden
  • Prüft Formatter-Besitz reiner Label-Methoden
  • Prüft Abwesenheit von Runtime-Dependencies im Formatter
  • Prüft Abwesenheit von p465-Methoden im AgentRunner
  • Prüft Dokumentationsabdeckung in allen Referenzdateien
  • Produktlabel-Formatter-Selbsttest mit --json ausführen
  • JSON zeigt status OK und 11 PASS

Release-Selbsttest bereitstellen

Validiert den v1.10.8 Release-Lock ohne Seiteneffekte im Chat-Pipeline, Agent-Runtime, Retrieval, Ranking, Shop, Followup, Evidence oder Truth Layer.

  • Prüft 22 Release-Artefakte
  • Prüft 8 zentrale Produktdokumente auf v1.10.8
  • Prüft 16 Required-Release-Phrasen
  • Liest nur lokale Dateien
  • Führt keine Chat-, LLM- oder MCP-Live-Aufrufe aus
  • Führt keine Retrieval-, Shop- oder Netzaufrufe aus
  • Ausgabe zeigt Status PASS
  • JSON zeigt status OK und runtime_calls 0

Ressource abrufen

Liest eine erlaubte MCP-Ressource über die CLI ab

  • Nur allowlisted Ressourcen abrufbar
  • MIME-Typ geprüft
  • Ergebnis enthält Status, Metadaten und Fehler
  • Befehl mit Optionen ausführen
  • Kurzformat prüfen
  • json Flag verwenden
  • Status ready und Ressource vorhanden

Ressource validieren

Ermöglicht das Prüfen, ob eine MCP-Ressource_URI auf der Allowlist steht

  • Prüft URI gegen konfigurierten Allowlist-Eintrag
  • Prüft MIME-Type gegen erlaubte Typen des Eintrags
  • Gibt Fehler und Warnungen aus
  • CLI-Exit-Code spiegelt Entscheidung wider
  • CLI-Befehl mit --server und --resource-uri ausführen
  • Option --mime-type ergänzen
  • Exit-Code zeigt Ergebnis an

Rollencode-Zuweisung prüfen

Validiert die p465b-Rollencode-Zuweisungs-Grenzen ohne Laufzeiteffekte

  • Prüft statische Artefakte nur
  • Keine Chat-, Retrieval- oder LLM-Laufzeit
  • Keine Shop-Suche
  • Keine MCP-Aufrufe
  • ProductLabelFormatter bleibt frei von Shop, Retrieval, Evidence und LLM
  • AgentRunner bleibt Orchestrator
  • Befehl ausführen: mto:agent:architecture:product-role-code-assignment-guard-self-test
  • Ausgabe auf Status OK prüfen
  • Ergebnis: status = OK oder FAIL mit Details

Stabilitäts-Selbsttest bereitstellen

Validierung der Shop- und Follow-up-Ankerwächter vor dem Deployment

  • Prüft REQUIRED_METHODS in AgentRunner.php
  • Prüft keine FORBIDDEN_GUARD_MARKERS in Ankerwächter-Methoden
  • Liest PATCH_MANIFEST.md und patch_history-Dateien
  • Erzeugt Report ohne Runtime-Seiteneffekte
  • json gibt maschinenlesbares Format aus
  • Binconsole mto:agent:shop-followup-anchor-stability-self-test
  • Status OK prüfen
  • passed größer 0 prüfen
  • failed gleich 0 prüfen
  • Binconsole mit --json
  • JSON-Status OK prüfen

System rebuild bereitstellen

Vektordienst steuern

Steuert den Vektorsuchdienst über die Kommandozeile

  • Rufzeit 300 Sekunden
  • Standard-Host 0.0.0.0
  • Standard-Port 8090
  • Ruft Vector-Kontrollskript auf
  • Status wird angezeigt

Wissensbatch finalisieren testen

Prüft die Verknüpfung von Batch-Abschluss und Bericht ohne Seiteneffekte

  • Prüft ohne Import, LLM-Aufruf oder Index-Rebuild
  • Neun Prüfungen für Routing, Report und Abhängigkeiten
  • Gibt FAIL bei einer einzigen fehlgeschlagenen Prüfung
  • JSON-Ausgabe enthält status, scope, checks und failed
  • Command ausführen: mto:agent:knowledge:batch-finalize-self-test
  • Ausgabe zeigt status OK oder FAIL
  • JSON-Flag setzen: --json
  • JSON enthält status und failed-Liste

MCP-Allowlist prüfen