Inference & Engineering

Tool Contract (Vertrag für Agenten-Tools)

Ein Tool Contract ist die explizite Vereinbarung zwischen einem KI-Agenten und einem Tool, das er aufrufen darf. Er beschreibt nicht nur den Namen einer Funktion, sondern den vollständigen Rahmen: Eingabefelder, Datentypen, erlaubte Werte, Berechtigungen, Seiteneffekte, Fehlerfälle, Zeitlimits, Rückgabeformat und die Situationen, in denen der Agent das Tool überhaupt nutzen soll. Ohne diesen Contract muss das Modell aus einer losen Beschreibung erraten, was ein Tool tut. Das führt schnell zu falschen Parametern, unnötigen Aufrufen oder riskanten Aktionen. Ein guter Tool Contract macht die Grenze zwischen Denken und Handeln überprüfbar. Er legt fest, welche Daten der Agent übergeben darf, ob ein Aufruf nur liest oder schreibt, wie sensible Informationen maskiert werden und wann ein Mensch zustimmen muss. In produktiven Agentensystemen ist der Tool Contract deshalb ein Sicherheits- und Qualitätsbaustein, nicht nur Dokumentation. Er verbindet Prompt, API-Schema, Zugriffskontrolle und Tests zu einer klaren Schnittstelle, die sowohl das Modell als auch Entwickler verstehen können.

Im Detail: Tool Contract (Vertrag für Agenten-Tools)

Ein Tool Contract ist die explizite Vereinbarung zwischen einem KI-Agenten und einem Tool, das er aufrufen darf. Er beschreibt nicht nur den Namen einer Funktion, sondern den vollständigen Rahmen: Eingabefelder, Datentypen, erlaubte Werte, Berechtigungen, Seiteneffekte, Fehlerfälle, Zeitlimits, Rückgabeformat und die Situationen, in denen der Agent das Tool überhaupt nutzen soll. Ohne diesen Contract muss das Modell aus einer losen Beschreibung erraten, was ein Tool tut. Das führt schnell zu falschen Parametern, unnötigen Aufrufen oder riskanten Aktionen. Ein guter Tool Contract macht die Grenze zwischen Denken und Handeln überprüfbar. Er legt fest, welche Daten der Agent übergeben darf, ob ein Aufruf nur liest oder schreibt, wie sensible Informationen maskiert werden und wann ein Mensch zustimmen muss. In produktiven Agentensystemen ist der Tool Contract deshalb ein Sicherheits- und Qualitätsbaustein, nicht nur Dokumentation. Er verbindet Prompt, API-Schema, Zugriffskontrolle und Tests zu einer klaren Schnittstelle, die sowohl das Modell als auch Entwickler verstehen können.

Implementierungsdetails

  • Tech-Stack
  • Produktionsreife Leitplanken