Wie wählt ein KI-Assistent das richtige Tool aus?

Sie tippen: "Welche Rechnungen von Jansen B.V. sind noch offen?" Der Assistent sucht zuerst die Relation und ruft danach die offenen Posten ab. Zwei Tool-Aufrufe in der richtigen Reihenfolge, ohne dass Sie einen Toolnamen genannt haben. Wer hat diese Wahl getroffen? Nicht Ledger Botje, sondern das Sprachmodell. Aber das Modell wählt aus dem, was der Server ihm zeigt, und auf Grundlage dessen, was der Server darüber sagt. In diesem Beitrag lesen Sie, wie das funktioniert.

Schritt 1: Der Server veröffentlicht eine Liste von Tools

Beim Verbinden fragt der KI-Client über das Model Context Protocol, welche Tools es gibt. Der MCP-Server von Ledger Botje antwortet mit einer Liste, und jedes Tool darin hat vier Bestandteile:

Der KI-Client gibt diese Liste zusammen mit Ihrer Frage an das Sprachmodell weiter. Das Modell sieht also keinen Code und keine Datenbank, nur diese Beschreibungen.

Schritt 2: Was vorab aus der Liste fällt

Bevor das Modell etwas auswählt, hat der Server bereits festgelegt, was in der Liste steht. Was dort nicht steht, kann das Modell nicht aufrufen. Genau dort regeln Sie bewusst die Rechte, nicht im Prompt:

• Schreibmodus. Ist das Schreiben in den Einstellungen ausgeschaltet, fehlen alle Tools, die etwas in Exact Online ändern.
• Toolauswahl pro Verbindung. Pro KI-Client können Sie eine eigene Auswahl an Tools festlegen, mit einem Standard pro Administration für Clients, die sich später verbinden.
• Freigabe pro Unternehmen und pro Kollege. Der Administrator legt fest, welche Tools das Unternehmen nutzt, und kann einen Kollegen weiter einschränken oder auf Nur-Lesen setzen. Eine Ebene kann nur entfernen, nie hinzufügen.
• Administrator-Tools. Tools in der Testphase sind nur für Administratoren sichtbar.

Die Tools, die mit admin_ beginnen, etwa admin_switch zum Wechseln der Administration, bleiben immer verfügbar. Copilot Studio nutzt pro Agent höchstens 70 Tools; dort ist eine Toolauswahl also kein Luxus, sondern eine Notwendigkeit.

Schritt 3: Das Modell wählt nach Name und Beschreibung

Jetzt legt das Modell Ihre Frage neben die Liste. Dabei helfen ihm drei Dinge.

Feste Namensgebung. Jeder Toolname folgt dem Muster Bereich, Gegenstand, Aktion: sales_orders_create, financial_reporting_balance_search, accounts_search. Eine Frage zum "Anlegen eines Auftrags" landet so von selbst bei den Tools, die mit sales_orders beginnen und auf create enden.

Beschreibungen, die sagen, wann ja und wann nein. Eine gute Beschreibung sagt nicht nur, was ein Tool tut, sondern auch, wann ein anderes Tool besser passt. So sagt financial_reporting_balance_search, dass die Suche nach dem Wort "Umsatz" Konten übersieht und sich daher nicht zum Aufsummieren von Umsatz eignet, dass Umsatz als Haben negativ steht und dass man für ein Dashboard besser groupBy nutzt als Seite für Seite einzelne Zeilen. Solche Sätze lenken das Modell weg von einem Tool, das auf den ersten Blick passt, aber eine falsche Antwort liefert.

Reihenfolge in der Beschreibung. Viele Aufgaben brauchen mehrere Schritte. Eine Buchung braucht eine Relation, und ein Anhang muss hochgeladen werden, bevor Sie ihn verknüpfen. Die Beschreibung nennt diese Reihenfolge, und das Modell macht daraus eine Folge von Aufrufen. Bei der Frage zu Jansen B.V. ist das zuerst accounts_search und dann cashflow_receivables_search.

Jedes Tool hat außerdem einen Parameter context, in dem das Modell kurz sagt, warum es das Tool aufruft. Das landet im Protokoll des Aufrufs, und so sehen wir bei einer Meldung nicht nur, welches Tool gewählt wurde, sondern auch warum.

Schritt 4: Bei einer Schreibaktion folgt eine Bestätigung

Die Annotationen aus Schritt 1 sagen, ob ein Tool nur liest (readOnlyHint) und ob es etwas Unumkehrbares tut (destructiveHint). KI-Clients nutzen das, um bei Schreibaktionen um Erlaubnis zu bitten; wie das aussieht, unterscheidet sich je Client. Bei Tools mit großen Folgen geht die Beschreibung einen Schritt weiter. financial_entries_match (Posten ausgleichen) bittet das Modell, zuerst die Posten, Beträge und den Saldo zu zeigen und erst nach Ihrer Zustimmung aufzurufen, weil sich ein Ausgleich nur in Exact Online selbst rückgängig machen lässt.

Schritt 5: Die Antwort bestimmt den nächsten Schritt

Nach einem Aufruf liest das Modell das Ergebnis und entscheidet erneut: fertig oder noch ein Tool? Auch hier steuert der Server mit:

• Leeres Ergebnis. Hat die breiteste Suche nichts ergeben, sagt das Tool STOP, damit das Modell nicht endlos Varianten ausprobiert. Bei einem zu strengen Filter sagt es, welchen Filter Sie lockern können.
• Ende der Liste. Eine leere Seite nach der ersten liefert pastEnd: true: Weiterblättern hat keinen Sinn.
• Aktualität. Berichts-Tools melden, wie alt ihre Zahlen sind, und eine unvollständige Aktualisierung steht als cacheRefresh in der Antwort.
• Verbindung. Funktioniert die Verbindung zu Exact Online nicht, steht in der Antwort, was der Benutzer tun muss und dass das Modell den Aufruf nicht wiederholen soll.

Ein Fehler ist also keine Sackgasse, sondern eine Anweisung. Das spart Aufrufe und verhindert, dass ein Assistent einen Auftrag zweimal anlegt, weil er dachte, der erste sei fehlgeschlagen.

So bekommen Sie schneller das richtige Tool

• Nennen Sie Objekt und Aktion. "Lege einen Kundenauftrag an für…" funktioniert besser als "trag das mal in Exact ein".
• Nennen Sie die Administration, wenn Sie mehrere haben. Der Assistent wechselt dann zuerst mit admin_switch.
• Sagen Sie, was nicht erlaubt ist. "Nur nachschlagen, nichts ändern" ist eine klare Grenze für das Modell. Wenn Sie sicher sein wollen, schalten Sie das Schreiben aus.
• Beschränken Sie die Toolauswahl auf das, was Sie nutzen. Weniger Auswahl bedeutet weniger Risiko einer falschen Wahl, und in Copilot Studio ist es notwendig.
• Beginnen Sie mit einem Prompt aus der Prompt-Bibliothek. Diese sind auf die richtigen Tools und die richtige Reihenfolge getestet.
• Melden Sie es, wenn etwas schiefgeht. Bitten Sie den Assistenten, admin_feedback zu nutzen. Mit diesen Meldungen und dem context aus dem Protokoll verbessern wir die Beschreibungen.

Wer entscheidet was

Alle Tools mit ihrer Beschreibung finden Sie im Tool-Katalog. Hängt eine Verbindung, lesen Sie Probleme mit der MCP-Anbindung lösen.