Verbindung zu einem Microsoft Foundry-Agent herstellen (Vorschauversion)

[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]

Sie können einen Microsoft Foundry-Agent mit Ihrem benutzerdefinierten Agent verbinden, sodass er diesen Agent aufrufen kann, um auf einen Benutzer oder Trigger zu reagieren.

Voraussetzungen

Bevor Sie einen Microsoft Foundry-Agenten mit Copilot Studio verbinden, muss der Foundry-Agent den Activity-Protokoll-Endpunkt aktiviert haben. Ein neu erstellter Foundry-Agent stellt standardmäßig nur die Endpunkte des Responses und A2A-Protokolls frei. Wenn der Activity-Endpunkt nicht aktiviert ist, scheitert die Verbindung zu Copilot Studio zur Laufzeit mit einem 400-Fehler. Erfahren Sie mehr unter Enable incoming A2A bei einem Foundry-Agenten.

Du kannst den Activity-Endpunkt derzeit nur programmatisch aktivieren, indem du die REST-API oder das Python SDK verwendest. Es gibt keine Option, es über das Microsoft Foundry-Portal zu aktivieren. Erfahren Sie mehr über das Enablement-Verfahren in "Konfigurieren und teilen Sie Ihren Agenten".

Nachdem du den Activity-Endpunkt aktiviert hast, zeigt der Endpunkt-Bereich des Foundry-Portals für den Agenten weiterhin nur Antworten und A2A an. Dieses Fehlen der Benutzeroberfläche ist zu erwarten und bedeutet nicht, dass die Änderung fehlgeschlagen ist. Die Verbindung zum Copilot Studio funktioniert nach der Aktualisierung.

Eine Verbindung zu einem Microsoft Foundry-Agent herstellen

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

2. Wählen Sie unter Mit einem externen Agent verbinden die Option Microsoft Foundry aus den verfügbaren Agent-Typen aus.

3. Wählen Sie die gewünschte Verbindung aus der Liste der verfügbaren Verbindungen aus, oder erstellen Sie eine neue Verbindung zwischen Microsoft Foundry und Ihrem Copilot Studio-Agent. Um eine neue Verbindung zu erstellen, müssen Sie die Endpunkt-URL des Foundry-Projekts angeben.

   Note

   Beim Herstellen einer Verbindung mit Microsoft Foundry-Agents aus Copilot Studio können Sie nur eine Verbindung mit Agents herstellen, die im neuen Microsoft Foundry-Portal erstellt wurden. Die Verbindung mit einem im vorherigen Portal erstellten Agenten führt zu einem Fehler, der auf 404 - Version not found hinweist.

4. Nachdem die Verbindung erstellt wurde, wählen Sie Weiter aus.

5. Geben Sie einen geeigneten Namen und eine Beschreibung für Ihren SDK-Agent ein. Die Beschreibung sollte den Zweck Ihres Microsoft Foundry-Agents beschreiben, sodass Ihr Haupt-Agent verstehen kann, wann er verwendet werden sollte. Weitere Informationen finden Sie unter Schreiben effektiver Metadaten.

6. Geben Sie die Agent-ID für den Microsoft Foundry-Agent ein, mit dem Sie eine Verbindung herstellen möchten.

7. Passe die Beschreibung (falls nötig) an, um sie kontextabhängiger für den Hauptagenten zu machen. Sie sollten z. B. die Beschreibung präzisieren, wenn Sie über andere Tools oder Agents verfügen, deren Beschreibungen sich möglicherweise überschneiden. Aktualisieren Sie die Beschreibung, damit Copilot Studio versteht, wann dieser Agent aufgerufen werden soll.

8. Wählen Sie Agent hinzufügen aus.

9. Nachdem der Agent erstellt wurde, können Sie ihn sofort testen. Wenn Sie die Agent-ID später anpassen müssen, können Sie dies über die Detailseite tun, indem Sie Ihren Agent aus der Liste Agents auswählen.