Fügen Sie einen Agent2Agent (A2A)-Agenten als verbundenen Agenten hinzu (GitHub Copilot)

Nutzen Sie verbundene Agents, damit Ihr primärer Agent bestimmte Aufgaben an spezialisierte Agents delegieren kann. Dieser Artikel zeigt Ihnen, wie Sie einen Remote-Agenten verbinden, der über das Agent2Agent (A2A)-Protokoll verfügbar ist, damit Ihr Hauptagent Aufgaben an ihn übergeben kann.

Das A2A-Protokoll ist ein offener Standard für Kommunikation und Zusammenarbeit zwischen Agenten. Da es ein offener Standard ist, kannst du Agenten verbinden, die außerhalb des Copilot Studio gehostet und auf anderen Frameworks basieren, solange sie A2A implementieren. Copilot Studio entdeckt den entfernten Agenten von seiner Agentenkarte und verwendet dann das A2A-Protokoll, um Aufgaben zur Laufzeit an ihn zu delegieren.

Du fügst jeden verbundenen Agenten aus demselben Dialog „Verbundenen Agenten hinzufügen“ hinzu. Für einen Überblick über verbundene Agenten und wie Routing funktioniert, siehe Überblick über verbundene Agenten. Um einen weiteren Copilot Studio-Agenten zu verbinden, siehe Hinzufügen eines Copilot Studio-Agenten als verbundenen Agenten. Um einen Microsoft Foundry-Agenten zu verbinden, siehe Hinzufügen eines Foundry-Agenten als verbundenen Agenten.

Prerequisites

• Ein Agent, der mit dem GitHub Copilot-Harness erstellt wurde, um als primärer Agent zu fungieren. Siehe Agent erstellen (Vorschauversion).
• Ein Remote-Agent, der das Agent-to-Agent-Protokoll implementiert und vom Copilot Studio über das öffentliche Internet erreichbar ist.
• Die URL der Agentenkarte des entfernten Agenten, typischerweise https://<your-agent-host>/.well-known/agent-card.json.
• Die Authentifizierungsdetails, die der Remote-Agent ggf. benötigt. Copilot Studio unterstützt keine Authentifizierung, API-Schlüssel und OAuth 2.0-Authentifizierung.
• Für OAuth 2.0 ist die Berechtigung erforderlich, eine Weiterleitungs-URI zur App-Registrierung hinzuzufügen, die der Identitätsanbieter des entfernten Agenten verwendet. Copilot Studio generiert die Weiterleitungs-URL während des Wizards, und Sie müssen sie registrieren, bevor Sie die Verbindung herstellen.

Fügen Sie einen Agent2Agent (A2A)-Agenten hinzu

Der Assistent führt dich je nach gewählter Authentifizierungsmethode durch drei oder vier Schritte:

• Wenn Sie None oder API-Schlüssel wählen: Verbinden Sie sich mit einem A2A-Agenten, verbinden Sie sich mit dem A2A-Agenten, dann überprüfen und hinzufügen.
• Wenn Sie OAuth 2.0 wählen: Verbinden Sie sich mit einem A2A-Agenten, fügen Sie eine Weiterleitungs-URL hinzu, verbinden Sie sich mit dem A2A-Agenten und dann überprüfen und hinzufügen.

1. Melden Sie sich bei Copilot Studio an.

2. Wählen und öffnen Sie den Agent, den Sie als primären Agent verwenden möchten.

3. Wählen Sie in der Agenten-Navigationsleiste den Reiter "Bauen " aus.

4. Wählen Sie im Komponentenbereich Verbundene Agents aus, um den Dialog Verbundenen Agent hinzufügen zu öffnen.

5. Im Dialogfeld wählen Sie Hinzufügen und dann A2A-Agent hinzufügen.

