Herstellen einer Verbindung mit anderen Agents über einen deklarativen Agent

Wenn Benutzer mit einem deklarativen Agent in Microsoft 365 Copilot Chat interagieren, kann dieser eine Verbindung mit anderen Agents herstellen, um zusätzliche Informationen abzurufen oder Aktionen auszuführen. Sie deklarieren diese Verbindungen im Manifest des Agents, indem Sie die Titel-IDs des Agents in der worker_agents Eigenschaft auflisten. Zur Laufzeit fungiert Copilot Chat als der Vermittler, der die Interaktion vermittelt. Benutzer sehen den Austausch zwischen Agenten, müssen aber die verbundenen Agenten nicht selbst auswählen.

Hinweis

Manifestdeklarierte verbundene Agents sind ein von der Copilot Chat-API getrennter Mechanismus, der Konversationserlebnisse ermöglicht, die von Microsoft 365 Copilot in Ihren eigenen benutzerdefinierten Anwendungen unterstützt werden.

Hinweis

Benutzer müssen jeden verbundenen Agent erwerben, bevor sie sie verwenden können. Weitere Informationen finden Sie unter Bereitstellen verbundener Agents für Benutzer in der organization.

Wenn ein Benutzer mit einem deklarativen Agent interagiert, kann der Agent einen Teil der Aufgabe an einen verbundenen Agent delegieren. Microsoft 365 Copilot wertet die im Manifest deklarierten verbundenen Agents aus und wählt einen basierend auf der aktuellen Aufgabe und dem Namen, der Beschreibung und den Beispielaufforderungen des verbundenen Agents aus. Copilot sendet eine Textanforderung an den ausgewählten verbundenen Agent, empfängt eine Textantwort und integriert diese Antwort in die laufende Interaktion des deklarativen Agenten mit dem Benutzer.

Wann sollten verbundene Agents verwendet werden?

Verwenden Sie verbundene Agents, um Agenten funktions- oder entwicklungsteamübergreifend aufzuteilen oder zu kombinieren.

Erweitern Sie über das hinaus, was ein einzelner Agent erreichen kann

Große Sprachmodelle (LLMs) verfügen über ein begrenztes nützliches Kontextfenster und einen begrenzten Satz von Funktionen. Die Zuverlässigkeit eines einzelnen LLM-Agents nimmt ab, wenn mehr Dokumente abgerufen oder Tools aktiviert werden. Wenn ein Agent nach dem Hinzufügen von mehr Wissen oder Fähigkeiten eine geringere Qualität aufweist, teilen Sie einige dieser Funktionen in einen anderen Agenten auf und stellen Sie eine Verbindung mit ihm her. Der vorhandene Agent sendet nur die Informationen über die Aufgabe, die der verbundene Agent benötigt, um seinen Teil zu erfüllen. Der verbundene Agent arbeitet in einem eigenen Kontextfenster, frei von anderen Dokumenten oder Funktionen, die sich in der Benutzerkonversation befinden.

Integration mit extern entwickelten Agents

Deklarative Agents können die Zusammenarbeit mit anderen Entwicklungsteams erleichtern. Jedes Entwicklungsteam kann sich auf die Fähigkeiten und die Qualität seines Agents konzentrieren und mithilfe von verbundenen Agents andere Agents integrieren. Wie bei Microservices kann jeder Agent entwickelt werden, ohne andere Agenten zu beeinträchtigen. Im Gegensatz zu Microservices können Agenten auch dann weiter miteinander interagieren, wenn sich ihre Schnittstellen ändern.

Gemeinsame Nutzung von Agent-Funktionen für mehrere Szenarien

Ein Agent kann mit einer Reihe von Dokumenten und Aktionen gut funktionieren, aber für Benutzer immer noch schwierig sein. Stellen Sie sich einen Agenten vor, der die Tabellen und Daten einer relationalen Datenbank mit Kunden und Verkäufen versteht. Dieser Agent kann sowohl für Filialleiter zur Verwaltung des Inventars als auch für Business-Analysten zur Berichterstattung an Führungskräfte nützlich sein. Wenn dieser Agent mit einem Agenten verbunden werden könnte, der auf Filialleiter mit Gesprächsanfängen und Anweisungen zugeschnitten ist, und auch mit einem Agenten, der auf Business-Analysten zugeschnitten ist. Beide Benutzertypen können mehr Nutzen aus der Verwendung von Agents ziehen, die auf ihr Szenario zugeschnitten sind.

Aktivieren verbundener Agents

Sie müssen verbundene Agents in der Registrierung des Microsoft Agent 365-Agents registrieren. Stellen Sie eine Verbindung zu anderen Agents her, indem Sie die Titel-IDs der Agenten in das Manifest des vorhandenen deklarativen Agents einschließen. Der andere Agent muss ein deklarativer Agent sein oder über eine registrierte Agent2Agent-Agenten-Karte verfügen.

