Connecteur

Dans BesluitBron, un connecteur correspond à une adresse MCP avec une boîte à outils, un commutateur dans les paramètres et une page de connexion. C'est l'unité via laquelle un utilisateur se connecte et que l'administrateur active ou désactive.

Un connecteur n'est pas la même chose qu'un Bronplatform. Tous les connecteurs, sauf un, correspondent à une seule et même plateforme source. Le seul qui fait exception, Alle Bronnen, ne lit rien lui-même : il propose les outils de toutes les autres plateformes à une seule adresse, chacun précédé du nom de la source. Il y a donc toujours un connecteur de plus que le nombre de sources.

Pourquoi chaque source a sa propre adresse

Un assistant IA choisit un outil en fonction de sa description. Plus il y a d'outils à l'écran en même temps, plus le choix s'avère souvent erroné. Le modèle concentre alors davantage son attention sur le choix plutôt que sur la question posée. Sept boîtes à outils à la fois, cela représente plus de soixante descriptions qui se disputent son attention.

La règle pratique qui en découle est la suivante : connectez-vous à la source correspondant à votre requête. Si vous recherchez une décision municipale, le site Open Raadsinformatie suffit. Si votre question concerne plusieurs niveaux administratifs à la fois, connectez-vous à Alle Bronnen et acceptez le choix plus large qui s'offre à vous.

Ce que tous les connecteurs ont en commun

Chaque connecteur propose deux outils qui ne portent pas sur le contenu, quelle que soit la source sous-jacente :

• list_capabilities : quels outils cette adresse contient, à quelle question chaque outil répond et quelle source se cache derrière. Un assistant fait appel à cet outil lorsqu'il n'est pas clair quelle source peut répondre à la question. La réponse indique également quelle version de BesluitBron a fourni la réponse (server et server_version). Ce numéro doit figurer dans un rapport d'incident, car sans lui, il est impossible de déterminer quelle version a généré la réponse ;
• list_platform_calls : quelles requêtes ont été envoyées à la plateforme source au cours de cette session, avec leur durée et leur volume. Cela permet de vérifier a posteriori sur quoi repose une réponse, voir Logging en Verantwoording ;
• platform_status : indique si la source reçoit encore de nouvelles données, issues de la même mesure que Laadstatus, disponible à partir de la version 1.3.36. Une assistante devrait consulter cette commande avant de conclure qu’une information n’existe pas : un résultat de recherche vide provenant d’une source en pause ne prouve pas qu’il n’y a rien. La réponse indique l’état de chaque source et, pour les deux sources locales, le nombre d’organes en pause ainsi que la date d’expiration de leur contenu.

De plus, tout outil qui renvoie une liste de résultats est tenu d'indiquer le degré de précision de ce résultat. Cette règle est définie dans Zoekprecisie et son respect est vérifié par un test. Un outil de recherche qui omet ces champs ne sera pas validé lors de sa création.

Ce qu'un outil révèle sur lui-même

Chaque outil comporte trois éléments qui sont déjà connus avant l'appel :

• un nom, que le modèle choisit, par exemple search_documents ;
• un titre rédigé en langage courant, destiné à l'utilisateur, par exemple « Rechercher les documents du conseil ». Sur Alle Bronnen, on trouve la source correspondante, car plusieurs connecteurs disposent d'un outil intitulé « Prochaines réunions » ;
• le message indiquant que l'outil est en mode lecture seule. BesluitBron n'a aucune incidence sur une plateforme source ; par conséquent, chaque outil affiche ce message.

Ce dernier message permet de gagner du temps. De nombreux clients exécutent un outil en lecture seule sans demander de confirmation à chaque appel. Jusqu'à la version 1.3.35, les treize outils de Open Raadsinformatie ne comportaient pas ce message, ce qui obligeait l'utilisateur à confirmer chaque appel séparément. À partir de la version 1.3.36, tous les outils de tous les connecteurs comportent à la fois un titre et ce message.

Ce qu'list_capabilities dit à propos de l'installation

Outre la description de chaque source, la réponse contient six informations qui concernent cette installation plutôt que le matériel :

• server et server_version : quel logiciel a répondu et quel bâtiment. C'est le numéro qui doit figurer dans un rapport d'incident ;
• server_time_utc : l'horloge du serveur lui-même. Chaque filtre de date et chaque outil concernant les réunions à venir calcule à partir d'aujourd'hui. Un assistant qui se trompe de date définit une plage erronée sans que cela n'entraîne de problème ;
• current_through selon la source : jusqu'à quand la couverture est valable. Sans cette information, « introuvable » ne peut être distingué de « hors couverture ». Pour les deux sources locales, cela varie selon l'organisme, voir Bronplatform ;
• limits par source : la quantité de données renvoyée par une requête, et la vitesse à laquelle cette installation est prête à traiter les requêtes. Ces valeurs proviennent des paramètres et n'ont pas été saisies manuellement, de sorte qu'un paramètre modifié n'altère pas la réponse ;
• attribution par source : quelle plateforme doit être mentionnée, et selon quelles indications une découverte doit être citée. Voir Bronvermelding ;
• availability par source : si les requêtes en direct récentes vers cette plateforme ont abouti. Cela a été observé à partir du trafic et n'a pas été mesuré par une requête supplémentaire ; une réponse provenant du cache n'est pas prise en compte. Une source qui échoue renvoie une réponse vide qui ressemble à « rien trouvé ». Cette distinction est indiquée ici.

« Éteindre » signifie « absent »

Un connecteur désactivé disparaît pour tout le monde. L'adresse n'existe plus, la page de connexion disparaît, le lien dans le pied de page disparaît et /health ne mentionne plus ce connecteur. Il n'y a aucun cas où une page renvoie vers une adresse qui n'est plus valide. Son fonctionnement est décrit à l'adresse Connectorregister.

Masquer, ce n'est pas la même chose que désactiver

Outre le bouton qui active ou désactive un lien, il existe un deuxième bouton qui détermine uniquement si l'adresse apparaît dans le pied de page du site. Ces deux boutons répondent à des questions différentes. Le premier indique si l'adresse existe, le second si elle est mise en avant.

À partir de la version 1.3.54, le pied de page ne mentionne plus qu'une seule adresse : celle de Alle Bronnen. Les sept connecteurs de source continuent de fonctionner normalement. Les utilisateurs ayant déjà configuré l'une de ces adresses ne remarqueront aucun changement. Jusqu'à la version 1.3.53 incluse, les huit adresses figuraient dans le pied de page.

La raison tient au choix lui-même. Huit adresses à la suite obligent le visiteur à prendre une décision qu’il n’est pas encore en mesure de prendre, alors qu’une seule adresse regroupe toutes les sources. Les adresses correspondant à chaque source figurent sur Connectoren et sur la page de chaque source ; elles n’ont donc pas disparu, mais se trouvent là où elles sont mentionnées.

Le masquage ne concerne que le pied de page. La page de connexion, la page de sélection, l'explorateur, llms.txt et sitemap.xml mentionnent normalement chaque connecteur activé. Une adresse qui fonctionne mais qui est introuvable serait pire qu'une adresse qui n'apparaît pas en tête de liste.