Eigene Tools

Der Assistent handelt in Ihrer App

Geben Sie Ihrem Masheev-Assistenten typisierte Tools, die er während eines Gesprächs aufrufen kann. Sie laufen in Ihrer App, können eine Karte oder Schnellantworten zurückgeben und auf die Bestätigung der Person warten. Client-Tools laufen im Website-Chat.

14 Tage testen Entwicklerübersicht

Ab $18/Monat für Ihr ganzes Team nach der Testphase. Karte erforderlich. Keine Abbuchung bei Kündigung innerhalb von 14 Tagen. Verfügbar für Unternehmen im Vereinigten Königreich und in den USA.

Was sind KI-Agenten-Tools (Function Calling)?

Tools sind Funktionen, die Sie dem Assistenten geben, damit er nicht nur antworten, sondern auch handeln kann. Während eines Gesprächs entscheidet er, wann ein Tool nötig ist, ruft es mit validierten Argumenten auf und nutzt das Ergebnis, um weiterzumachen: eine Bestellung nachschlagen, einen Termin buchen oder einen Datensatz aktualisieren.

In Masheev definieren Sie Client-Tools mit dem Helfer clientTool, typisiert mit Zod oder JSON Schema. Ihre Funktion execute läuft in Ihrer App und kann Text, eine Karte oder Schnellantworten zurückgeben, auf Wunsch mit Freigabe für sensible Aktionen. Der Agent kann im Backend außerdem serverseitige Aktionen und verbundene Integrationen nutzen.

Das Tool, Zeile für Zeile

Drei Codeblöcke. Das ist ein Tool.

import { clientTool, useMasheev } from "@masheev/embed-sdk/react";
import { z } from "zod";

const checkOrder = clientTool({
  name: "check_order_status",
  description: "Look up the status of a customer's order",
  parameters: z.object({ orderId: z.string() }),
  needsApproval: false,

Typisiert mit Zod oder JSON Schema

Definieren Sie Name, Beschreibung und Parameter eines Tools mit Zod oder reinem JSON Schema. Der Assistent ruft es mit validierten Argumenten auf.

  execute: async ({ orderId }) => {
    const order = await myApi.getOrder(orderId);
    return {
      success: true,
      display: "card",
      components: {
        card: {
          title: `Order ${order.id}`,
          fields: [{ label: "Status", value: order.status }],
        },
      },
    };
  },
});

Läuft in Ihrer App

Ihre execute-Funktion läuft im Browser. Sie kann Ihre API aufrufen, einen Datensatz nachschlagen oder einen Termin buchen und das Ergebnis dann an das Gespräch zurückgeben.

```
// Pass tools to the assistant
useMasheev({ inboxId: "inb_123", tools: [checkOrder] });
```
3
Dem Assistenten übergeben
Übergeben Sie Ihre Tools an useMasheev oder aktualisieren Sie sie während einer Sitzung. Der Assistent ruft sie auf, wenn sie relevant sind.

Freigabe

Erst fragen.

KundeIch möchte das zurückgeben.
AssistentIch starte eine Rücksendung für Bestellung 1042. Bestätigen?
Ihre Appexecute() läuft erst, wenn der Kunde bestätigt.

Freigabe vor der Ausführung: Setzen Sie needsApproval bei einem Tool, und die Person bestätigt, bevor es läuft. Nutzen Sie das für alles, was Daten ändert oder Geld kostet.
Ergebnisse sind Daten, keine Anweisungen: Tool-Ergebnisse werden bereinigt und dem Modell als Daten übergeben, mit Größen- und Ratenbegrenzungen, was vor Prompt Injection schützt.

Illustratives Beispiel

Mehr

Was ein Tool sonst kann.

Liefert Karten und Schnellantworten

Ein Ergebnis kann als Text, strukturierte Karte oder Schaltflächen für Schnellantworten erscheinen, sodass Menschen die Bestellung oder Buchung selbst sehen statt eines Absatzes darüber.

Serverseitige Aktionen

Neben Client-Tools kann der Agent serverseitige Aktionen und verbundene Integrationen, etwa Kalender, vom Backend aus nutzen.

Noch nichtEigene APIs serverseitig anbinden und Tools außerhalb des Website-Chats.

Ihre App erledigt die Arbeit.

Häufige Fragen

Was sind KI-Agenten-Tools?

Tools, auch Function Calling genannt, sind Funktionen, die Sie dem Assistenten geben, damit er nicht nur antworten, sondern auch handeln kann. Während eines Gesprächs entscheidet er, wann er ein Tool aufruft, sendet validierte Argumente und nutzt das Ergebnis, um weiterzumachen. In Masheev laufen Client-Tools in Ihrer App und serverseitige Aktionen im Backend.

Wie definiere ich ein Tool?

Nutzen Sie den Helfer clientTool mit Name, Beschreibung und Parameterschema (Zod oder JSON Schema) sowie einer execute-Funktion, die die Arbeit erledigt und ein Ergebnis zurückgibt. Übergeben Sie Ihre Tools an useMasheev oder aktualisieren Sie sie während einer Sitzung. Der Assistent ruft sie auf, wenn sie relevant sind.

Kann ein Tool vor der Ausführung eine Freigabe verlangen?

Ja. Setzen Sie needsApproval beim Tool, und die Person muss bestätigen, bevor Ihre execute-Funktion läuft. Nutzen Sie das für Aktionen, die Daten ändern, Bestellungen auslösen oder Geld kosten.

Können Tools eine reichhaltige Oberfläche zeigen, nicht nur Text?

Ja. Ein Tool-Ergebnis kann im Gespräch als einfacher Text, als strukturierte Karte (Titel, Untertitel und beschriftete Felder) oder als Schaltflächen für Schnellantworten angezeigt werden.

Wie werden Tools abgesichert?

Tool-Ergebnisse werden bereinigt und strikt als Daten behandelt, nicht als Anweisungen an das Modell, was vor Prompt Injection schützt. Zurückgegebene Daten haben Größenlimits, Aufrufe sind ratenbegrenzt, und sensible Aktionen können eine Freigabe verlangen.

Geben Sie dem Assistenten etwas zu tun

Definieren Sie typisierte Tools, legen Sie fest, welche eine Freigabe brauchen, und lassen Sie den Assistenten die Abfragen und Buchungen übernehmen.

14 Tage testen Mit dem Team sprechen