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

    Die Übermittlung Ihres App-Pakets an den kommerziellen Marketplace über Partner Center wird derzeit nicht unterstützt.

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