Ablauf eines Anrufs

Eine Anfrage eines Benutzers führt zu einem oder mehreren Aufrufen von Tools. Auf dieser Seite wird beschrieben, was bei einem solchen Aufruf geschieht – vom Eingang an der MCP-Adresse bis zur Antwort an den Assistenten.

Die Schritte

flowchart TD
    A["KI-Assistent<br/>tools/call search_documents"] --> E["MCP-Adresse<br/>welche Adresse,<br/>Welcher Werkzeugkasten"]
    E --> S["McpConnectorSurface<br/>Führe dieses Tool aus"]
    S --> X["ToolExecutor<br/>Zeitmessung starten,<br/>Herkunft vermerken"]
    X --> Q["Suchdienst<br/>die Eingabe löschen,<br/>Überprüfen Sie den Quellnamen,<br/>Begrenze den Umfang"]
    Q --> C{"Steht die Antwort<br/>schon im Puffer?"}
    C -->|ja| HIT["UpstreamCache<br/>bekannte Antwort"]
    C -->|nein| P["Quellenplattform<br/>Suchanfrage in der Sprache<br/>der Plattform"]
    P --> W["UpstreamCache<br/>Halte die Antwort fest"]
    HIT --> PREC["Suchdienst<br/>Lege die Suchgenauigkeit fest"]
    W --> PREC
    PREC --> L["Anfrageprotokoll<br/>Werkzeuge, teuer, Treffer,<br/>Umfang, Herkunft"]
    L --> R["KI-Assistent<br/>Ergebnis als JSON"]

Was in jedem Schritt erzwungen wird

• Die Eingabe wird bereinigt, bevor sie die Plattform erreicht. Platzhalterzeichen und Suchkonstrukte, die die Quelle ausführen würde, werden entfernt. Ein angegebener Quellenname wird mit der Liste der vorhandenen Quellen abgeglichen. Eine unbekannte Quelle führt zu einem Fehler und nicht zu einem leeren Ergebnis, da ein leeres Ergebnis als „es gibt nichts“ interpretiert würde;
• Der Umfang wird begrenzt. Ein Tool liefert niemals eine unbegrenzte Anzahl von Treffern, da die Antwort sonst den Speicher des Assistenten füllen würde, ohne die Frage besser zu beantworten. Was außerhalb des Fensters liegt, steht im Feld „more_to_find“ aus „Zoekprecisie“;
• Die Präzision wird durch eine gemeinsame Vorrichtung bestimmt und nicht für jedes Werkzeug neu entwickelt;
• Der Aufruf wird protokolliert, bevor die Antwort gesendet wird. Auch ein Aufruf, der mit einem Fehler endet, wird somit im Protokoll erfasst.
• Die Sitzung bleibt bei dem Connector, auf dem sie eröffnet wurde. Ein Client, der eine Sitzung auf einem Connector eröffnet und anschließend einen anderen anspricht, erhält eine Ablehnung, in der angegeben wird, zu welchem Connector die Sitzung gehört. Ohne diese Regel würde der Client die Ressourcen des ersten Connectors unter der Adresse des zweiten erhalten. Der Dienst speichert diese Zuordnung 30 Minuten nach der letzten Anfrage der Sitzung; danach ist die Sitzung auch für den Transport selbst unbekannt. Die Frist ist unter BesluitBron:Mcp:SessionBindingRetentionMinutes aufgeführt. Ab Version 1.3.7.

Was der Assistent zurückbekommt

Eine kompakte JSON-Antwort mit den Treffern, deren Merkmalen in der Quelle und den Präzisionsfeldern. Falls das Tool eine Fortsetzung bietet, wird dort ein Verweis darauf angezeigt: das nächste Fenster, der vollständige Text eines Dokuments oder das zugehörige Sitzungsdokument.

Der Assistent wandelt diese Antwort in Fließtext um. Dieser Text entspricht nicht der Antwort aus dem Register. Aufgrund dieses Unterschieds ist jedes Ergebnis mit einem Kennzeichen versehen. Siehe Bronvermelding.