6. Im Schritt Mit einem A2A-Agenten verbinden geben Sie die Daten des entfernten Agenten ein:

   • Agentenkarten-URL: die URL der Agentenkarte des entfernten Agenten, zum Beispiel https://agent.example.com/.well-known/agent-card.json. Copilot Studio liest die Karte, um den Endpunkt und die Fähigkeiten des Agenten zu entdecken.
   • Name: der Name, der dem Autor des Agenten angezeigt wird. Wenn die Agentenkarte einen Namen enthält, füllt Copilot Studio dieses Feld für Sie aus.
   • Beschreibung: eine klare Beschreibung, wann dieser A2A-Agent verwendet werden soll, mit einer Länge von 30 bis 1.000 Zeichen. Wenn die Agentenkarte eine Beschreibung enthält, füllt Copilot Studio dieses Feld für dich aus. Der Orchestrator verwendet diese Beschreibung, um zu entscheiden, wann eine Anfrage an den Agenten weitergeleitet wird, also mach sie konkret und vermeide Überschneidungen mit deinen anderen Tools und Agenten. Erfahren Sie mehr über das Schreiben effektiver Metadaten.

   Hinweis

   Wenn Name und Beschreibung nicht automatisch ausgefüllt werden, hat der Remote-Agent möglicherweise keine Agentenkarte, die Karte befindet sich auf einer anderen URL als der von Ihnen eingegebenen oder Copilot Studio kann sie möglicherweise nicht erreichen. Überprüfe zuerst die URL und versuche, die Agentenkarte in deinem Browser zu öffnen. Wenn die Karte nicht verfügbar ist, geben Sie einen Namen und eine Beschreibung manuell ein.

7. Wählen Sie unter Authentifizierung aus, wie Copilot Studio sich mit dem entfernten Agenten authentifiziert, und füllen Sie dann die Details für die gewählte Methode aus:

   • Keine: Der entfernte Agent benötigt keine Authentifizierung.
   • API-Schlüssel: Der entfernte Agent benötigt einen API-Schlüssel. Siehe API-Schlüssel-Authentifizierung konfigurieren.
   • OAuth 2.0: Der entfernte Agent verwendet OAuth 2.0. Siehe OAuth 2.0 Authentifizierung konfigurieren.

   Du kannst nicht weitermachen, bis die Authentifizierungsdetails vollständig sind.

8. Wählen Sie Weiter aus.

9. Wenn Sie OAuth 2.0 ausgewählt haben, erscheint der Schritt Weiterleitungs-URL hinzufügen. Copilot Studio erstellt den Connector für den A2A-Agenten, und die Plattform erzeugt eine Weiterleitungs-URL dafür. Registrieren Sie diese URL bei Ihrem Identitätsanbieter, bevor Sie die Verbindung herstellen:

   1. Warte, bis das Feld für die Weiterleitungs-URL ausgefüllt ist. Der Connector muss existieren, bevor die URL generiert wird.
   2. Wählen Sie die Kopier-Schaltfläche neben dem Feld, um die URL zu kopieren.
   3. Füge in deiner OAuth-App-Registrierung die URL als Redirect-URI hinzu und speichere die App-Registrierung.
   4. Wählen Sie Weiter aus.

   Important

   Wenn Sie die Weiterleitungs-URL nicht zuerst registrieren, schlägt der erste Versuch, die Verbindung zu autorisieren, fehl. Die Weiterleitungs-URL wird pro Connector generiert, daher ist sie spezifisch für diesen A2A-Agenten und kann nicht von einem anderen Connector wiederverwendet werden. Wenn du die URL später erneut brauchst, wähle den A2A-Agenten unter Connected agents im Components-Panel aus, um ihn erneut zu öffnen.

10. Im Schritt Connect to the A2A Agent wählen Sie die Verbindung aus, die dieser Agent verwendet, um den entfernten Agenten zu erreichen:

    • Wählen Sie eine bestehende Verbindung aus der Liste der verfügbaren Verbindungen aus.
    • Wenn keine Verbindung verfügbar ist, erstellen Sie eine neue Verbindung. Wenn der entfernte Agent API-Schlüssel-Authentifizierung verwendet, geben Sie den API-Schlüsselwert ein, wenn Sie die Verbindung herstellen.

11. Wählen Sie Weiter aus.

12. Im Schritt „Überprüfen und hinzufügen“ überprüfen Sie den Namen, die Beschreibung und die URL der Agentenkarte und wählen Sie dann „Dem Agenten hinzufügen“ aus.

13. Bestätigen Sie, dass der verbundene Agent im Komponentenpanel unter "Verbundene Agenten " erscheint.

Wenn du zurückgehst und die Authentifizierungseinstellungen im Schritt „Verbinden mit einem A2A-Agenten“ änderst, verwirft Copilot Studio den Connector, der aus den vorherigen Einstellungen gebaut wurde. Du musst eine neue Weiterleitungs-URL registrieren und eine Verbindung erneut auswählen.

Konfigurieren der API-Schlüsselauthentifizierung

Wenn Sie den API-Schlüssel auswählen, wählen Sie, wohin Copilot Studio den Schlüssel sendet, indem Sie einen Parametertyp auswählen:

