Freigeben über


Untergeordneten Agent hinzufügen

Ein untergeordneter Agent ist ein einfacher Agent, der im Kontext des Haupt-Agents besteht. Mit untergeordneten Agents können Sie Tools, Anweisungen und Wissen logisch in klar definierte Unter-Agents innerhalb eines größeren Agents gruppieren. Sie eignen sich ideal für einzelne Anwendungsfälle, die auf eine einzelne Absicht reagieren oder eine einzelne Aufgabe ausführen. Dieser Artikel erklärt, wie Sie einen untergeordneten Agent erstellen und verwalten.

Einen untergeordneten Agenten erstellen

  1. Wechseln Sie zur Seite Agents für Ihren Haupt-Agent, und wählen Sie Agent hinzufügen aus.

  2. Wählen Sie Neuer untergeordneter Agent aus.

  3. Geben Sie einen eindeutigen Namen für Ihren neuen untergeordneten Agent ein.

  4. Bestimmen Sie, wann Ihr Agent verwendet werden soll. Standardmäßig reagieren Agents auf Benutzer oder Trigger basierend auf ihrer Beschreibung.

    • Wenn Sie das Standardverhalten verwenden möchten (Der Agent wählt – basierend auf der Beschreibung) geben Sie eine kurze Beschreibung des Zwecks Ihres Agents ein.
    • Erweitern Sie andernfalls die Liste unter Wann wird dies verwendet?, und wählen Sie das gewünschte Verhalten aus. Weitere Informationen zu den unterstützten Verhaltensweisen finden Sie unter Bestimmen, wann Ihr Agent verwendet werden soll.
  5. Geben Sie klare Anweisungen ein, denen Ihr Agent folgen soll, wenn er aufgerufen wird. Wenn Sie in Ihren Anweisungen auf Tools, Variablen oder Power Fx-Formeln verweisen möchten, geben Sie einen Schrägstrich (/) ein, und wählen Sie die gewünschte Option aus dem daraufhin angezeigten Menü aus.

    Wichtig

    Wenn Sie in Ihren Anweisungen auf vorhandene Tools verweisen, geben Sie an, ob das Tool direkt von Ihrem Haupt-Agent oder nur dann direkt aufgerufen werden soll, wenn er innerhalb von Anweisungen explizit aufgerufen wird. Das Einschränken der Verwendung eines Tools auf explizite Anweisungsverweise trägt dazu bei, Verwirrung zu vermeiden, wenn ähnliche Tools oder Agents vorhanden sind. Wenn Sie beispielsweise über einen Agent namens „Kontostand überprüfen“ und ein ähnliches Tool namens „Kontostand abrufen“ verfügen, beschränken Sie das Tool so, dass es nur von dem Agent aufgerufen wird, um Überlappungen zu vermeiden. Wenn Sie einschränken möchten, dass ein Tool nur dann verfügbar ist, wenn darauf von einem anderen Agent verwiesen wird, deaktivieren Sie die Eigenschaft Den Agent dynamisch entscheiden lassen, wann dieses Tool verwendet werden soll im Abschnitt Zusätzliche Details auf der Detailseite des Tools.

  6. Fügen Sie optional Wissen und Tools hinzu, die nur dieser untergeordnete Agent verwenden kann:

    • Wählen Sie im Abschnitt Wissen die Option Hinzufügen aus, und fahren Sie genauso fort, wie beim Hinzufügen von Wissen zu Ihrem Haupt-Agent.
    • Wählen Sie im Abschnitt Tools die Option Hinzufügen aus, und fahren Sie genauso fort, wie beim Hinzufügen von Tools zu Ihrem Haupt-Agent.
  7. Wenn dieser Agent noch nicht aktiv sein soll, deaktivieren Aktiviert. Sie können Ihren untergeordneten Agenten später aktivieren.

  8. Wählen Sie Speichern aus.

Ein- und Ausgaben verwalten

Standardmäßig erhält ein untergeordneter Agent vom Haupt-Agent eine Aufgabe in natürlicher Sprache, die er ausführen soll, wenn der Agent ihn aufruft. Wenn er die Aufgabe abgeschlossen hat, gibt er in natürlicher Sprache eine Zusammenfassung dessen zurück, was während der Ausführung passiert ist. In einigen Fällen möchten Sie möglicherweise explizitere Eingabe- und Ausgabewerte für den Agent angeben.

