Criar sugestões de pedidos

Para criar iniciadores de pedidos com o Portal do Programador:

1. Abra o Teams e selecione Aplicativos no painel esquerdo. Na página Aplicações , procure Portal do Programador e, em seguida, selecione Abrir.

   

2. No Portal do Programador, selecione o separador Aplicações . Se não tiver um pacote de aplicações existente, pode criar ou importar uma aplicação existente. Para obter mais informações, veja Portal do Programador do Teams.

3. Selecione o separador Aplicações , selecione Funcionalidades da aplicação no painel esquerdo e, em seguida, selecione Bots.

4. Em Comandos, selecione Adicionar um comando.

   

5. Introduza os valores para os seguintes campos:

   • Comando: aparece como a linha de comandos do bot.
   • Descrição: uma breve explicação do objetivo do comando.

6. Selecione o âmbito pessoal e, em seguida, selecione Adicionar. Isto define onde o menu de comandos tem de aparecer.

   

Outra forma de criar um iniciador de pedidos é criá-lo diretamente no ficheiro de manifesto da aplicação enquanto desenvolve o código fonte do bot. Para usar esse método, siga estes pontos:

• A command propriedade suporta até 10 comandos.
• Pode criar iniciadores de pedidos que funcionam em todos os âmbitos ou criar entradas de pedidos diferentes para cada âmbito.

Exemplo de manifesto para iniciadores de pedidos

O código de exemplo de manifesto para iniciadores de pedidos é o seguinte:

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "scopes": [
        "personal"
      ],
      "commandLists":[
        {
          "scopes":[
            "personal"
          ],
          "commands":[
            {
              "title":"Help",
              "description":"Displays this help message"
            },
            {
              "title":"Search Flights",
              "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm"
            },
            {
              "title":"Search Hotels",
              "description":"Search hotels in Portland tonight"
            },
            {
              "title":"Best Time to Fly",
              "description":"Best time to fly to London for a 5 day trip this summer"
            }
          ]
        }
      ]
    }
  ],
  ...
}

• Referência do SDK

• Referência de código de exemplo

Pode analisar a parte @Mention do texto da mensagem através de um método estático fornecido com o Microsoft Bot Framework. É um método da classe com o Activity nome RemoveRecipientMention.

O código C# para analisar a parte @Mention do texto da mensagem é o seguinte:

// Remove recipient mention text from Text property.
// Use with caution because this function is altering the text on the Activity.
var modifiedText = turnContext.Activity.RemoveRecipientMention();

• Referência do SDK

• Referência de código de exemplo

Você pode analisar a parte @Mention parte do texto da mensagem usando um método estático fornecido com o Bot Framework. É um método da classe com o TurnContext nome removeMentionText.

O código JavaScript para analisar a parte @Mention do texto da mensagem é o seguinte:

// Remove mention text from Text property, this function is altering the text on the Activity.
const modifiedText = TurnContext.removeMentionText(turnContext.activity, turnContext.activity.recipient.id);

• Referência do SDK

• Referência de código de exemplo

Você pode analisar a parte @Mention parte do texto da mensagem usando um método estático fornecido com o Bot Framework. É um método da classe com o TurnContext nome remove_recipient_mention.

O código Python para analisar a parte @Mention do texto da mensagem é o seguinte:

# Remove recipient mention text from Text property, this function is altering the text on the Activity.
modified_text = TurnContext.remove_recipient_mention(turn_context.activity)