Freigeben über

Hinzufügen von Tools zu benutzerdefinierten Agents

Tools sind die Bausteine, mit denen Ihr Agent mit externen Systemen interagieren kann. Tools erweitern die Funktionalität Ihres Agents, sodass sie verschiedene Aktionen als Reaktion auf Benutzeranforderungen oder autonome Trigger ausführen kann. Jedes Tool stellt eine bestimmte Funktion dar, die Ihr Agent ausführen kann. Beispielsweise können Sie Ihren Agenten mit Tools ausstatten, die Dinge wie die Automatisierung von Aufgaben oder die Analyse von Daten erledigen.

  • Senden von E-Mails mithilfe des Office 365 Outlook-Connectors
  • Überprüfen der aktuellen Wetterbedingungen und Prognosen
  • Lesen und Schreiben von Daten aus Dataverse
  • Nachrichten in Teams lesen und veröffentlichen

Mechanismen zum Hinzufügen von Tools

Sie können die Funktionen Ihres benutzerdefinierten Agents erweitern, indem Sie ein oder mehrere Tools hinzufügen. Ihr Agent kann Tools verwenden, um automatisch auf Benutzer zu reagieren, indem er generative Orchestrierung verwendet. Sie können tools auch explizit innerhalb eines Themas aufrufen.

Mit der generativen Orchestrierung (standardmäßig aktiv) kann Ihr Agent automatisch das am besten geeignete Tool oder Thema auswählen oder wissenübergreifend suchen, um auf einen Benutzer zu reagieren. Dieser Orchestrierungsmodus schafft eine dynamischere und intelligentere Unterhaltungserfahrung.

Im klassischen Modus (generative Orchestrierung deaktiviert) kann ein Agent nur Themen verwenden, um auf den Benutzer zu reagieren. Sie können Ihren Agent jedoch so gestalten, dass Tools ausdrücklich aus Themen heraus aufgerufen werden.

Es stehen Ihnen mehrere Mechanismen zur Verfügung, mit denen Sie Ihrem Agent Tools hinzufügen können:

  • Vordefinierter Connector: Wählen Sie aus einer Auswahl von voreingestellten Verbindungen zu Tausenden beliebter APIs sowohl von Microsoft als auch von Nicht-Microsoft-Diensten.
  • Benutzerdefinierter Connector: Definieren Sie eine Verbindung mit einem benutzerdefinierten Dienst oder System, um benutzerdefinierte Tooloptionen mithilfe von Power Platform Connectors zu aktivieren.
  • Agentfluss: Definieren Sie einen Agentfluss, einschließlich einer oder mehrerer auszuführenden Aktionen.
  • Prompt: Einzelner modellbasierter Prompt, der auf von Ihnen bereitgestelltes Wissen zurückgreifen kann.
  • REST-API-Verbindung: Definieren Sie eine Verbindung mit einer REST-API, und wählen Sie einen oder mehrere API-Endpunkte und Methoden aus, die als Tools hinzugefügt werden sollen.
  • Model Context Protocol (MCP)-Tool: Stellen Sie eine Verbindung mit einem MCP-Server her, um auf Tools zuzugreifen.
  • Computerverwendungs-Agent (Vorschau): Ermöglicht Es Ihrem Agent, mit jedem System zu interagieren, das über eine grafische Benutzeroberfläche verfügt, für Websites und Desktop-Apps, auswählen von Schaltflächen, Auswählen von Menüs und Eingeben von Text in Felder auf dem Bildschirm.

Wenn wir über Tools in diesem Artikel und diesen Abschnitt der Dokumentation sprechen, meinen wir einen der Mechanismen in dieser Gruppe. Diese Tooltypen können Ihrem Agent hinzugefügt und auf ähnliche Weise konfiguriert werden.

Es gibt zwei weitere Mechanismen, die Sie verwenden können, um Ihrem Agenten toolähnliches Verhalten hinzuzufügen.

  • Fertigkeit: Container für eine Reihe verwandter Tools.
  • Clienttool: Senden Sie eine Ereignisaktivität an den Client, sodass der Client eine Aktion ausführt und eine Antwort zurückgibt.

Weitere Informationen zu Fähigkeiten und Clienttools finden Sie unter den Links im Abschnitt "Verwandte Inhalte ".

Erstellen und Hinzufügen eines neuen Tools auf Agentebene