So verwalten Sie Eingaben

  1. Wechseln Sie zu den Details des untergeordneten Agents.

  2. Scrollen Sie nach unten zum Abschnitt Eingaben.

  3. Wählen Sie Eingabe hinzufügen aus, um eine Eingabe hinzuzufügen. Definieren Sie einen Anzeigenamen und eine Beschreibung, die dem Agent dabei helfen, den Zweck der Eingabe zu verstehen, sodass er die Eingabe mit einem relevanten Wert ausfüllen kann, wenn dieser Agent aufgerufen wird.

  4. Wählen Sie einen Datentyp aus.

  5. Wählen Sie optional Diese Eingabe erforderlich machen aus, damit die Eingabe einen Wert aufweist, bevor der Agent aufgerufen werden kann.

  6. Wählen Sie Speichern aus.

Anmerkung

Optional können Sie den Abschnitt Erweitert erweitern und andere Einstellungen für die Eingabe konfigurieren, einschließlich der Option Benutzer sollte aufgefordert werden. Wenn die Einstellung aktiviert ist, fragt der Agent den Endbenutzer explizit nach einem Wert für die Eingabe, wenn ein Wert aus dem verfügbaren Kontext nicht gefunden werden kann. Weitere Informationen zu den anderen Einstellungen für Eingaben finden Sie hier.

So verwalten Sie die Liste der Ausgaben

  1. Wechseln Sie zu den Details des untergeordneten Agents.

  2. Scrollen Sie nach unten zum Abschnitt Ausgaben.

  3. Um die aktuelle Liste der Ausgaben anzuzeigen, erweitern Sie den Abschnitt Erweitert im Abschnitt Ausgaben.

  4. Um eine Ausgabe hinzuzufügen, wählen Sie Ausgabe hinzufügen aus. Definieren Sie einen Anzeigenamen und eine Beschreibung, die dem Agent dabei helfen, den Zweck der Ausgabe zu verstehen, sodass er sie mit einem relevanten Wert ausfüllen kann, wenn Werte zum aufrufenden Agent zurückgegeben werden.

  5. Wählen Sie einen Datentyp aus.

  6. Wählen Sie Speichern aus.

Im Abschnitt Ausgaben können Sie auch auswählen, dass eine Nachricht unmittelbar nach Abschluss des untergeordneten Agents an den Benutzer gesendet werden soll. Wenn Sie die Nachricht senden möchten, ändern Sie die Auswahl Nach der Ausführung.

Bestimmen, wann Ihr Agent verwendet werden soll

Standardmäßig reagieren untergeordnete Agents auf eine Benutzerabfrage basierend auf ihrer Beschreibung. Sie können unter Wann wird dies verwendet? untergeordnete Agents auch so konfigurieren, dass sie andere Ereignisse abfangen und darauf reagieren.

