Créer des suggestions d’invite

Pour créer des invites de démarrage à l’aide du Portail des développeurs :

1. Ouvrez Teams et sélectionnez Apps dans le volet gauche. Dans la page Applications , recherchez Portail des développeurs, puis sélectionnez Ouvrir.

   

2. Dans le Portail des développeurs, sélectionnez l’onglet Applications . Si vous n’avez pas de package d’application existant, vous pouvez créer ou importer une application existante. Pour plus d’informations, consultez Portail des développeurs pour Teams.

3. Sélectionnez l’onglet Applications , sélectionnez Fonctionnalités de l’application dans le volet gauche, puis bots.

4. Sous Commandes, sélectionnez Ajouter une commande.

   

5. Entrez les valeurs des champs suivants :

   • Commande : s’affiche en tant qu’invite pour votre bot.
   • Description : brève explication de l’objectif de la commande.

6. Sélectionnez l’étendue personnelle, puis sélectionnez Ajouter. Cela définit l’emplacement où le menu de commande doit apparaître.

   

Une autre façon de créer une invite de démarrage consiste à la créer directement dans le fichier manifeste de l’application lors du développement du code source de votre bot. Pour utiliser cette méthode, suivez ces points :

• La command propriété prend en charge jusqu’à 10 commandes.
• Vous pouvez créer des démarrages d’invite qui fonctionnent dans toutes les étendues ou créer des démarrages d’invite différents pour chaque étendue.

Exemple de manifeste pour les démarrages d’invite

L’exemple de code de manifeste pour les démarrages d’invite est le suivant :

{
  ⋮
  "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"
            }
          ]
        }
      ]
    }
  ],
  ...
}

• Référence du Kit de développement logiciel (SDK)

• Exemple de référence de code

Vous pouvez analyser la partie @Mention du texte du message à l’aide d’une méthode statique fournie avec le Microsoft Bot Framework. Il s’agit d’une méthode de la Activity classe nommée RemoveRecipientMention.

Le code C# pour analyser la partie @Mention du texte du message est le suivant :

// 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();

• Référence du Kit de développement logiciel (SDK)

• Exemple de référence de code

Vous pouvez analyser la partie @Mention du texte du message à l’aide d’une méthode statique fournie avec le Bot Framework. Il s’agit d’une méthode de la TurnContext classe nommée removeMentionText.

Le code JavaScript pour analyser la partie @Mention du texte du message est le suivant :

// 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);

• Référence du Kit de développement logiciel (SDK)

• Exemple de référence de code

Vous pouvez analyser la partie @Mention du texte du message à l’aide d’une méthode statique fournie avec le Bot Framework. Il s’agit d’une méthode de la TurnContext classe nommée remove_recipient_mention.

Le code Python permettant d’analyser la partie @Mention du texte du message est le suivant :

# 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)