Durch die direkte Erstellung neuer Tools in Copilot Studio wird der Entwicklungsprozess optimiert und die ordnungsgemäße Integration mit Ihrem Agenten sichergestellt. Tools, die einem Agent hinzugefügt werden, stehen für die automatische Orchestrierung während der Unterhaltungen Ihres Agenten zur Verfügung.

  1. Öffnen Sie Ihren benutzerdefinierten Agenten durch Auswahl von Agenten im linken Navigationsbereich und wählen Sie Ihren Agenten aus der Liste aus.

  2. Wechseln Sie zur Tools-Seite des Agenten.

  3. Wählen Sie "Tool hinzufügen" aus.

  4. Wählen Sie im Bereich " Tool hinzufügen " die Option "Neues Tool" aus.

  5. Wählen Sie den Typ des Tools aus, das Sie aus der angezeigten Liste hinzufügen möchten:

    • Aufforderung: Erstellen von KI-basierten Textgenerierungs- und Analysetools
    • Agentfluss: Erstellen von mehrstufigen Prozessen mit bedingter Logik
    • Computerverwendung: Aktivieren der GUI-Automatisierung für Ältere Systeme
    • Benutzerdefinierter Connector: Herstellen einer Verbindung mit proprietären APIs und Diensten
    • REST-API: Direkte Integration in Webdienste

  6. Führen Sie die Konfigurationsschritte aus, die für den ausgewählten Tooltyp spezifisch sind. Wenn Sie beispielsweise "Eingabeaufforderung" auswählen, müssen Sie die folgenden Schritte ausführen:

    • Die Promptvorlage und Anweisungen festlegen
    • Angeben von Eingabeparametern
    • Wissensquellen konfigurieren
    • Festlegen des Antwortformats und der Einschränkungen

  7. Testen Sie die Toolkonfiguration mithilfe des Vorschaubereichs, um sicherzustellen, dass sie erwartungsgemäß funktioniert.

  8. Wählen Sie "Speichern" aus, um das neue Tool zu erstellen.

  9. Wählen Sie "Zu Agent hinzufügen " aus, um das Tool Ihrem Agent hinzuzufügen. Das neue Tool wird auf der Seite "Tools " für den Agent angezeigt.

Ihre Toolkonfiguration anzeigen und Änderungen daran vornehmen

Sie können die Konfiguration Ihres Tools jederzeit anzeigen und bearbeiten: Wechseln Sie zur Seite "Tools " für Ihren Agent, und wählen Sie das Tool aus der Liste der Tools aus.

Die Seite "Tooldetails " wird geöffnet, auf der die Konfiguration Des Tools angezeigt wird. Die Details werden in drei Abschnitten angezeigt:

  • Einzelheiten
  • Eingaben
  • Fertigstellung (Tools für MCP-Connector)

Einzelheiten

Im Abschnitt "Details " können Sie grundlegende Details zu Ihrem Tool konfigurieren.

Hier können Sie Folgendes anzeigen und aktualisieren:

  • Name: Der Name des Tools. Dieser Name wird in der Liste der Tools für Ihren Agent angezeigt. Wählen Sie einen Namen aus, der die Funktion des Tools eindeutig angibt.

  • Beschreibung: Eine Beschreibung des Tools. Die generative Orchestrierung basiert auf dieser Beschreibung, um zu bestimmen, wann Ihr Agent das Tool verwenden soll. Schreiben Sie klare, spezifische Beschreibungen, einschließlich der Funktionsweise des Tools und wann sie verwendet werden soll.

  • Weitere Details:

    • Zulassen, dass der Agent dynamisch entscheiden kann, wann das Tool verwendet wird: Wenn diese Option ausgewählt ist, kann der Agent die generative Orchestrierung verwenden, um zu bestimmen, wann das Tool verwendet werden soll. Wenn diese Option nicht ausgewählt ist, verwendet der Agent nur das Tool, wenn es explizit aus einem Thema aufgerufen wird. (Diese Option ist standardmäßig aktiviert, wenn die generative Orchestrierung aktiviert ist.)
    • Fragen Sie den Endbenutzenden vor der Ausführung: Bitten Sie den Agenten in der Chatumgebung des Endbenutzenden um eine Bestätigung, bevor Sie das Tool ausführen. Diese Option ist standardmäßig auf "Nein" festgelegt.
    • Authentifizierung: Wählen Sie aus, ob die Anmeldeinformationen des Benutzers oder Herstellers für das Tool verwendet werden sollen. Standardmäßig gilt die Benutzerauthentifizierung.
    • Beschreibung: Optional können Sie eine Beschreibung des Tools hinzufügen, das dem Benutzer angezeigt wird, wenn das Tool ausgeführt wird. Diese Beschreibung informiert den Benutzer darüber, was er zur Authentifizierung aufgefordert wird.

