Hinzufügen von Tools zu benutzerdefinierten Agents

Werkzeuge sind Bausteine, mit denen dein Agent mit externen Systemen interagieren kann. Tools erweitern, was dein Agent tun kann, indem sie es ihm ermöglichen, verschiedene Aktionen als Reaktion auf Nutzerwünsche oder autonome Auslöser auszuführen. Jedes Tool stellt eine bestimmte Funktion dar, die Ihr Agent ausführen kann. Zum Beispiel können Sie Ihren Makler mit Werkzeugen ausstatten, die Aufgaben wie folgende Aufgaben ausführen:

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 Werkzeugen zu Agenten

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. Du kannst auch Tools explizit aus einem Thema heraus 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:

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 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. 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 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.

Öffnen Sie Ihren benutzerdefinierten Agent durch Auswahl von Agent im linken Navigationsbereich und wählen Sie Ihren Agent aus der Liste aus.
Wechseln Sie zur Tools-Seite des Agenten.
Wählen Sie "Tool hinzufügen" aus.
Wählen Sie im Bereich " Tool hinzufügen " die Option "Neues Tool" aus.
Wählen Sie den Typ des Tools aus, das Sie aus der angezeigten Liste hinzufügen möchten:
- Prompt
- Agent-Flow
- Computerverwendung
- benutzerdefinierter Connector
- Modellkontextprotokoll
- REST API
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
Wählen Sie Speichern oder Veröffentlichen aus, um das neue Tool zu erstellen.
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 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 Konfigurationsseite für Ihr Tool wird geöffnet. Die Details werden in drei Abschnitten angezeigt:

Einzelheiten
Eingänge
Completion

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 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 Informationen:
- 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 (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, was er zur Authentifizierung aufgefordert wird.

Eingänge

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.

Completion

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 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:

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

Im generativen Modus geben Werkzeuge standardmäßig ihre Informationen an den Agenten zurück. 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, 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 KI einen Teil der Unterhaltung generiert hat.

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önntest du dein Tool als Teil eines größeren Themas nutzen, das mehrere Knoten verwendet. Oder, wie im folgenden Beispiel, könnte das Hinzufügen eines einzelnen Aktions- (Tool-)Knotens zu einem Thema ausreichen.

So rufen Sie ein Tool aus einem Thema auf:

Gehen Sie in Copilot Studio zur Seite Themen für den Agent, den Sie bearbeiten möchten.
Erstellen Sie ein neues Thema, und geben Sie ihm einen Namen, z. B. Wetter abrufen.
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
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:
- Basistools
- Verbinder
- Tool
Ihr Aktionsknoten wird nun zu Ihrem Thema hinzugefügt.
Wählen Sie Speichern aus.

MCP-Connectorinformationen

Für MCP-Connector können Sie die Namen und Beschreibungen der MCP-Tools und -Ressourcen anzeigen, die vom MCP-Connector zur Verfügung gestellt werden. Informationen zu den Tools und Ressourcen werden in einer Tabelle angezeigt, eine Zeile für jedes Tool.

Ü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:

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, die sie sehen dürfen.
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 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.

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 du ein Tool zu einem Agenten hinzufügst, ist das Tool standardmäßig aktiviert.

So deaktivieren Sie ein Tool in einem Agent:

Wechseln Sie zur Ihrem Agent, und wählen Sie die Seite Tools für Ihren Agent aus.
Wählen Sie das Tool aus, um zur Toolkonfigurationsseite zu wechseln.
Deaktivieren Sie oben auf der Konfigurationsseite das Tool mithilfe des Umschalters Aktiviert.
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:

Wechseln Sie zur Ihrem Agent, und wählen Sie die Seite Tools für Ihren Agent aus.
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 (...).
Klicken Sie auf Löschen. Ein Bestätigungsfenster wird angezeigt.
Wählen Sie Löschen aus, um das Tool zu löschen.

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

Hinweis

Sie können Tools nur auf der Seite mit den Agent-Tools löschen. Tools können nicht auf der Tools-Hauptseite von Copilot Studio gelöscht werden.

Einschränkungen der Werkzeuge in Agenten

Bei generativer Orchestrierung kann der Orchestrator maximal 128 Werkzeuge pro Agent verarbeiten. Für beste Leistung und Ergebnisse empfehlen wir jedoch, die Anzahl der Werkzeuge in Ihrem Makler auf höchstens 25-30 zu begrenzen.
Bei der Verwendung von Multi-Agent-Orchestrierung mit Kinderagenten haben Kinderagenten ihre eigene Orchestrierung und können bis zu 128 Werkzeuge verwalten.

Feedback

War diese Seite hilfreich?

Last updated on 2026-01-29