メッセージ拡張機能のアクション コマンドを定義する

Agents Toolkit を使用してアクション ベースのメッセージ拡張機能を作成するには、次の手順に従います。

1. Visual Studio Code を開きます。
2. 左側のウィンドウで、[ Microsoft 365 エージェント ツールキット] を選択します。
3. [Create a New Agent/App>Teams App]\(新しいエージェント/アプリTeams アプリの作成\) を選択します。
4. [ メッセージ拡張機能] を選択します。
5. [ 入力から収集] と [データの処理] を選択します。
6. プログラミング言語を選択します。
7. [ 既定のフォルダー] を選択します。
8. アプリの名前を入力し、[Enter] を選択 します。

Agents Toolkit によってプロジェクトがスキャフォールディングされ、アクション メッセージ拡張機能が作成されます。

Teams 用開発者ポータルを使用してアクション ベースのメッセージ拡張機能を作成するには、次の手順に従います。

1. Teams 用開発者ポータルに移動します。

2. [アプリ] に移動します。

3. [ 新しいアプリの作成] を選択します。

4. [ 構成] で、[ アプリの機能] を選択します。

5. [ メッセージング拡張機能] を選択します。

   

6. [ メッセージ拡張機能の種類] で、[ボット] を選択 します。

   1. API Message 拡張機能を読み取る免責事項がユーザーによって既に使用されている場合。メッセージ拡張機能の種類を bot に変更しますか? [ はい、変更] を選択します。

   

7. 既存のボットがない場合は、[ 既存の ボット] を選択するか、ボット ID がある場合は、[ ボット ID の入力] を選択します。

   1. ボット ID がない場合は、[ ボットの作成] を選択して新しいボットを作成し、作成した新しいボットのボット ID を入力します。

8. 必要なスコープを選択します。

9. [ コマンド] で、[ + コマンドの追加] を選択します。

   コマンドの詳細ページが表示されます。

10. [コマンドの詳細] ページで、[ アクション ] を選択し、[パラメーターの種類] を選択します。

11. コマンドの種類として [ アクション ] を選択し、次のフィールドを更新します。

    • コマンド ID
    • コマンドのタイトル
    • コマンドの説明
    • コマンドが機能するコンテキスト
    • パラメーター名
    • パラメーターのタイトル
    • パラメータの説明
    • パラメーターの説明の種類

12. [プレビュー リンク] で [ドメインの追加] を選択します。

13. 有効なドメインを入力し、[ 追加] を選択します。

    

14. [保存] を選択します。

    

パラメーターを追加するには

1. [コマンド] で省略記号 (...) アイコンを選択し、[ パラメーターの編集] を選択します。

   

2. [ パラメーターの追加] を 選択し、パラメーターの詳細を更新します。

   

3. [保存] を選びます。

ボットベースのアクション メッセージ拡張機能が作成されます。

• SDK レファレンス
• サンプル コード リファレンス

protected override Task<MessagingExtensionActionResponse> OnTeamsMessagingExtensionFetchTaskAsync(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionAction action, CancellationToken cancellationToken)
        {
            // Handle different actions using switch.
            switch (action.CommandId)
            {
                case "HTML":
                    return new MessagingExtensionActionResponse
                    {
                        Task = new TaskModuleContinueResponse
                        {
                            Value = new TaskModuleTaskInfo
                            {
                                Height = 200,
                                Width = 400,
                                Title = "Task Module HTML Page",
                                Url = baseUrl + "/htmlpage.html",
                            },
                        },
                    };
                default:
                    string memberName = "";
                    var member = await TeamsInfo.GetMemberAsync(turnContext, turnContext.Activity.From.Id, cancellationToken);
                    memberName = member.Name;
                    return new MessagingExtensionActionResponse
                    {
                        Task = new TaskModuleContinueResponse
                        {
                            Value = new TaskModuleTaskInfo
                            {
                                Card = <<AdaptiveAction card json>>,
                                Height = 200,
                                Width = 400,
                                Title = $"Welcome {memberName}",
                            },
                        },
                    };
            }
        }

サンプル コード リファレンス

// Invoked when a Messaging Extension Fetch activity is received from the connector.
    async handleTeamsMessagingExtensionFetchTask(context, action) {
        switch (action.commandId) {
            case 'Static HTML':
                return staticHtmlPage();
        }
    }

    staticHtmlPage(){
        return {
            task: {
                type: 'continue',
                value: {
                    width: 450,
                    height: 125,
                    title: 'Dialog Static HTML',
                    url: `${baseurl}/StaticPage.html`
                }
            }
        };
    }