Eingaben

Hier können Sie die Eingaben für Ihr Tool anzeigen und konfigurieren. Die Eingaben werden verwendet, um Informationen vom Benutzer zu sammeln, um die erforderlichen Eingaben für das Tool auszufüllen. Die Informationen werden als Tabelle angezeigt, eine Zeile für jede Eingabe.

Standardmäßig ist der Spaltenwert Nutzung füllen für jede Eingabe auf Dynamisch mit KI füllen festgelegt. Der Agent versucht, den Wert aus dem verfügbaren Kontext zu extrahieren, z. B. aus der Nachricht des Benutzenden. Wenn kein passender Wert gefunden wird, wird eine Frage generiert, um den Benutzer nach einem Wert zu fragen. Wählen Sie "Anpassen" aus, um auf fein abgestimmte Anpassungen für die Eingabesammlung und -füllung zuzugreifen:

  • Anzeigename und Beschreibung: Wie die Eingabe für den Benutzer angezeigt wird.
  • Identifizieren als: Wie die Antwort des Benutzers interpretiert wird, z. B. als Textzeichenfolge oder einer vordefinierten Entität zugeordnet.
  • Wiederholungslogik: Wenn der Agent keine Entität in der Anweisung des Benutzers identifiziert, kann er die Frage erneut stellen.
  • Eingabeüberprüfung: Konfigurieren Sie zusätzliches Überprüfungsverhalten für die Eingabe des Benutzers über die Standardeinstellung für den Entitätstyp hinaus.

Sie können auch festlegen, dass eine Eingabe mit einem expliziten Wert überschrieben wird, anstatt sie vom Agenten extrahieren zu lassen. Wenn Sie eine Überschreibung festlegen möchten, legen Sie Ausfüllen mit auf Benutzerdefinierter Wertfest und geben Sie einen Wert ein, wählen Sie eine Variable aus oder verwenden Sie eine Power Fx-Formel. Wenn eine Eingabe außer Kraft gesetzt wird, fragt der Agent den Benutzer nicht nach einem Wert.

Fertigstellung

Hier können Sie auswählen, was passieren soll, wenn das Tool die Ausführung abgeschlossen hat.

Sie können den Agent automatisch eine kontextbezogene Antwort für einen Benutzer generieren lassen, basierend auf der Abfrage und dem Ergebnis des Tools.

Alternativ können Sie eine bestimmte formatierte Antwort erstellen, damit Ihr Tool zurückkehren kann. Sie können Verweise auf Ausgabevariablen aus dem Tool mithilfe der Variablenauswahl einfügen. Sie können auch Power Fx-Formeln verwenden, um die Antwort zu formatieren.

Wählen Sie unter "Nach dem Ausführen" eine der verschiedenen Optionen aus, mit denen das Tool auf den Benutzer reagieren soll, nachdem das Tool ausgeführt wurde:

  • Antworten Sie nicht (Voreinstellung): Der Agent integriert die Toolausgabe in seine Antwort.
  • Schreiben sie die Antwort mit generativer KI: Lassen Sie KI eine kontextbezogene Antwort mithilfe der Toolausgabe erstellen
  • Senden einer spezifischen Antwort: Verfassen einer Antwortvorlage mit Einfügen von Variablen
  • Senden einer adaptiven Karte: Erstellen von umfangreichen, interaktiven Antworten mit Schaltflächen und Aktionen

Sie können auch konfigurieren, welche Ausgabevariablen dem Agent und anderen Tools zur Verfügung gestellt werden sollen.

Toolauswahl und Eingabesammlung

Wenn Sie ein Tool in Copilot Studio definieren, stellen Sie auch Informationen bereit, die ihren Zweck beschreiben. Mit diesen Informationen kann der Agent ermitteln, wann das Tool verwendet werden soll, und auch generative KI verwenden, um Fragen zu generieren. Diese Fragen werden verwendet, um Informationen zu sammeln, um die Eingaben auszufüllen, die zum Ausführen des Tools erforderlich sind. In der Folge müssen Sie keine Frageknoten manuell verfassen, um alle benötigten Eingaben zu sammeln, z. B. die Eingaben zu einem Flow. Die Eingabesammlung wird zur Laufzeit für Sie übernommen.

