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 er 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 Agent mit Tools ausstatten, die z. B. folgende Aufgaben erledigen können:

• Senden von E-Mails mithilfe des Office 365 Outlook-Konnektors
• Ü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 durchsuchen, um einem Benutzer zu antworten. 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:

• Konnektor: Stellen Sie eine Verbindung mit proprietären APIs und Diensten mithilfe von Power Platform-Konnektoren her, um Daten abzurufen oder Aktionen auszuführen.
  • Vordefinierter Connector: Wählen Sie aus einer Auswahl von voreingestellten Verbindungen zu Tausenden beliebter APIs, die sowohl von Microsoft als auch von anderen Diensten stammen.
  • Benutzerdefinierter Connector: Definieren Sie eine Verbindung mit einem benutzerdefinierten Dienst oder System, um benutzerdefinierte Tooloptionen mithilfe von Power Platform-Connectors zu aktivieren. Der Konnektor benötigt Anzeige- und Freigabeberechtigungen für die Organisation, damit der Agent den Konnektor verwenden kann.
• Agent-Flow: Definieren Sie einen Agent-Flow, der eine oder mehrere auszuführende Aktionen enthält.
• Prompt: Modellbasierter Prompt mit einem Durchlauf, der auf das von Ihnen bereitgestellte Wissen verweisen und Code zur Analyse von Daten generieren kann.
• REST-API: Definieren Sie eine Verbindung zu 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: Stellen Sie eine Verbindung zu einem MCP-Server her, um auf Tools und Ressourcen zuzugreifen.
• Computernutzung: Ermöglicht es Ihrem Agent, mit jedem System zu interagieren, das über eine grafische Benutzeroberfläche verfügt, z. B. bei Websites und Desktop-Apps, indem er Schaltflächen und Menüs auswählt und Text in Felder auf dem Bildschirm eingibt.

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 den Fähigkeiten und Client-Tools finden Sie unter den Links im Abschnitt Zugehöriger Inhalt.

Erstellen und Hinzufügen eines neuen Tools auf Agent-Ebene

Durch die direkte Erstellung neuer Tools innerhalb von Copilot Studio wird der Entwicklungsprozess optimiert und die ordnungsgemäße Integration mit Ihrem Agent 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 Agent durch Auswahl von Agent im linken Navigationsbereich und wählen Sie Ihren Agent aus der Liste aus.

2. Gehen Sie zur Seite Tools für den Agent.

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

4. Wählen Sie im Bereich Tool hinzufügenNeues Tool aus.

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

   • Eingabeaufforderung
   • Agent-Flow
   • Computerbenutzer
   • Benutzerdefinierter Connector
   • Modellkontextprotokoll
   • REST-API

   

6. Führen Sie die Konfigurationsschritte für den ausgewählten Tooltyp aus. Wenn Sie z. B. Prompt auswählen, müssen Sie die folgenden Schritte ausführen:

   • Die Promptvorlage und Anweisungen festlegen
   • Geben Sie die Eingabeparameter ein
   • Wissensquellen konfigurieren
   • Festlegen von Antwortformat und Einschränkungen

7. Wählen Sie Speichern oder Veröffentlichen aus, um das neue Tool zu erstellen.

8. Wählen Sie Hinzufügen und konfigurieren aus. Das Tool wird Ihrem Agent hinzugefügt. Die Konfigurationsseite für Ihr Tool wird angezeigt. Hier können Sie Ihre Werkzeugkonfiguration anzeigen und bearbeiten.

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 des Tools jederzeit anzeigen und bearbeiten: Wechseln Sie einfach zur Seite Tools für Ihren Agent, und wählen Sie das Tool aus der Liste der Tools aus.

Die Konfigurationsseite für Ihr Tool wird geöffnet. Die Details werden in drei Abschnitten angezeigt:

• Einzelheiten
• Eingaben
• Abschluss

Bei MCP-Servern, die als Agent-Tools verbunden sind, unterscheidet sich die Konfigurationsseite von der anderer Tooltypen. Der Abschnitt Details ist ähnlich, aber anstelle von Eingaben und Abschluss gibt es die Abschnitte Tools und Ressourcen, die Informationen zu verfügbaren Tools und Ressourcen für den MCP-Server anzeigen. Weitere Informationen finden Sie unter Anzeigen von Tools und Ressourcen in einem vorhandenen MCP-Server.

Einzelheiten

