Stecker

Ein Connector ist in BesluitBron eine MCP-Adresse mit einem Toolkit, einem Schalter in den Einstellungen und einer Verbindungsseite. Er ist die Einheit, über die sich ein Benutzer anmeldet und die ein Administrator aktivieren und deaktivieren kann.

Ein Connector ist nicht dasselbe wie ein Bronplatform. Mit einer Ausnahme steht jeder Connector für genau eine Quellplattform. Der eine, Alle Bronnen, liest selbst nichts ein: Er stellt die Tools aller anderen unter einer einzigen Adresse bereit, jeweils mit dem Namen der Quelle davor. Es gibt also immer einen Connector mehr als es Quellen gibt.

Warum jede Quelle eine eigene Adresse hat

Ein KI-Assistent wählt ein Werkzeug anhand seiner Beschreibung aus. Je mehr Werkzeuge gleichzeitig im Bild sind, desto häufiger fällt die Auswahl falsch aus. Das Modell richtet seine Aufmerksamkeit dann stärker auf die Auswahl als auf die Frage. Sieben Werkzeugkästen gleichzeitig bedeuten über sechzig Beschreibungen, die um Aufmerksamkeit konkurrieren.

Die daraus resultierende praktische Regel lautet: Wählen Sie die Quelle, die zur jeweiligen Frage passt. Wer nach einem kommunalen Beschluss sucht, ist bei Open Raadsinformatie gut aufgehoben. Wer eine Frage stellt, die mehrere Verwaltungsebenen gleichzeitig betrifft, wählt Alle Bronnen und nimmt den größeren Auswahlspielraum in Kauf.

Was alle Steckverbinder gemeinsam haben

Jeder Connector bietet zwei Werkzeuge, die sich nicht auf den Inhalt beziehen, unabhängig von der zugrunde liegenden Quelle:

• list_capabilities: Welche Tools diese Adresse enthält, welche Frage jedes Tool beantwortet und welche Quelle dahintersteht. Ein Assistent ruft dieses Tool auf, wenn nicht klar ist, welche Quelle die Frage beantworten kann. Die Antwort gibt auch an, welche Version von „BesluitBron“ geantwortet hat (server und server_version). Diese Nummer gehört in eine Störungsmeldung, denn ohne diese Nummer lässt sich nicht nachvollziehen, welche Version eine Antwort erstellt hat;
• list_platform_calls: Welche Aufrufe an die Quellplattform wurden in dieser Sitzung getätigt, mit Angabe ihrer Dauer und ihres Umfangs. Damit lässt sich im Nachhinein nachvollziehen, worauf eine Antwort basiert, siehe Logging en Verantwoording;
• platform_status: Gibt an, ob die Quelle noch neues Material erhält; stammt aus derselben Messung wie Laadstatus, verfügbar ab Version 1.3.36. Eine Assistentin sollte dies abfragen, bevor sie zu dem Schluss kommt, dass etwas nicht existiert: Ein leeres Suchergebnis aus einer stillstehenden Quelle ist kein Beweis dafür, dass nichts vorhanden ist. Die Antwort gibt für jede Quelle den Status an, und bei den beiden lokalen Quellen auch, wie viele Organe stillstehen und bis wann ihr Material läuft.

Darüber hinaus gilt für jedes Tool, das eine Ergebnisliste ausgibt, die Verpflichtung, anzugeben, wie genau dieses Ergebnis ist. Diese Regel ist unter Zoekprecisie zu finden und wird durch einen Test erzwungen. Ein Such-Tool, das die Felder weglässt, wird nicht in die Struktur aufgenommen.

Was ein Werkzeug über sich selbst verrät

Jedes Tool enthält drei Elemente, die bereits vor dem Aufruf bekannt sind:

• ein Name, den das Modell auswählt, zum Beispiel search_documents;
• ein Titel in Alltagssprache, den ein Nutzer liest, zum Beispiel „Ratsunterlagen suchen“. Auf Alle Bronnen ist die Quelle dafür angegeben, da mehrere Konnektoren über ein Tool namens „Bevorstehende Sitzungen“ verfügen;
• Die Meldung, dass das Tool nur liest. „BesluitBron“ ändert bei einer Quellplattform nichts, daher trägt jedes Tool diese Meldung.

