Definir comandos de ação de extensão de mensagem

Para criar uma extensão de mensagem baseada em ação usando o Agents Toolkit, siga estas etapas:

1. Abra o Visual Studio Code.
2. No painel esquerdo, selecione Microsoft 365 Agents Toolkit.
3. Selecione Criar um novo agente/aplicativo>do aplicativo do Teams.
4. Selecione a Extensão de Mensagem.
5. Selecione Coletar dos dados de entrada e do processo.
6. Selecione uma linguagem de programação.
7. Selecione a pasta padrão.
8. Insira o nome do seu aplicativo e selecione Enter.

O Agents Toolkit cria um scaffolding em seu projeto e cria uma extensão de mensagem de ação.

Para criar uma extensão de mensagem baseada em ação usando o Portal do Desenvolvedor do Teams, siga estas etapas:

1. Acesse o portal do desenvolvedor do Teams.

2. Vá para Aplicativos.

3. Selecione Criar um novo aplicativo.

4. Em Configurar, selecione Recursos do aplicativo.

5. Selecione a Extensão de mensagens.

   

6. Em Tipo de extensão de mensagem, selecione Bot.

   1. Se você receber um aviso de isenção de responsabilidade, que diz API, a extensão da mensagem já está em uso pelos usuários. Deseja alterar o tipo de extensão de mensagem para bot?. Selecione Sim, alterar.

   

7. Se você não tiver um bot existente, selecione Bot existente ou, se tiver uma ID de bot, selecione Inserir ID do Bot.

   1. Se você não tiver uma ID de bot, selecione Criar um bot para criar um novo bot e insira a ID de bot do novo bot que você criou.

8. Selecione os escopos necessários.

9. Em Comando, selecione + Adicionar um comando.

   Uma página de detalhes do comando é exibida.

10. Na página Detalhes do comando, selecione Ação e, em seguida, selecione o tipo de parâmetro.

11. Selecione Ação como o tipo de comando e atualize os seguintes campos:

    • ID do comando
    • Título do comando
    • Descrição do comando
    • Contexto no qual o comando funciona
    • Nome do parâmetro
    • Título do parâmetro
    • Descrição do parâmetro
    • Tipo de descrição do parâmetro

12. Selecione Adicionar um domínio em Links de visualização.

13. Insira um domínio válido e selecione Adicionar.

    

14. Selecione Salvar.

    

Para adicionar mais parâmetros

1. No comando, selecione o ícone de reticências (...) e selecione Editar parâmetro.

   

2. Selecione Adicionar um parâmetro e atualize os detalhes do parâmetro.

   

3. Selecione Salvar

Uma extensão de mensagem de ação baseada em bot é criada.

• Referência do SDK
• Referência de código de exemplo

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}",
                            },
                        },
                    };
            }
        }

Referência de código de exemplo

// 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`
                }
            }
        };
    }