Der Agent verwendet mehrere Faktoren, um die Auswahl des Tools zu bestimmen:

  • Name und Beschreibung des Tools
  • aktueller Kontext der Unterhaltung
  • Benutzerabsicht, die von ihrer Nachricht abgeleitet wurde
  • Verfügbare Eingaben und Ausgaben
  • Vorherige Toolverwendung in der Unterhaltung

Wenn Sie den generativen Modus verwenden, geben Tools ihre Informationen standardmäßig wieder an den Agent zurück, damit der Agent eine kontextbezogene Antwort auf die Abfrage des Benutzers generieren kann. Alternativ können Sie Ihr Tool anweisen, immer sofort zu antworten, indem Sie entweder eine Nachricht generieren oder eine explizite Nachricht erstellen.

Tipp

Wenn Sie generierte Fragen aus einem Tool verwenden, informieren Sie Ihre Benutzer darüber, dass einige der Unterhaltungen von KI generiert werden.

Fügen Sie dem Systemthema Unterhaltung beginnen zum Beispiel eine zusätzliche Nachricht hinzu. Dieses Thema bestimmt die Nachricht, die Ihren Benutzern angezeigt wird, wenn eine neue Unterhaltung beginnt.

Aufrufen eines vorhandenen Tools aus einem Thema

Sie können ein Tool explizit aus einem Thema aufrufen. Je nach Anwendungsfall können Sie Ihr Tool als Teil eines breiteren Themas verwenden, das mehr Knoten verwendet. Vielleicht ist das Hinzufügen eines Knotens zu einem Thema wie beim Wetterbeispiel auch alles, was Sie benötigen.

So rufen Sie ein Tool aus einem Thema auf:

  1. Gehen Sie in Copilot Studio zur Seite Themen für den Agenten, den Sie bearbeiten möchten.

  2. Erstellen Sie ein neues Thema und benennen Sie es Wetter abrufen.

  3. Fügen Sie folgende Triggerausdrücke hinzu:

    • Wird es regnen
    • Heutige Vorhersage
    • Wetter abrufen
    • Wie ist das Wetter

  4. Wählen Sie "Knoten hinzufügen " (+) und dann " Tool hinzufügen" aus. Wählen Sie das Tool aus den verfügbaren Tools aus. Es gibt drei Registerkarten mit verschiedenen Arten von Tools:

    • Grundlegende Tools
    • Verbinder
    • Werkzeug

    Ihr Aktionsknoten wird nun zu Ihrem Thema hinzugefügt.

  5. Wählen Sie Speichern.

Tools (nur MCP-Connectors)

Unter "Tools" können Sie die Namen und Beschreibungen der Tools anzeigen, die für den MCP-Connector verfügbar sind. Die Tools werden in einer Tabelle angezeigt, eine Zeile für jedes Tool. Für jedes Tool können Sie Folgendes sehen:

  • Toolname und -version
  • Eingabe- und Ausgabeparameter
  • Geschätzte Ausführungszeit
  • Nutzungsstatistiken

Überlegungen zur Authentifizierung für Tools

Einige Tools erfordern eine ordnungsgemäße Authentifizierung, z. B. dynamische Aufforderung oder andere, die eine Dataverse-API aufrufen. Die richtige Authentifizierungskonfiguration gewährleistet Sicherheit und gleichzeitig eine reibungslose Benutzererfahrung.

Tools werden immer in der Laufzeit des Agents im Benutzerkontext ausgeführt und können nur ausgeführt werden, wenn die Authentifizierung aktiviert ist. Zwei Typen von Authentifizierungsmethoden werden unterstützt:

  • Benutzerauthentifizierung: Der Agent verwendet die Anmeldeinformationen des Benutzers, um sich beim Dienst zu authentifizieren. Diese Methode stellt sicher, dass Benutzer nur auf Daten zugreifen, die sie sehen dürfen.
  • Copilot Autorenauthentifizierung: Der Agent verwendet die Anmeldeinformationen seines Copilot-Autors, um sich beim Dienst zu authentifizieren. Verwenden Sie diesen Authentifizierungsmodus für freigegebene Ressourcen oder wenn Benutzer keinen individuellen Zugriff benötigen sollten.

Testen Sie Ihr Tool

Bei der generativen Orchestrierung wählt der Orchestrator Ihr Tool aus, wenn es für eine Benutzerabfrage relevant ist.

Alternativ können Sie ein vorhandenes Tool aus einem Thema aufrufen.

Zugehöriger Inhalt