Diese letzte Meldung spart Arbeit. Viele Clients führen ein reines Lese-Tool aus, ohne bei jedem Aufruf eine Bestätigung anzufordern. Bis zur Version 1.3.35 enthielten die dreizehn Tools von Open Raadsinformatie diese Meldung nicht, sodass ein Benutzer dort jeden Aufruf einzeln bestätigen musste. Ab Version 1.3.36 enthalten alle Tools aller Konnektoren sowohl einen Titel als auch diese Meldung.

Was „list_capabilities“ über die Installation sagt

Neben der Beschreibung der einzelnen Quellen enthält die Antwort sechs Angaben, die sich auf diese Anlage und nicht auf das Material beziehen:

• server und server_version: Welche Software hat geantwortet und welche Version. Diese Nummer gehört in eine Störungsmeldung;
• server_time_utc: die Uhr des Servers selbst. Jeder Datumsfilter und jedes Tool für anstehende Besprechungen rechnet ab dem heutigen Tag. Ein Assistent, der sich beim Datum irrt, erstellt einen falschen Zeitraum, ohne dass dabei etwas schiefgeht;
• current_through pro Quelle: bis wann der Berichterstattungsumfang gilt. Ohne diese Angabe lässt sich „nicht gefunden“ nicht von „außerhalb des Berichterstattungsumfangs“ unterscheiden. Bei den beiden lokalen Quellen variiert dies je nach Medium, siehe Bronplatform;
• limits pro Quelle: Wie viele Ergebnisse liefert ein Aufruf und wie schnell ist diese Installation bereit, Abfragen durchzuführen? Diese Werte stammen aus den Einstellungen und wurden nicht manuell eingegeben, sodass eine geänderte Einstellung die Antwort nicht verfälscht;
• attribution pro Quelle: Welche Plattform wird als Quelle angegeben und mit welcher Kennzeichnung soll ein Fund zitiert werden? Siehe Bronvermelding;
• availability pro Quelle: ob die letzten Live-Aufrufe an diese Plattform erfolgreich waren. Dies wurde anhand des Datenverkehrs festgestellt und nicht durch einen zusätzlichen Aufruf gemessen; eine Antwort aus dem Cache zählt nicht mit. Eine Quelle, die ausfällt, liefert eine leere Antwort, die genauso aussieht wie „nichts gefunden“. Diese Unterscheidung wird hier getroffen.

„Ausschalten“ bedeutet „abwesend“

Ein deaktivierter Connector ist für alle nicht mehr verfügbar. Die Adresse existiert nicht mehr, die Anmeldeseite verschwindet, der Verweis in der Fußzeile verschwindet und /health listet den Connector nicht mehr auf. Es gibt keinen Fall, in dem eine Seite eine Adresse anzeigt, die nicht mehr erreichbar ist. Die Funktionsweise ist unter Connectorregister beschrieben.

„Ausblenden“ ist etwas anderes als „deaktivieren“

Neben dem Schalter, der einen Link aktiviert oder deaktiviert, gibt es einen zweiten Schalter, der lediglich festlegt, ob die Adresse in der Fußzeile der Website genannt wird. Diese beiden beantworten unterschiedliche Fragen. Der erste gibt an, ob die Adresse existiert, der zweite, ob die Adresse beworben wird.

Ab Version 1.3.54 enthält die Fußzeile nur noch eine Adresse: die von Alle Bronnen. Die sieben Quellenkonnektoren funktionieren weiterhin wie gewohnt. Wer bereits eine dieser Adressen eingerichtet hat, wird davon nichts bemerken. Bis einschließlich Version 1.3.53 waren alle acht Adressen in der Fußzeile aufgeführt.

Der Grund liegt in der Auswahl selbst. Acht Adressen hintereinander erfordern von einem Besucher eine Entscheidung, die noch nicht getroffen werden kann, während eine einzige Adresse alle Quellen enthält. Die Adressen der einzelnen Quellen finden sich unter Connectoren sowie auf der jeweiligen Seite der Quelle; sie sind also nicht verschwunden, sondern dort zu finden, wo über sie berichtet wird.

Das Ausblenden betrifft nur die Fußzeile. Die Anschlussseite, die Auswahlderseite, der Explorer sowie llms.txt und sitemap.xml verweisen wie gewohnt auf jeden aktivierten Connector. Eine Adresse, die zwar funktioniert, aber nirgendwo zu finden ist, wäre schlimmer als eine Adresse, die nicht an erster Stelle steht.