Tools

Tools werden verwendet, um Ihren Agenten mit externen Systemen oder Inline-Code zu verbinden, der dem Agenten bereitgestellt wird. So kann Ihr Agent mit anderen Systemen interagieren, um Informationen abzurufen, zu aktualisieren, zu formatieren oder zu analysieren. In den Abschnitten auf dieser Seite werden verschiedene Arten von unterstützten Tools beschrieben.

Tool erstellen

So erstellen Sie ein Tool:

  1. Klicken Sie rechts neben dem Agent Builder auf das Werkzeugsymbol.
  2. Wählen Sie einen Tooltyp aus (siehe Beschreibungen der Tooltypen in diesem Dokument).
  3. Geben Sie die erforderlichen Informationen für das Tool an.
  4. Verwenden Sie die Snake-Case-Schreibweise für den Toolnamen.
  5. Tool-Beschreibungen werden für Agent-Modelle bereitgestellt.

Tool in einem Agenten verwenden

Nachdem Sie ein Tool erstellt haben, müssen Sie einen bestimmten KI-Agenten anweisen, es zu verwenden.

  1. Bewegen Sie den Mauszeiger auf einen Agenten.
  2. Klicken Sie auf Tool hinzufügen.
  3. Wählen Sie ein Tool aus.
  4. Beschreiben Sie in den Anweisungen für Ihren KI-Agenten, wie das Tool verwendet werden soll.

Tool testen

Bevor Sie ein Tool in Ihrem Agenten verwenden, können Sie es in der Console testen:

  1. Öffnen Sie den Bereich „Tools“.
  2. Klicken Sie oben im Bereich auf die Schaltfläche Testtool.

  3. Geben Sie Eingaben für das Tool gemäß dem Tool-Schema an. Wenn das Schema beispielsweise JSON mit den Attributen place und city ist, können Sie die folgende Eingabe verwenden:

    {
  "place": "automobile repair center",
  "city": "austin texas"
}

  4. Klicken Sie auf Senden. Das Tool wird mit der Eingabe ausgeführt und die Ausgabe wird ausgegeben.

Nachdem Sie das Tool direkt getestet haben, können Sie es auch mit der Vorschaufunktion testen.

Verfügbare Tools

Folgende Tools sind verfügbar:

Tool Beschreibung
A2A-Protokoll Agenten mit dem A2A-Messaging-Standard mit externen Agenten verbinden (Vorschau)
KI-Agent als Tool Funktionen von Agenten wiederverwenden, ohne an einen anderen Agenten zu übergeben
Client-Funktionstools Code-Tools, die clientseitig ausgeführt werden, nicht vom Agenten.
Confluence-Tools Verbinden Sie Ihren Agenten mit einer Confluence-Instanz.
Datenspeichertools KI-generierte Agentenantworten auf Grundlage von Website-Inhalten und hochgeladenen Daten liefern
Tools zur Dateisuche Laden Sie eine Datei hoch oder stellen Sie einem Agenten eine RAG-Wissensdatenbank zur Verfügung.
Google Maps-Tools Verbinden Sie Ihren Agenten mit Google Maps. (Vorschau)
Tools für die Google Suche Verbinden Sie Ihren Agenten mit der Fundierung mit der Google Suche.
Integration Connectors-Tools Tools erstellen, die Ihre konfigurierten Verbindungen nutzen.
Jira-Tools Verbinden Sie Ihren Agenten mit einer Jira-Instanz.
MCP-Tools Verbindung mit einem MCP-Server herstellen
OpenAPI-Tools Verbindung zu einer externen API über ein OpenAPI-Schema herstellen
Python-Code-Tools Stellen Sie Python-Code als Tool für Ihren Agenten bereit.
Salesforce-Tools Verbinden Sie Ihren Agent mit einer Salesforce-Instanz.
Service Now-Tools Verbinden Sie Ihren Agent mit einer ServiceNow-Instanz.
SharePoint-Tools Verbinden Sie Ihren Agenten mit einer SharePoint-Instanz.
System tools Integrierte Tools, die vom KI-Agenten für häufige Aufgaben genutzt werden können.
Widget-Tools Flexible Widget-Tools zum Erstellen umfangreicher Nutzerinteraktionen.

