Connector

Een connector is in BesluitBron één MCP-adres met één gereedschapskist, één schakelaar in de instellingen en één aansluitpagina. Het is de eenheid waarin een gebruiker aansluit en waarin een beheerder aan- en uitzet.

Een connector is niet hetzelfde als een Bronplatform. Elke connector op één na staat voor precies één bronplatform. Die ene, Alle Bronnen, leest zelf niets: hij biedt de gereedschappen van alle andere op één adres aan, elk met de naam van de bron ervoor. Er is dus altijd één connector meer dan er bronnen zijn.

Waarom elke bron een eigen adres heeft

Een AI-assistent kiest een gereedschap op grond van de beschrijving ervan. Hoe meer gereedschappen er tegelijk in beeld zijn, hoe vaker die keuze verkeerd uitvalt. Er gaat dan ook meer aandacht van het model naar het kiezen in plaats van naar de vraag. Zeven gereedschapskisten tegelijk zijn ruim zestig beschrijvingen die om aandacht concurreren.

De praktische regel die daaruit volgt: sluit de bron aan die bij de vraag hoort. Wie het gemeentelijke besluit zoekt, heeft aan Open Raadsinformatie genoeg. Wie een vraag stelt over meerdere bestuurslagen tegelijk, sluit Alle Bronnen aan en accepteert de grotere keuzeruimte.

Wat elke connector gemeen heeft

Elke connector biedt twee gereedschappen die niet over de inhoud gaan, ongeacht de bron erachter:

• list_capabilities: welke gereedschappen dit adres heeft, welke vraag elk gereedschap beantwoordt en welke bron eronder ligt. Een assistent roept dit gereedschap aan als niet duidelijk is welke bron de vraag kan beantwoorden. Het antwoord noemt ook welke versie van BesluitBron heeft geantwoord (server en server_version). Dat nummer hoort in een storingsmelding, want zonder dat nummer is niet na te gaan welke bouw een antwoord heeft gemaakt;
• list_platform_calls: welke aanroepen naar het bronplatform in deze sessie zijn gedaan, met hun duur en hun omvang. Daarmee is achteraf na te gaan waarop een antwoord is gebaseerd, zie Logging en Verantwoording;
• platform_status: of de bron nog nieuw materiaal binnenkrijgt, uit dezelfde meting als Laadstatus, beschikbaar vanaf versie 1.3.36. Een assistent hoort dit aan te roepen voordat zij concludeert dat iets niet bestaat: een leeg zoekresultaat uit een stilstaande bron is geen bewijs dat er niets is. Het antwoord geeft per bron de toestand, en bij de twee lokale bronnen ook hoeveel organen stilstaan en tot wanneer hun materiaal loopt.

Daarnaast geldt een verplichting voor elk gereedschap dat een resultatenlijst teruggeeft: het moet melden hoe precies dat resultaat is. Die regel staat in Zoekprecisie en wordt door een test afgedwongen. Een zoekgereedschap dat de velden weglaat, komt de bouw niet door.

Wat een gereedschap over zichzelf vertelt

Elk gereedschap draagt drie dingen die vóór de aanroep al bekend zijn:

• een naam, waarmee het model kiest, bijvoorbeeld search_documents;
• een titel in gewone taal, die een gebruiker leest, bijvoorbeeld "Zoek raadsstukken". Op Alle Bronnen staat de bron ervoor, want meerdere connectoren hebben een gereedschap "Aanstaande vergaderingen";
• de melding dat het gereedschap alleen leest. BesluitBron verandert niets bij een bronplatform, dus elk gereedschap draagt die melding.

Die laatste melding scheelt werk. Veel clients laten een gereedschap dat alleen leest draaien zonder per aanroep om bevestiging te vragen. Tot versie 1.3.35 droegen de dertien gereedschappen van Open Raadsinformatie de melding niet, waardoor een gebruiker daar elke aanroep apart moest bevestigen. Vanaf versie 1.3.36 dragen alle gereedschappen van alle connectoren zowel een titel als die melding.

Wat list_capabilities over de installatie zegt

Naast de beschrijving van elke bron draagt het antwoord zes gegevens die over deze installatie gaan in plaats van over het materiaal:

• server en server_version: welke software antwoordde en welke bouw. Dit is het nummer dat in een storingsmelding thuishoort;
• server_time_utc: de klok van de server zelf. Elk datumfilter en elk gereedschap over aanstaande vergaderingen rekent vanaf vandaag. Een assistent die zich in de datum vergist, bouwt een verkeerd bereik zonder dat er iets misgaat;
• current_through per bron: tot wanneer de dekking loopt. Zonder dat gegeven is "niet gevonden" niet te onderscheiden van "buiten de dekking". Bij de twee lokale bronnen verschilt dat per orgaan, zie Bronplatform;
• limits per bron: hoeveel één aanroep teruggeeft, en hoe snel deze installatie bereid is te vragen. Deze waarden komen uit de instellingen en zijn niet overgetypt, zodat een gewijzigde instelling het antwoord niet laat liegen;
• attribution per bron: welk platform wordt gecrediteerd, en met welk kenmerk een vondst hoort te worden geciteerd. Zie Bronvermelding;
• availability per bron: of recente live aanroepen naar dat platform slaagden. Dit is waargenomen uit het verkeer en niet gemeten met een extra aanroep; een antwoord uit de cache telt niet mee. Een bron die faalt, levert een leeg antwoord dat er hetzelfde uitziet als "niets gevonden". Dat onderscheid staat hier.

Uitzetten betekent afwezig

Een connector die is uitgezet, is voor iedereen weg. Het adres bestaat niet meer, de aansluitpagina verdwijnt, de verwijzing in de voettekst verdwijnt en /health noemt de connector niet meer. Er is geen toestand waarin een pagina een adres aanprijst dat niet meer luistert. De werking daarvan staat in Connectorregister.

Verbergen is iets anders dan uitzetten

Naast de schakelaar die een connector aan- en uitzet, is er een tweede schakelaar die alleen bepaalt of het adres in de voettekst van de site wordt genoemd. Die twee beantwoorden verschillende vragen. De eerste zegt of het adres bestaat, de tweede of het adres wordt aangeprezen.

Vanaf versie 1.3.54 noemt de voettekst nog één adres: dat van Alle Bronnen. De zeven bronconnectoren blijven gewoon werken. Wie een van die adressen al heeft ingesteld, merkt niets. Tot en met versie 1.3.53 stonden alle acht adressen in de voettekst.

De reden is de keuze zelf. Acht adressen op een rij vragen van een bezoeker een beslissing die nog niet te nemen is, en één adres draagt alle bronnen. De adressen per bron staan in Connectoren en op de pagina van elke bron, dus zij zijn niet weg maar staan waar erover wordt verteld.

Verbergen raakt alleen de voettekst. De aansluitpagina, de keuzepagina, de verkenner, llms.txt en sitemap.xml noemen elke aangezette connector gewoon. Een adres dat wel werkt maar nergens te vinden is, zou erger zijn dan een adres dat niet vooraan staat.