Fügen Sie einen Foundry-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 bestehenden Microsoft Foundry-Agenten verbinden können, damit Ihr Hauptagent Aufgaben an ihn übergeben kann.

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. Informationen zum Verbinden eines entfernten Agenten über das Agent2Agent-(A2A)-Protokoll finden Sie unter Hinzufügen eines A2A-Agenten als verbundenen Agenten. Informationen zum Verbinden eines mit dem Microsoft 365 Agents SDK erstellten Agenten finden Sie unter Einen mit dem Microsoft 365 Agents SDK erstellten Agenten als verbundenen Agenten hinzufügen.

Prerequisites

• Ein Agent, der mit dem GitHub Copilot-Harness erstellt wurde, um als primärer Agent zu fungieren. Siehe Agent erstellen (Vorschauversion).
• Ein bestehender Foundry-Agent, der in einem Projekt im Microsoft Foundry-Portal erstellt wurde, mit aktiviertem Activity-Protokoll und der verfügbaren Agent-ID des Agenten. Foundry-Agenten haben das Activity-Protokoll standardmäßig nicht aktiviert. Siehe Aktivieren des Aktivitätsprotokolls bei Ihrem Foundry-Agenten.
• Die Azure AI Project-Endpunkt-URL für das Projekt, das den Foundry-Agenten hostet.
• Erlaubnis für den Zugriff auf das Foundry-Projekt. Die Verbindung authentifiziert sich mit Ihrem Microsoft Entra ID-Benutzer-Login.

Fügen Sie einen Foundry-Agenten hinzu

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 Dialog wählen Sie Hinzufügen und dann Foundry Agent hinzufügen.

6. Im Schritt Connect to Azure AI Foundry wählen Sie die Verbindung aus, die dieser Agent verwendet, um Microsoft Foundry zu erreichen:

   • Wählen Sie eine bestehende Verbindung aus der Verbindungsliste aus.
   • Wenn keine Verbindung verfügbar ist, wählen Sie Neue Verbindung erstellen und fahren Sie mit dem nächsten Schritt fort.

7. Wenn Sie eine neue Verbindung erstellen, geben Sie die Verbindungsdetails ein und wählen Sie dann Erstellen:

   • Anzeigename (optional): Ein Name, der dir hilft, diese Verbindung später zu identifizieren.
   • Authentifizierungstyp: Microsoft Entra ID Benutzeranmeldung. Dieser Wert ist für Sie festgelegt.
   • Azure AI Project Endpoint: die Endpunkt-URL des Foundry-Projekts, das den Agenten hostet.

8. Zurück im Schritt Connect to Azure AI Foundry , bestätigen Sie, dass Ihre Verbindung ausgewählt ist, und wählen Sie dann Weiter aus.

9. Im Schritt Überprüfen und hinzufügen geben Sie die Daten des Foundry-Agenten ein, den Sie hinzufügen möchten, und wählen Sie dann Dem Agenten hinzufügen:

   • Name: Der Name, der dem Agent-Ersteller angezeigt wird.
   • Beschreibung: Eine klare Beschreibung, wann dieser Foundry-Agent eingesetzt werden sollte. Der Orchestrator verwendet diese Beschreibung, um zu entscheiden, wann eine Anfrage an den Agenten weitergeleitet wird. Formulieren Sie sie daher konkret und vermeiden Sie Überschneidungen mit Ihren anderen Tools und Agenten. Weitere Informationen finden Sie unter Schreiben effektiver Metadaten.
   • Agenten-ID: Die ID des Foundry-Agenten, mit dem Sie sich verbinden möchten.

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

Aktivieren Sie das Activity-Protokoll auf Ihrem Foundry-Agenten

Copilot Studio kommuniziert mit einem verbundenen Foundry-Agenten über das Activity-Protokoll. Foundry-Agenten haben dieses Protokoll standardmäßig nicht aktiviert, daher musst du es aktivieren, bevor dein Hauptagent Nachrichten mit dem Foundry-Agenten austauschen kann. Wenn das Activity-Protokoll nicht aktiviert ist, kannst du die Verbindung trotzdem hinzufügen, aber der Aufruf des Foundry-Agenten schlägt fehl.

Du kannst das Activity-Protokoll auf eine der folgenden Arten aktivieren:

• Veröffentlichen Sie den Foundry-Agenten für Microsoft 365 oder Microsoft Teams. Wenn Sie einen Prompt-Agenten in Microsoft 365 oder Teams veröffentlichen, werden das Activity-Protokoll und das erforderliche BotServiceRbac Autorisierungsschema automatisch aktiviert. Wählen Sie diese Option, wenn Sie bereits planen, den Agenten auf diesen Kanälen zu veröffentlichen.

• Aktiviere es manuell mit einem REST-API-Aufruf. Wenn du den Agenten nicht in Microsoft 365 oder Teams veröffentlichst, rufe die Foundry Agents - Update Agent REST API auf, um das activity Protokoll und das BotServiceRbac Autorisierungsschema zum Agenten hinzuzufügen.

Weitere Informationen zum Konfigurieren und Teilen Ihres Foundry-Agenten finden Sie unter Microsoft Foundry-Agent konfigurieren und freigeben.

Aktivieren Sie das Activity-Protokoll mit einem REST-API-Aufruf

Rufen Sie die Foundry Agents - Update agent REST-API auf. Ersetzen Sie {{endpoint}}, {{agent_name}}, und {{token}} durch den Endpunkt, den Agentennamen und das Zugriffstoken für Ihr Foundry-Projekt.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview

{
    "agent_endpoint": {
        "protocols": [
            "responses",
            "activity"
        ],
        "authorization_schemes": [
            {
                "type": "Entra",
                "isolation_key_source": {
                    "kind": "Entra"
                }
            },
            {
                "type": "BotServiceRbac"
            }
        ]
    }
}

Wie der Orchestrator zum Foundry-Agenten weiterleitet

Nachdem du den Foundry-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 Foundry-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 Foundry-Agenten übereinstimmt.

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

4. Senden Sie eine Nachricht außerhalb der Domain des Foundry-Agenten, um zu bestätigen, dass Ihr Hauptagent sie bearbeitet.

Wenn du später die Agenten-ID oder Beschreibung ändern musst, bearbeite den verbundenen Agenten im Components-Panel. Siehe Verbundene Agenten in einem Agenten verwalten.

Zugeordnete Informationen

• Überblick über verbundene Agenten
• Fügen Sie einen Copilot Studio-Agenten als verbundenen Agenten hinzu
• Fügen Sie einen A2A-Agenten als verbundenen Agenten hinzu
• Fügen Sie einen Microsoft 365 Agents SDK-Agenten als verbundenen Agenten hinzu
• Verbundene Agents innerhalb eines Agents verwalten
• Baue einen Agenten auf
• Konfigurieren und teilen Sie Ihren Microsoft Foundry-Agenten
• Was ist Microsoft Foundry Agent Service?