Ausführungstyp

Tools unterstützen zwei Ausführungstypen: asynchron (nicht blockierend) und synchron (blockierend). Die Auswahl des geeigneten Ausführungstyps hängt von der Latenz des Tools und der gewünschten Agent-Erfahrung ab. Diese Einstellung ist auf dem Tab Erweitert der Toolkonfiguration verfügbar.

Synchroner Ausführungstyp

Dieser Typ sollte verwendet werden, wenn die Tool-Ausführung die Generierung von Agent-Antworten blockieren soll, bis die Tool-Antwort verfügbar ist. Der Agent generiert erst dann eine Antwort, wenn die Tool-Antwort verfügbar ist. Diese Tools sollten idealerweise eine niedrige Latenz (weniger als 5 Sekunden) aufweisen, um die Latenz der Agentenantwort insgesamt niedrig zu halten.

Asynchroner Ausführungstyp

Dieser Typ sollte für die nicht blockierende Ausführung von Tools verwendet werden. Wenn ein Tool-Aufruf ausgelöst wird, antwortet der Agent mit „pending“ (ausstehend). Der Agent kann weiterhin mit dem Nutzer sprechen, während die Tool-Antwort abgerufen wird. Sobald die Antwort verfügbar ist, wird sie dem Kontext hinzugefügt, wenn das nächste Mal eine Antwort des KI-Agents generiert wird. Ideal für Tools mit Antwortlatenzen von 5 bis 60 Sekunden.

Gesprächsverlauf für den asynchronen Ausführungstyp:

  1. Agent löst Funktionsaufruf aus: Der Agent löst einen Funktionsaufruf aus und wartet auf eine Antwort. Beispiel: „Rufe das Tool für den Bestellstatus auf.“
  2. Tool pending response (Tool wartet auf Antwort): Das Tool gibt sofort ein function_response mit dem Status „Ausstehend“ zurück, z. B. "status": "pending".
  3. KI-Agent verarbeitet ausstehendes Tool: Der KI-Agent sollte angewiesen werden, ausstehende Antworten wie gewünscht zu verarbeiten. Beispielanweisung: „Frage den Nutzer, ob er weitere Fragen hat, während du den Bestellstatus abrufst.“ Beispiel für eine Antwort des Kundenservicemitarbeiters: „Kann ich sonst noch etwas für Sie tun, während ich den Bestellstatus abrufe?“

  4. KI-Agent verarbeitet die endgültige Antwort: Die tatsächliche Tool-Antwort ist für den KI-Agenten verfügbar. Diese wird als Kontext-Tag eingefügt. Beispiel:

    <context>function [<tool_name>] completed with response <response JSON></context>

Best Practices

Beachten Sie die folgenden Best Practices für Tools:

  • Verwenden Sie immer semantisch sinnvolle Toolnamen, die für die jeweilige Aufgabe relevant sind.
  • Geben Sie immer hochwertige Beschreibungen Ihrer Tools und der Aufgabe(n) an, die sie ausführen können.
  • Geben Sie für asynchrone Tools eine detaillierte Anleitung für die folgenden Szenarien an:
    • Informiere den Kundenservicemitarbeiter, dass ein asynchrones Tool ist und anfangs eine ausstehende Antwort zurückgibt.
    • Geben Sie an, wie der KI-Agent reagieren soll, wenn das Tool „pending“ zurückgibt.
    • Geben Sie Anweisungen dazu an, wie der Agent reagieren soll, wenn die tatsächliche Tool-Antwort verfügbar ist.
    • Geben Sie Anweisungen dazu an, wie der Agent reagieren soll, wenn das Tool einen Fehler zurückgibt.