Freigeben über

Konvertieren Ihres deklarativen Agents in einen benutzerdefinierten Engine-Agent

Microsoft 365 Copilot bietet eine Migrationsfunktion, mit der Sie deklarative Agents, einschließlich Nachrichtenerweiterungen, die zu deklarativen Agents heraufgestuft wurden, in benutzerdefinierte Engine-Agents konvertieren können. Wenn Sie Ihren deklarativen Agent in einen benutzerdefinierten Engine-Agent konvertieren, haben Sie die vollständige Kontrolle über die Orchestrierung, KI-Modelle und Datenintegrationen und können erweiterte Funktionen nutzen, um komplexere Workflows zu erstellen.

In diesem Artikel werden die Schritte beschrieben, die Sie ausführen müssen, um einen deklarativen Agent in einen benutzerdefinierten Engine-Agent zu konvertieren, um ihre eigene Orchestrierung zu nutzen, um die individuellen Anforderungen Ihrer organization besser zu erfüllen.

Voraussetzungen

Für die Schritte in diesem Artikel sind die folgenden Voraussetzungen erforderlich:

  • Ein vorhandener deklarativer Agent, der mit dem Microsoft 365 Agents Toolkit erstellt wurde.

    Hinweis

    Agents, die mit Microsoft 365 Copilot erstellt wurden, werden derzeit nicht unterstützt.

  • Ein benutzerdefinierter Bot und die Bot-ID. Informationen zum Erstellen eines benutzerdefinierten Bots finden Sie unter Bots und Agents.

  • Visual Studio Code mit installierter Microsoft 365 Agents Toolkit-Erweiterung.

  • Das Microsoft 365 Agents SDK oder Teams SDK, wenn Sie Copilot-spezifische Features wie Streaming oder Zitate implementieren möchten.

  • Berechtigungen zum Hochladen von App-Manifesten in Ihrer Umgebung.

Konvertieren Des deklarativen Agents

Um Ihren vorhandenen deklarativen Agent in einen benutzerdefinierten Engine-Agent zu konvertieren, nehmen Sie Aktualisierungen an Ihrem App-Manifest und Ihrem App-Paket vor.

Aktualisieren Ihres App-Manifests

So aktualisieren Sie Ihr App-Manifest:

  1. Öffnen Sie in Visual Studio Code die App-Manifestdatei für Ihren deklarativen Agent.

  2. Fügen Sie einen Bots-Knoten hinzu, und fügen Sie Ihre Bot-ID in das Feld id ein. Das folgende Beispiel zeigt das Schema für den Botknoten .

        "bots": [ 
        { 
            "botId": "${{BOT_ID}}", 
            "scopes": [ 
                "copilot", 
                "personal", 
                "team" 
            ], 
            "supportsFiles": false, 
            "isNotificationOnly": false, 
            "commandLists": [ 
                { 
                    "scopes": [ 
                        "copilot", 
                        "personal" 
                    ], 
                    "commands": [ 
                        { 
                            "title": "How can you help me?", 
                            "description": "How can you help me?" 
                        } 
                    ] 
                } 
            ] 
        } 
    ],

    Weitere Informationen zum Schema für den Bots-Knoten finden Sie unter Bots-Objekt.

    Hinweis

    Verwenden Sie app manifest schema version 1.21 oder höher. Benutzerdefinierte Engine-Agents werden in Manifestversion 1.21 und höheren Versionen unterstützt.

  3. Ändern Sie im copilotAgents-Objekt den Knoten declarativeAgents in einen customEngineAgents-Knoten , wie in den folgenden Beispielen gezeigt.

    Knoten "Deklarative Agents"

    "copilotAgents": { 
    "declarativeAgents": [             
        { 
            "id": "declarativeAgent", 
            "file": "declarativeAgent.json" 
        } 
    ] 
},

    Ersetzen durch den Knoten "Benutzerdefinierte Engine-Agents"

    "copilotAgents": {
    "customEngineAgents": [
        {
            "type": "bot",
            "id": "${{BOT_ID}}"
        }
    ]
},
"bots": [
    { 
      "botId": "${{BOT_ID}}",
        "scopes": [
            "copilot",
            "personal",
            "team"
        ], 
        "supportsFiles": false,
        "isNotificationOnly": false,
        "commandLists": [
            {
                "scopes": [
                    "copilot",
                    "personal"
                ],
                "commands": [
                    {
                        "title": "How can you help me?",
                        "description": "How can you help me?"
                    }
                ]
            }
        ]
    }
],

    Schemareferenzinformationen finden Sie unter copilotAgents-Objekt.

    Hinweis

    Ihr App-Manifest kann entweder einen deklarativen Agent-Knoten oder einen benutzerdefinierten Engine-Agent-Knoten enthalten, aber nicht beides.

  4. Aktualisieren Sie die App-Versionsnummer für Ihre App in der Versionseigenschaft .

  5. Stellen Sie sicher, dass die id-Eigenschaft dieselbe ID verwendet, die Sie im App-Manifest für den deklarativen Agent verwendet haben.