• Header: Der Schlüssel wird als Anfrage-Header gesendet. Im Header-Name geben Sie den Namen des Headers ein, den der entfernte Agent erwartet, zum Beispiel x-api-key.
• Abfragezeichenfolge: Der Schlüssel wird als Abfrageparameter gesendet. Im Parameter Label geben Sie den Namen des Abfragestring-Parameters ein, den der Remote-Agent erwartet.

Du gibst den API-Schlüsselwert selbst ein, wenn du die Verbindung erstellst, nicht in diesem Schritt. So wird der Schlüssel bei der Verbindung gespeichert und ist in der Agentenkonfiguration nicht sichtbar.

Konfigurieren der OAuth 2.0-Authentifizierung

Wenn Sie OAuth 2.0 auswählen, wählen Sie einen Konfigurationstyp:

• Dynamisch: Copilot Studio registriert einen Client beim Identitätsanbieter des entfernten Agenten für Sie. Geben Sie die Autorisierungs-URL und die Token-URL ein.

• Manuell: Verwenden Sie eine bereits erstellte App-Registrierung beim Identitätsanbieter des entfernten Agenten. Geben Sie die folgenden Werte ein:

  • Client-ID: die Client-ID Ihrer App-Registrierung.
  • Client-Geheimnis: das Client-Geheimnis Ihrer App-Registrierung.
  • Autorisierungs-URL: der Autorisierungsendpunkt des Identitätsanbieters.
  • Token-URL: der Token-Endpunkt des Identitätsanbieters.
  • Refresh-Token-URL: der Endpunkt, der zum Auffrischen von Zugriffstoken verwendet wird.
  • Scopes (optional): die zu anfordernden Scopes, getrennt durch Spaces.

Verwenden Sie Dynamic, wenn der Identitätsanbieter des entfernten Agenten eine dynamische Client-Registrierung unterstützt. Verwenden Sie Manual , wenn Sie die App-Registrierung kontrollieren müssen, zum Beispiel wenn Ihr Identitätsanbieter vorab registrierte Redirect-URIs oder Zustimmung verlangt.

Beide Konfigurationsarten erfordern, dass Sie eine Weiterleitungs-URL bei Ihrem Identitätsanbieter registrieren. Nachdem Sie Nächstes ausgewählt haben, erstellt Copilot Studio den Connector und zeigt die generierte Weiterleitungs-URL im Schritt "Weiterleitungs-URL hinzufügen" an.

Finden Sie später die Weiterleitungs-URL

Wenn du den Assistenten schließt oder die Weiterleitungs-URL verlierst, kannst du sie jederzeit erneut aufrufen:

1. Im Build-Reiter wählen Sie den A2A-Agent unter Connected agents im Komponentenpanel aus.

2. Im Dialog A2A-Agent bearbeiten kopieren Sie den Wert im Feld Redirect-URL .

Das Redirect-URL-Feld erscheint nur für A2A-Agenten, die OAuth 2.0 verwenden.

Wie der Orchestrator an den A2A-Agenten weiterleitet

Nachdem du den A2A-Agenten hinzugefügt hast, bestimmt die Orchestrierungslaufzeit automatisch, wann an ihn delegiert werden soll. Die Routing-Entscheidung basiert auf:

• Der Name und die Beschreibung des verbundenen Agenten
• Die Nachricht des Benutzers und der Unterhaltungskontext
• Die Anweisungen Ihres primären Agents

Testdelegierung

Nachdem du den A2A-Agenten hinzugefügt hast:

1. Wählen Sie in der linken Navigationsleiste des Agents die Registerkarte Vorschau aus.

2. Senden Sie eine Nachricht, die mit der Domain des A2A-Agenten übereinstimmt.

3. Überprüfen Sie, ob die Antwort vom A2A-Agenten kommt und angemessen ist.

4. Senden Sie eine Nachricht außerhalb der Domäne des A2A-Agenten, um zu bestätigen, dass Ihr Hauptagent dies übernimmt.

Wenn du später den Namen oder die Beschreibung ändern musst, bearbeite den verbundenen Agent aus dem Komponentenpanel. Informationen unter Verbundene Agenten in einem Agenten verwalten.

Beheben von Verbindungsproblemen

Zugeordnete Informationen

• Überblick über verbundene Agenten
• Fügen Sie einen Copilot Studio-Agenten als verbundenen Agenten hinzu
• Fügen Sie einen Foundry-Agenten als verbundenen Agenten hinzu
• Verbundene Agents innerhalb eines Agents verwalten
• Baue einen Agenten auf
• Agent2Agent (A2A)-Protokoll