Im Abschnitt Details können Sie grundlegende Details zu Ihrem Werkzeug 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 Tool. Die generative Orchestrierung stützt sich auf diese Beschreibung, um zu bestimmen, wann Ihr Agent das Tool verwenden soll. Schreiben Sie klare, spezifische Beschreibungen, z. B. wie das Tool funktioniert und wann es verwendet werden soll.

• Weitere Informationen:

  • Den Agent dynamisch entscheiden lassen, wann dieses Tool verwendet werden soll: 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 das Tool nur, wenn es explizit aus einem Thema aufgerufen wird. (Standardmäßig ist diese Option 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. Standardmäßig ist diese Option auf Nein festgelegt.
  • Authentifizierung: Wählen Sie aus, ob die Anmeldeinformationen des Benutzers (Endbenutzer) oder die Anmeldeinformationen des Erstellers (vom Ersteller bereitgestellt) für das Tool verwendet werden sollen. Standardmäßig gilt die Benutzerauthentifizierung.
  • Beschreibung: Optional können Sie eine Beschreibung des Tools hinzufügen, die der Agent dem Benutzer anzeigt, wenn er das Tool ausführen möchte. Diese Beschreibung informiert den Benutzer darüber, wofür er sich authentifizieren soll.

Eingaben

Hier können Sie die Eingaben für Ihr Tool anzeigen und konfigurieren. Die Eingaben werden verwendet, um Informationen vom Benutzer einzuholen und so 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 weitere fein abgestufte Anpassungen für die Eingabeerfassung und -füllung zuzugreifen.

• Anzeigename und Beschreibung: Gibt an, wie die Eingabe für den Benutzer angezeigt wird.
• Identifizieren als: Gibt an, 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.
• Eingabeprü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 überschrieben wird, fragt der Agent den Benutzer nicht nach einem Wert.

Abschluss

Hier können Sie auswählen, was passieren soll, wenn das Tool ausgeführt wird.

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

Alternativ können Sie auch eine bestimmte, formatierte Antwort erstellen, die Ihr Tool zurückgeben soll. 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 von mehreren Optionen aus, wie das Tool auf den Benutzer reagieren soll, nachdem das Tool ausgeführt wurde:

• Nicht antworten (Standard): Der Agent bezieht die Toolausgabe in seine Antwort ein.
• Antwort mit generativer KI schreiben: Lassen Sie die KI anhand der Toolausgaben eine kontextbezogene Antwort erstellen.
• Spezifische Antwort senden: Erstellen Sie eine vorgefertigte Antwort mit Variableneinfügung.
• Adaptive Karte senden: Erstellen Sie umfassende, interaktive 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 seinen Zweck beschreiben. Mit diesen Informationen kann der Agent herausfinden, wann das Tool verwendet werden soll. Die Toolbeschreibung hilft dem Orchestrator auch, generative KI zu verwenden, um bei Bedarf Fragen zur Eingabensammlung zu generieren. Ihr Agent kann Fragen verwenden, um Informationen zu sammeln, mit denen die für die Verwendung des Tools erforderlichen Eingaben ausgefüllt werden. In der Folge müssen Sie keine Frageknoten manuell verfassen, um alle benötigten Eingaben zu sammeln, z. B. die Eingaben zu einem Flow. Der Agent-Orchestrator verarbeitet die Eingabesammlung für Sie zur Laufzeit.

Der Agent berücksichtigt mehrere Faktoren, um die Auswahl der Tools zu bestimmen:

• Der Toolname und die Beschreibung
• Der aktuelle Unterhaltungskontext
• Benutzerabsicht, die von ihrer Nachricht abgeleitet wurde
• Verfügbare Eingaben und Ausgaben
• Vorherige Toolverwendung in der Unterhaltung

Standardmäßig verwenden Tools den generativen Modus, um ihre Informationen an den Agent zurückzugeben. Mit der Toolantwort kann der Agent eine kontextbezogene Antwort auf die Abfrage des Benutzers generieren. Alternativ können Sie Ihr Tool anweisen, immer sofort zu antworten, entweder indem eine Nachricht generiert oder eine explizite Nachricht verfasst wird.

Rufen Sie ein vorhandenes Tool innerhalb eines Themas auf

Sie können ein Tool explizit innerhalb eines Themas aufrufen. Je nach Anwendungsfall können Sie Ihr Tool als Teil eines umfassenderen 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.

Um ein Tool in einem Thema aufzurufen:

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

2. Erstellen Sie ein neues Thema, und geben Sie ihm einen Namen, z. B. Wetter abrufen.

3. Fügen Sie entsprechende Triggerausdrücke hinzu. Um mit demselben Wetterbeispiel aus dem vorherigen Schritt fortzufahren, können Triggerausdrücke Folgendes umfassen:

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

4. Klicken Sie auf die Schaltfläche Knoten hinzufügen (+) und anschließend auf Ein Tool hinzufügen. Wählen Sie das Tool aus den verfügbaren Tools aus. Es gibt drei Registerkarten, die verschiedene Arten von Tools zeigen:

   • Basistools
   • Konnektor
   • Tool

   Ihr Aktionsknoten wird nun zu Ihrem Thema hinzugefügt.

5. Wählen Sie Speichern aus.

MCP-Konnektorinformationen

Für den MCP-Konnektor können Sie die Namen und Beschreibungen der MCP-Tools und -Ressourcen anzeigen, die vom MCP-Konnektor bereitgestellt wurden. Informationen zu den Tools und Ressourcen werden in einer Tabelle angezeigt (eine Zeile für jedes Tool).

Überlegungen zur Authentifizierung bei Tools

Einige Tools erfordern eine Authentifizierung, um ordnungsgemäß zu funktionieren, z. B. den dynamischen Prompt oder andere, die eine Dataverse-API aufrufen. Die richtige Authentifizierungskonfiguration gewährleistet Sicherheit und sorgt gleichzeitig für eine reibungslose Benutzererfahrung.

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

• Endbenutzer-Anmeldeinformationen: Der Agent verwendet die Anmeldeinformationen des Benutzers, um sich beim Dienst zu authentifizieren. Diese Methode stellt sicher, dass Benutzer nur auf Daten zugreifen, für die sie autorisiert sind.
• Vom Entwickler bereitgestellte Anmeldeinformationen: Der Agent verwendet die Anmeldeinformationen seines Erstellers, um sich mit dem Dienst zu authentifizieren. Verwenden Sie diesen Authentifizierungsmodus für freigegebene Ressourcen oder für den Fall, wenn Benutzer keinen individuellen Zugriff benötigen sollten.

Testen Sie Ihr Tool

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

Alternativ können Sie Ein bestehendes Tool innerhalb eines Themas aufrufen.

Aktivieren oder Deaktivieren eines Tools in Ihrem Agent

Sie können ein Tool für Ihren Agent über die Toolkonfigurationsseite aktivieren oder deaktivieren. Durch das Deaktivieren eines Tools wird verhindert, dass der Agent das Tool verwendet. Das Tool ist aber weiterhin mit dem Agent verbunden und kann später wieder aktiviert werden. Wenn Sie einem Agent ein Tool hinzufügen, ist es standardmäßig aktiviert.

So deaktivieren Sie ein Tool in einem Agent:

1. Wechseln Sie zur Ihrem Agent, und wählen Sie die Seite Tools für Ihren Agent aus.
2. Wählen Sie das Tool aus, um zur Toolkonfigurationsseite zu wechseln.
3. Deaktivieren Sie oben auf der Konfigurationsseite das Tool mithilfe des Umschalters Aktiviert.
4. Wählen Sie Speichern aus, um die Änderung zu übernehmen.

Das Tool wird weiterhin in der Liste der Agent-Tools angezeigt, ist aber nicht mehr aktiviert.

Löschen eines Tools aus Ihrem Agent

Das Deaktivieren eines Tools blockiert die Verwendung des Tools, bietet Ihnen aber auch die Flexibilität, es später wieder zu aktivieren. Sie können ein Tool auch dauerhaft von Ihrem Agent entfernen. So löschen Sie ein Tools aus Ihrem Agent:

1. Wechseln Sie zur Ihrem Agent, und wählen Sie die Seite Tools für Ihren Agent aus.
2. Suchen Sie das Tool in der Liste der Tools, und zeigen Sie mit dem Mauszeiger auf den Toolnamen. Wählen Sie die drei Punkte aus (...).
3. Klicken Sie auf Löschen. Ein Bestätigungsfenster wird angezeigt.
4. Wählen Sie Löschen aus, um das Tool zu löschen.

Das Tool wird aus der Liste der Agent-Tools entfernt.

Zugehöriger Inhalt

• Konnektoren verwenden
• Eingabeaufforderungen verwenden
• Agent-Flows mit dem Agenten verwenden
• Model Context Protocol (MCP)
• Tools aus einer REST-API hinzufügen
• Fertigkeiten verwenden
• Client-Werkzeuge
• Computerbenutzung (Vorschauversion)