Architektur

BesluitBron ist ein Prozess auf einem Port. Dieser Prozess bedient drei Schnittstellen, die nichts voneinander wissen müssen: die MCP-Adressen für einen KI-Assistenten, die öffentliche Website und die Verwaltungskonsole. Jeder Pfad gehört genau zu einer Schnittstelle. Alles andere führt zu einem 404-Fehler.

Die Entscheidung für einen einzigen Prozess ist bewusst getroffen worden. Jede Quellenplattform in einem eigenen Dienst würde pro Plattform denselben Puffer, dieselbe Protokollierung und dieselbe Fehlerbehandlung erfordern. Die Frage „Welche Quellen bietet diese Installation?“ müsste dann pro Dienst beantwortet werden, anstatt an einer einzigen Stelle. Siehe Connectorregister.

Der Prozess von oben betrachtet

flowchart TD
    CL["KI-Assistent<br/>Claude Desktop,<br/>claude.ai, Claude Code"] --> MCP["MCP-Adressen<br/>/ mcp/ori bis<br/>/ mcp/unified /v1"]
    BE["Besucher von<br/>die Website"] --> SITE["Öffentliche Website<br/>16 Sprachen"]
    BR["Browser von<br/>der Verwalter"] --> ADM["Verwaltungskonsole<br/>Erkundungsfahrzeug, Logbuch,<br/>Dashboard"]
    CAT["ConnectorCatalog<br/>Welche Quellen werden<br/>angeboten"] --> MCP
    CAT --> SITE
    CAT --> ADM
    MCP --> SURF["McpConnectorSurface<br/>ein Werkzeugkasten<br/>pro Adresse"]
    SURF --> EXEC["ToolExecutor<br/>Zeitmessung, Herkunft,<br/>Protokollierung"]
    ADM --> QS
    EXEC --> QS["Suchdienste nach Plattform<br/>Aufbau der Suchanfrage"]
    QS --> UC["UpstreamCache<br/>nach Plattformen getrennt"]
    QS --> UP["Die Quellplattformen<br/>siehe Quellen"]
    EXEC --> LOG["McpRequestLog<br/>Tabelle plus Ringpuffer"]
    LOG --> DATA[("Lagerung<br/>Protokoll, Exporte,<br/>optionalPostgreSQL18")]
    LOG --> HUB["SignalR -Hub<br/>Live-Dashboard"]
    HUB --> BR

Die Quellplattformen sind hier als ein Block aufgeführt. Welche das sind und was die einzelnen Plattformen können und was nicht, ist für jede Plattform unter Bronnen aufgeführt.

Die festen Bestandteile

• ConnectorCatalog gibt als einziges eine Antwort auf die Frage, welche Quellen diese Anlage bereitstellt. Siehe Connectorregister;
• McpConnectorSurface stellt für jeden Konnektor einen eigenen Werkzeugkasten zusammen. Eine Sitzung erhält den Kasten, der zu der Adresse gehört, unter der sie eingegangen ist. Dadurch können acht Werkzeugkästen in einem Prozess nebeneinander existieren;
• ToolExecutor umgibt jeden Aufruf: Diese Komponente misst die Dauer, protokolliert die Herkunft und führt das Protokoll. Ein Tool, das diesen Schritt überspringen würde, wäre in der Nachverfolgung nicht erkennbar;
• Die Suchdienste der einzelnen Plattformen übersetzen eine Suchanfrage in die Suchsprache der jeweiligen Plattform. Sie entfernen aus der Eingabe die Zeichen, die die Suchsprache stören würden, und begrenzen den Umfang der Antwort;
• UpstreamCache ist nach Plattformen getrennt. Eine langsame oder fehlerhafte Plattform hat daher keinen Einfluss auf die anderen sechs. Siehe Buffering en Doorlooptijd.

Durch Hinzufügen einer Plattform werden Dateien hinzugefügt

Das Hinzufügen einer achten Quellplattform umfasst drei Schritte: das Hinzufügen von Dateien mit dem Namen dieser Plattform, das Hinzufügen eines Einstellungsblocks und das Einfügen einer Zeile in das Connector-Register. Bestehende Dateien werden dabei nicht geändert. Das ist keine Stilpräferenz. Das ist der Grund, warum die sechs Plattformen nach der ersten jeweils innerhalb weniger Tage freigeschaltet wurden, ohne die Funktionsweise der bestehenden zu beeinträchtigen.

Die Ausnahme ist klar angegeben. In den Menüs der Verwaltungskonsole und in der Fußzeile der Website werden die Regeln einzeln aufgeführt. Diese beiden Elemente werden daher bei einer neuen Quelle angepasst.

Weiterlesen

• Verloop van een Aanroep: Was bei einer einzelnen Frage Schritt für Schritt geschieht;
• Connectorregister: Wie das Ein- und Ausschalten funktioniert und warum „Aus“ auch wirklich „aus“ bedeutet;
• Buffering en Doorlooptijd: Wie lange dauert es, bis eine Antwort kommt, und welche Daten werden gespeichert?;
• Logging en Verantwoording: Was wird aufgezeichnet und wie kann man es sich ansehen?;
• Laadstatus: ob bei jeder Quellenplattform noch neues Material eingeht, mit den Schwellenwerten und den dazugehörigen Zahlen;
• Uitrol en Beheer: Wie der Dienst funktioniert und wie er aktualisiert wird.