Ein eigenes Tool schreiben

Ein eigenes Tool ist eine Funktion, die du schreibst. Der Agent darf sie aufrufen, wenn die Beschreibung zur Aufgabe passt.

Das Tool hinzufügen

  1. Öffne den Agent.
  2. Wähle Add custom tool.
  3. Setze Tool name. Nutze Buchstaben, Zahlen, Unterstriche und Bindestriche.
  4. Setze Description. Das sagt dem Agent, wann er das Tool aufruft.
  5. Schreib die Funktion im Code editor. Sie ist eine async-Funktion, dieselbe Form wie eine Workflow-Node.
  6. Setze Schema (JSON object). Liste die Felder, die der Agent füllen muss. Lass {}, wenn das Tool keine Eingabe braucht.
  7. Speichere den Agent und starte ihn mit einem Satz, der dieses Tool braucht.

Du siehst den Tool-Namen in der Lauf-Zeitleiste. Das Schema ist ein JSON-Objekt mit type, properties und required.

{
  "type": "object",
  "properties": {
    "query": { "type": "string" }
  },
  "required": ["query"]
}

Wenn das fehlschlägt: das Tool speichert nicht

  • Custom tool 1: name is required. Fülle Tool name.
  • Custom tool 1: code is required. Der Code-Editor ist leer.
  • Custom tool 1: schema JSON is invalid. Das Schema ist kein JSON-Objekt. Predefined tool schema JSON is invalid. ist dasselbe Problem an einem mitgelieferten Tool, das du bearbeitet hast.
  • invalid tool nach dem Speichern bedeutet, dass die Funktion nicht kompiliert. Der Agent bleibt unerreichbar, bis du diese Funktion korrigierst.