Anpassen der Agent-Benutzeroberfläche

Definieren Sie Ihre Agent-Benutzeroberfläche für Benutzer. Sie können Unterhaltungsstarter und vorgeschlagene Eingabeaufforderungen hinzufügen, Streamingantworten und Zitate implementieren und vieles mehr. Beachten Sie, dass Sie die Funktionen des benutzerdefinierten Engine-Agents definieren und testen müssen.

Weitere Informationen finden Sie unter Benutzerdefinierte Engine-Agent-Benutzererfahrungsfeatures.

Aktualisieren und Übermitteln Ihres App-Pakets

Nachdem Sie Ihr Agent-Manifest aktualisiert haben, packen Sie Ihre App neu:

  1. Fügen Sie Das aktualisierte Agent-Manifest, das App-Symbol und alle anderen Ressourcen einer neuen .zip-Datei hinzu.

  2. Übermitteln Sie das neue Paket, um Ihre vorhandene App zu aktualisieren. Wenn Ihr Agent in Ihrem organization intern ist, verwenden Sie die Microsoft 365 Admin Center (erfordert Mandantenadministratorberechtigungen).

    Hinweis

    Sie können benutzerdefinierte Engine-Agents, die Sie von einem deklarativen Agent konvertiert haben, an Partner Center übermitteln. Agent-Benutzer werden aufgefordert, dem Upgrade ihres Agents zuzustimmen. Weitere Informationen finden Sie im nächsten Abschnitt.

Benutzerdefinierte Engine-Agents, die aus deklarativen Agents konvertiert werden, können zur Verteilung an Partner Center übermittelt werden, vorbehaltlich der geltenden Marketplace-Validierung und Mandantenrichtlinien.

Wenn ein konvertierter Agent Änderungen einführt, die sich auf Funktionen oder Berechtigungen auswirken, wird der Agent für vorhandene Benutzer nicht automatisch aktualisiert. Benutzer werden vor der Verwendung aufgefordert, die aktualisierte Version zu überprüfen und ihr zuzustimmen.

Benutzern wird eine Updateaufforderung in Copilot und Teams angezeigt, und sie müssen das Update explizit genehmigen. Ob eine zusätzliche Administratorgenehmigung erforderlich ist, hängt von den angeforderten Berechtigungen und der Zustimmungskonfiguration des Mandanten ab.

Weitere Informationen finden Sie unter Bedingungen, wenn für ein App-Update die Zustimmung erforderlich ist.

Verwendung durch den Benutzer

Der Übergang von einem deklarativen Agent zu einem benutzerdefinierten Engine-Agent ist für den Benutzer nahtlos. Wenn der Name und das Logo, das Sie in Ihrem App-Paket verwenden, identisch sind, werden benutzern keine sichtbaren Änderungen angezeigt.

Wenn Benutzer den Agent angeheftet haben, müssen sie den Agent nach der Veröffentlichung des Updates erneut anheften.

Verwandte Inhalte

  • Last updated on