Best Practices für WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Veröffentlicht am 18. Mai 2026

WebMCP-Tooldeklaration sollte klar sein, ohne dass Entwickler oder Agenten Ausgaben prüfen und es noch einmal versuchen müssen. Unabhängig davon, ob Sie die imperative oder die deklarative API verwenden, sollten Sie diese Best Practices beachten:

  • Erstellen Sie vor der Entwicklung eine Toolstrategie.
  • Verwenden Sie eine klare Sprache und semantisches HTML.
  • Entwerfen Sie Ihre Schemas und verarbeiten Sie Eingaben.
  • Entwickeln Sie zuverlässige Tools.
  • Testen Sie und beheben Sie Fehler.

Toolstrategie erstellen

Wie bei jeder Softwareanwendung sollten Sie zuerst Ihre Toolstrategie planen:

  • Jedes Tool sollte aus einer einzelnen Funktion bestehen. Ein Tool könnte beispielsweise den Nutzer zu einem bestimmten Formular weiterleiten, während ein anderes Tool Eingabefelder mit Nutzerinformationen abgleichen sollte. Achten Sie darauf, keine sich überschneidenden Tools zu erstellen, da der Agent sonst möglicherweise nicht weiß, welches Tool er verwenden soll. Fragen Sie sich: Kann ich mehrere Aufgaben mit derselben Funktion abdecken?
  • Toolregistrierung verwalten Registrieren Sie Tools, wenn sie in einem bestimmten Seitenstatus nützlich sind, und heben Sie die Registrierung auf, wenn das Tool nicht mehr verwendet werden kann.
    • Imperative API: Sie können die Registrierung dynamisch mit registerTool und unregisterTool verwalten.
    • Deklarative API: Sie können die Registrierung dynamisch verwalten, indem Sie die Toolattribute in einem Formular hinzufügen oder entfernen, mit toolName und toolDescription.
  • Komplexität reduzieren:Für die meisten Anwendungen sollte die statische Registrierung der Standardansatz sein.
  • Vertrauen Sie darauf, dass der Agent die Aufgabe erledigt*. Anstatt starre oder negative Anweisungen zu schreiben, sollten Sie davon ausgehen, dass der Agent versteht, was zum Erledigen der Aufgabe erforderlich ist. Er muss nicht einen genauen Ablauf von Schritten verwalten.

Es gibt keine maximale Anzahl zulässiger Tools. Jedes Tool nimmt jedoch einen Teil des Kontextfensters ein und verlängert die Zeit bis zum Abschluss. Je mehr Tools Sie bereitstellen und je mehr sich die Tools überschneiden, desto schwieriger ist es für den Agenten, die richtige Auswahl zu treffen. Experimentieren Sie, um herauszufinden, was für Ihre Anwendung am besten geeignet ist.

So können Sie einzelne Tools ohne sich überschneidende Zwecke erstellen und verwalten, wann diese Tools verfügbar sind.

Klare Sprache und semantischen Code verwenden

Verwenden Sie eine klare und direkte Sprache, um Tools zu benennen und ihre Verwendung zu beschreiben. So können Agenten das finden, was sie brauchen, verstehen, was sie finden, und diese Informationen so verwenden, wie es der Entwickler erwartet.

Achten Sie beim Schreiben von Toolnamen darauf, zwischen Ausführung und Initiierung zu unterscheiden, und verwenden Sie Verben, die genau beschreiben, was passiert. create-event ist beispielsweise ein Tool zum sofortigen Erstellen von Ereignissen, während start-event-creation-process ein Tool ist, das den Nutzer zu einem Formular weiterleitet, um das Ereignis zu erstellen.

Eine klare Beschreibung sollte beschreiben, was das Tool tut und wann es verwendet werden sollte. Verwenden Sie eine positive Sprache und Präferenzen anstelle einer negativen Sprache, z. B. Einschränkungen.

Was Sie nicht tun sollten

„Verwenden Sie dieses Tool nicht für das Wetter.“

Einschränkungen sollten in einer gut formulierten Beschreibung impliziert sein.
Das sollten Sie tun:

„Mit diesem Tool kann ein Kalendertermin erstellt werden, der für ein bestimmtes Datum und eine bestimmte Uhrzeit geplant ist.“

Kognitive Anforderungen minimieren