Ereignis Eigenschaft
Es wird eine Nachricht empfangen Wird aufgerufen, wenn eine Nachrichtenaktivität – die häufigste Art von Aktivität – empfangen wird. Wird empfangen, wenn ein Benutzer etwas eingibt oder zum Agent sagt. Standardmäßig antwortet der Agent auf beliebige Nachrichten. Verwenden Sie die Liste Aktivitätstyp unter Zusätzliche Details, um die Agent-Antwort auf einen bestimmten Nachrichtentyp zu beschränken.
Es wird ein benutzerdefiniertes Client-Ereignis ausgeführt Wird aufgerufen, wenn eine Ereignis-Aktivität empfangen wird. Standardmäßig antwortet der Agent auf beliebige Ereignisse. Um die Agent-Antwort auf ein bestimmtes Ereignis zu beschränken, verwenden Sie die Eigenschaft Ereignisname unter Zusätzliche Details.
Es wird eine Aktivität ausgeführt Wird aufgerufen, wenn ein beliebiger Aktivitätstyp empfangen wird. Verwenden Sie die Liste Aktivitätstyp unter Zusätzliche Details, um die Agent-Antwort auf einen bestimmten Aktivitätstyp zu beschränken.
Unterhaltung ändert sich Wird aufgerufen, wenn eine Unterhaltungsaktualisierungs-Aktivität empfangen wird. Beispielsweise sendet Teams eine Aktivität dieses Typs, wenn ein Benutzer einer Unterhaltung beitritt.
Wurde aufgerufen Wird aufgerufen, wenn eine Aufruf-Aktivität empfangen wird. Wird am häufigsten aus dem Teams-Kanal empfangenen, z. B. wenn der Benutzende mit einer Nachricht oder Sucherweiterung in Teams interagiert.
Wird weitergeleitet zu Wird aufgerufen, wenn der Agent explizit innerhalb eines Themas aufgerufen wird.
Benutzer ist seit einer Weile inaktiv Wird aufgerufen, wenn der Benutzer nach einem konfigurierten Zeitraum nicht mit dem Haupt-Agent interagiert hat. Wählen Sie den gewünschten Inaktivitätsschwellenwert aus der Liste Inaktivitätsdauer unter Zusätzliche Details aus.
Ein Plan wird abgeschlossen Wird aufgerufen, wenn der Haupt-Agent die Ausführung aller geplanten Schritte abgeschlossen hat, um auf eine Benutzerabfrage oder einen autonomen Trigger zu reagieren.
Eine KI-generierte Antwort wird in Kürze gesendet Wird aufgerufen, wenn der Haupt-Agent eine Antwort für einen Benutzer generiert, nachdem ein oder mehrere Themen, Tools oder Wissensquellen aufgerufen wurden. Verwenden Sie die Systemvariable Response.FormattedText, um die generierte Antwort anzuzeigen. Legen Sie die Variable ContinueResponse auf „false“ fest, wenn Sie verhindern möchten, dass die Orchestrierungsantwort gesendet wird (das heißt, wenn Sie die Nachricht ändern und ihre eigene mit einem Nachrichten-Knoten senden).

Sonstige Details

Je nach Ihrer Auswahl für Wann wird dies verwendet? sind möglicherweise weitere Eigenschaften verfügbar. Die folgenden Eigenschaften sind immer verfügbar.

Bedingung

Geben Sie Bedingungen an, die erfüllt werden müssen, damit der Agent aufgerufen werden kann. Sie möchten z. B., dass der Agent nur aufgerufen wird, wenn der von einem Mitarbeitenden verwendete Kanal Microsoft Teams ist.

Screenshot einer Bedingung, um den Umfang eines untergeordneten Agenten auf den Microsoft Teams-Kanal zu beschränken.

Wenn Sie komplexere Bedingungen benötigen, können Sie in den Power Fx Formeleditor wechseln: Wählen Sie Builder und dann Formel auswählen.

Screenshot mit der Option, zum Formeleditor zu wechseln.

Priorität

Für eine einzelne eingehende Aktivität, beispielsweise eine Nachricht, können mehrere Agenten ausgelöst werden. Standardmäßig bestimmt die Option, die Sie für Wann wird dies verwendet? auswählen, in welcher Reihenfolge die Agenten ausgewählt werden.

Untergeordnete Agenten und Themenbereiche nutzen denselben Satz an Triggern oder Ereignissen, auf die sie reagieren können. Wenn ein Agent und ein Thema so konfiguriert sind, dass er bzw. es auf dasselbe Ereignis reagiert, z. B. Benutzerinaktivität, verwenden Sie die Prioritätseigenschaft, um zu bestimmen, welche zuerst kommt.

Reihenfolge der Ausführung:

  1. Es wird eine Aktivität ausgeführt
  2. Es wird eine Nachricht empfangen / Es wird ein benutzerdefiniertes Client-Ereignis ausgeführt / Unterhaltung ändert sich / Wurde aufgerufen
  3. Der Agent wählt

Wenn mehrere Agents oder Themen basierend auf demselben Ereignistyp aufgerufen werden müssen, werden sie in der Reihenfolge der Erstellung aufgerufen (älteste zuerst).

Sie können die Eigenschaft Priorität explizit festlegen. Eine niedrigere Zahl weist auf eine höhere Priorität hin.