Rufen Sie zunächst die Titel-ID des Agent ab, mit dem eine Verbindung hergestellt werden soll. Die Titel-ID eines Agenten ist eine Zeichenfolge aus einem einzelnen Buchstaben, einem Unterstrich und einer GUID. Einen deklarativen Agent finden Sie in der Ausgabe des Befehls "Bereitstellen " im Microsoft 365 Agents Toolkit oder im Entwicklermodus. Für eine Microsoft 365 Agent-Registrierung ist es die id Eigenschaft des agentRegistration-Objekts.

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die Titel-ID anzeigen

Fügen Sie die Titel-ID der worker_agents-Eigenschaft als .id Die worker_agents Eigenschaft wurde in Version 1.6 des deklarativen Agent-Schemas hinzugefügt.

Authentifizierung und Autorisierung

Die Verbindung mit einem deklarativen Agent basiert auf der vorhandenen Authentifizierung des Benutzers bei Microsoft 365 Copilot, da der deklarative Agent innerhalb von Microsoft 365 Copilot Chat ausgeführt wird. Für externe Agents, die in Microsoft Agent 365 registriert sind, muss bei der Agent-Registrierung angegeben werden, wie sich Microsoft 365 Copilot beim externen Agent authentifiziert. Anstatt die Authentifizierungskonfiguration direkt in die Agent-Registrierung einzubetten, verweist die Registrierung auf eine vorhandene Authentifizierungsregistrierung über das authorization Objekt in der agentRegistration. Durch diese Trennung kann die Authentifizierungskonfiguration unabhängig von den Agent-Definitionen verwaltet werden. Das Design spiegelt das von API-Plug-In-Manifesten wider.

Syntax

{
  "type": "None | OAuthPluginVault",
  "referenceId": "{string}"
}

Die type Eigenschaft gibt das Authentifizierungsschema an, das vom externen Agent verwendet wird. OAuthPluginVaultverwendet eine Microsoft Entra SSO-Registrierung. Das referenceId ist der Wert, der Microsoft Entra SSO registration ID im Teams-Entwicklerportal generiert wird. Weitere Informationen finden Sie unter Verwenden des Teams-Entwicklerportals .

Ob ein Benutzer den verbundenen Agent verwenden kann, wird getrennt von der Authentifizierung festgelegt. Benutzer müssen Zugriff auf den verbundenen Agent haben, entweder durch Erwerb selbst oder durch Administratorbereitstellung. Administratoren müssen externe Agents installieren, die in Microsoft Agent 365 für den Benutzer registriert sind.

Bewährte Methoden

Deklarative Agents wählen basierend auf den Eingabeaufforderungen namedescriptiondes verbundenen Agents und Beispielen aus, mit welchen Agents eine Verbindung hergestellt werden soll. Bei einem deklarativen Agenten sind Beispieleingabeaufforderungen das text Feld von conversation_starters im Manifest. Bei einer agentRegistration ist es die examples Eigenschaft des AgentSkill Objekts in der Agenten-Karte. Die Beschreibung des Agenten sollte sowohl für Menschen als auch für Agenten beschreiben, was der Agent tun kann. Betrachten Sie diese Beschreibung beispielsweise für einen Agenten, der mit strukturierten Daten über Videospielverkäufe arbeitet.

A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.

Beispielprompts sollten sowohl Benutzer als auch Agents darüber informieren, welche Arten von Prompts der Agent verarbeiten kann. Da Benutzer möglicherweise unterschiedliche Begriffe für dasselbe Konzept verwenden, sollten Sie die Formulierung der Gesprächsstarter variieren. Wenn Sie z. B. mit Rechtsfällen arbeiten, könnten gute Gesprächsstarter auch die Begriffe "Angelegenheit", "Fall", "Kunde" und "Problem" verwenden. Nur das text Feld eines Unterhaltungsbeginns wird von verbundenen Agents verwendet.

Beschränkungen

  • Der aktive Agent sendet Text nur an einen verbundenen Agenten. Deklarative Agents geben Text oder Adaptive Karten zurück. Agenten mit Agent2Agent-Karten geben Text, Base64-Bildbinärdateien und Base64-Dateibinärdateien zurück.

  • Während der Benutzer aufgefordert wird, API-Plugin-Aufrufe des verbundenen Agenten zu bestätigen, werden alle adaptiven Karten an den aktiven Agenten gesendet. Dem Benutzer wird die adaptive Karte nicht angezeigt oder er kann kein Dialogfeld verwenden. Der Wirkstoff verarbeitet jedoch den Dateninhalt der adaptiven Karte.