So wie Sie die kognitiven Anforderungen für Menschen, die komplexe Aufgaben erledigen, minimieren sollten, sollten Sie auch die kognitiven Anforderungen für das Modell minimieren:

  • Rohe Nutzereingaben akzeptieren. Bitten Sie den Agenten nicht, Berechnungen durchzuführen oder die Eingabestrings zu transformieren. Wenn ein Nutzer beispielsweise „11:00 bis 15:00“ sagt, sollte das Tool dies als String akzeptieren. Bitten Sie das Modell nicht, die Minuten zwischen diesen Zeiten zu berechnen.
  • Bestimmte Typen für Parameter deklarieren, z. B. String, Zahl oder Enum.
  • Erklären Sie, warum Sie bestimmte Entscheidungen getroffen haben. Die von Ihnen getroffene Entscheidung sollte selbsterklärend sein. Die Begründung hilft Agenten, bessere Entscheidungen zu treffen. Wenn Sie beispielsweise einen Onlineshop betreiben, deklarieren Sie den Versandtyp mit natürlicher Sprache, anstatt eine mehrdeutige ID zu verwenden: shipping="Express" anstelle von shipping_id=1.

Zuverlässigkeit priorisieren

Agenten und Menschen profitieren von Tools, die sich wie erwartet verhalten:

  • Legen Sie ein ordnungsgemäßes Verhalten bei Ratenbegrenzungen fest. Tools sollten angemessene Wiederholungen ermöglichen, z. B. für den Preisvergleich. Wenn ein Tool ratenbegrenzt ist, geben Sie einen aussagekräftigen Fehler zurück oder weisen Sie den Nutzer an, die Aufgabe manuell zu übernehmen.
  • Aktualisieren Sie den Status der Benutzeroberfläche, nachdem Funktionen abgeschlossen wurden. Agenten verlassen sich möglicherweise auf die Benutzeroberfläche, um die nächsten Schritte zu planen. Die Ausführung von Funktionen kann jedoch länger dauern als das Laden der Benutzeroberfläche. Der Agent sollte bestätigen, dass die Funktion abgeschlossen ist, sobald die Benutzeroberfläche aktualisiert wurde, oder eine erneute Aktualisierung anfordern.
  • Strenge Validierung im Code, weniger strenge Validierung im Schema. Einschränkungen und Tests sollten für Funktionen und Code mit binärer Logik verwendet werden. Schemaeinschränkungen können zwar hilfreich sein, sind aber nicht garantiert. Fügen Sie Ihrem Funktionscode aussagekräftige Fehler hinzu, damit das Modell sich selbst korrigieren und es mit neuen, gültigen Parametern noch einmal versuchen kann.

Bewertungstests und Fehlerbehebung

Erstellen Sie Bewertungstests und stellen Sie Ihre Tools für die Fehlerbehebung zur Verfügung. Im Gegensatz zu deterministischen Unittests können Bewertungen nicht fest codiert werden, da die Ausgaben unerwartete Formen annehmen können.

  • Definieren Sie das Problem. Sie können Ihr Problem wie einen API-Vertrag formulieren, einschließlich des Eingabetyps, des Ausgabeformats und aller zusätzlichen Einschränkungen.
  • Definieren Sie eine Baseline und ein ideales Ergebnis. Insbesondere bei der Texteingabe ist es wichtig zu verstehen, mit welchen Arten von Ergebnissen Sie die gewünschte Ausgabe erhalten können.
  • Bestimmen Sie, wie die Ausgabe bewertet wird. Sie identifizieren und messen wahrscheinlich subjektive, qualitative Ergebnisse basierend auf der Eingabequalität, der Nützlichkeit und der Fähigkeit, die nächste Aufgabe zu erledigen. Es gibt eine Reihe von Techniken, mit denen Sie die Ausgabe bewerten können, darunter codebasierte Prüfungen für regelbasierte Ausgaben (Zeichenlimits) und LLM-as-a-judge.

Fügen Sie keine engen Regeln hinzu, um Probleme mit einem bestimmten Modell zu beheben. Wenn Sie beispielsweise ein Auswahlfeld für Anreden einfügen, kann das Modell die falsche Wahl treffen. Anstatt enge Regeln hinzuzufügen, um dieses Problem zu beheben, sollten Sie Ihr Tool abstrahieren und anpassen. Am besten legen Sie dieses Feld als optional fest. Bitten Sie den Agenten dann, den Nutzer zu fragen, welche Wahl sinnvoll ist, damit der Nutzer mit dem Ergebnis zufrieden ist.

Feedback geben und einholen

WebMCP wird aktiv diskutiert und kann sich in Zukunft ändern. Wenn Sie diese APIs ausprobieren und Feedback haben, freuen wir uns darauf.