次の方法で共有

宣言型エージェントをカスタム エンジン エージェントに変換する

Microsoft 365 Copilotは、宣言型エージェントに昇格されたメッセージ拡張機能を含む宣言型エージェントをカスタム エンジン エージェントに変換できる移行機能を提供します。 宣言型エージェントをカスタム エンジン エージェントに変換すると、オーケストレーション、AI モデル、データ統合を完全に制御でき、高度な機能を利用してより高度なワークフローを作成できます。

この記事では、宣言型エージェントをカスタム エンジン エージェントに変換して、独自のオーケストレーションを利用して、organization固有のニーズをより適切に満たすために実行する手順について説明します。

前提条件

この記事の手順では、次の前提条件を満たす必要があります。

  • Microsoft 365 Agents Toolkit を使用して構築された既存の宣言型エージェント。

    注:

    Microsoft 365 Copilotを使用して構築されたエージェントは現在サポートされていません。

  • カスタム ボットとボット ID。 カスタム ボットを作成する方法については、「 ボットとエージェント」を参照してください。

  • Microsoft 365 Agents Toolkit 拡張機能がインストールされている Visual Studio Code。

  • ストリーミングや引用などの Copilot 固有の機能を実装する場合は、Microsoft 365 エージェント SDKまたは Teams SDK。

  • 環境内のアプリ マニフェストをアップロードするためのアクセス許可。

宣言型エージェントを変換する

既存の宣言型エージェントをカスタム エンジン エージェントに変換するには、アプリ マニフェストとアプリ パッケージを更新します。

アプリ マニフェストを更新する

アプリ マニフェストを更新するには:

  1. Visual Studio Code で、宣言型エージェントのアプリ マニフェスト ファイルを開きます。

  2. ボット ノードを追加し、[ID] フィールドにボット 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?" 
                        } 
                    ] 
                } 
            ] 
        } 
    ],

    ボット ノードのスキーマの詳細については、「 bots オブジェクト」を参照してください。

    注:

    アプリ マニフェスト スキーマ バージョン 1.21 以降を使用します。 カスタム エンジン エージェントは、マニフェスト バージョン 1.21 以降のバージョンでサポートされています。

  3. copilotAgents オブジェクトで、次の例に示すように、宣言型Agents ノードを customEngineAgents ノードに変更します。

    宣言型エージェント ノード

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

    をカスタム エンジン エージェント ノードに置き換える

    "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?"
                    }
                ]
            }
        ]
    }
],

    スキーマ参照情報については、「 copilotAgents オブジェクト」を参照してください。

    注:

    アプリ マニフェストには、宣言型エージェント ノードまたはカスタム エンジン エージェント ノードを含めることができますが、両方を含めることもできます。

  4. version プロパティでアプリのアプリの バージョン 番号を更新します。

  5. id プロパティで、宣言型エージェントのアプリ マニフェストで使用した ID と同じ ID が使用されていることを確認します。

エージェント UX をカスタマイズする

ユーザーのエージェント エクスペリエンスを定義します。 会話スターターと提案されたプロンプトを追加したり、ストリーミング応答や引用を実装したりできます。 カスタム エンジン エージェントの機能を定義してテストする必要があることに注意してください。

詳細については、「 カスタム エンジン エージェントのユーザー エクスペリエンス機能」を参照してください。

アプリ パッケージを更新して送信する

エージェント マニフェストを更新したら、アプリを再パッケージ化します。

  1. 更新したエージェント マニフェスト、アプリ アイコン、その他の資産を新しい .zip ファイルに追加します。

  2. 新しいパッケージを送信して、既存のアプリを更新します。 エージェントがorganizationの内部にある場合は、Microsoft 365 管理センターを使用します (テナント管理者のアクセス許可が必要です)。

    注:

    パートナー センターを介したコマーシャル マーケットプレースへのアプリ パッケージの提出は、現在サポートされていません。

ユーザー エクスペリエンス

宣言型エージェントからカスタム エンジン エージェントへの移行は、ユーザーにとってシームレスです。 アプリ パッケージで使用する名前とロゴが同じ場合、ユーザーに表示される変更は表示されません。

ユーザーがエージェントをピン留めした場合は、更新プログラムを発行した後にエージェントをもう一度ピン留めする必要があります。

関連コンテンツ

  • Last updated on