Tutoriels

Configuration requise

Vous pouvez discuter avec votre bot et afficher les messages et les cartes adaptatives tels qu’ils apparaissent dans Teams. Vous pouvez également simuler une activité dans Agents Playground à l’aide de déclencheurs d’activité.

Ce guide pas à pas vous aide à créer un bot de conversation IA à l’aide d’Agents Toolkit et à déboguer avec l’outil de test. Une fois ce guide terminé, vous verrez la sortie suivante, dans laquelle l’utilisateur peut accéder au bot de conversation IA et l’utiliser :

Créer un espace de travail de projet pour votre application de bot de conversation IA

La fonctionnalité de bot d’une application Teams crée un chatbot ou un bot conversationnel. Il communique avec un service web, ce qui facilite l’utilisation de ses services. Le bot peut exécuter des tâches simples et automatisées telles que la fourniture d’un service client. Vous pouvez obtenir des prévisions météorologiques, effectuer des réservations ou tout autre service proposé à l’aide d’un bot conversationnel.

Comme vous avez déjà préparé la création de ces applications, vous pouvez configurer un nouveau projet Teams pour créer l’application de bot de conversation IA.

Créer votre espace de travail de projet de bot

Si les conditions préalables sont en place, commençons !

1. Ouvrez Visual Studio Code.

2. Sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité Visual Studio Code.

3. Sélectionnez Créer un agent/une application.

   

4. Sélectionnez Agents pour Teams>Azure OpenAI> entrez une entrée dans Entrée Azure clé du service API maintenant

   

5. Sélectionnez Agents de base pour Teams. Si vous avez besoin d’une autre fonctionnalité pour votre bot, sélectionnez l’option requise.

   

6. Sélectionnez le langage de programmation JavaScript.

   

7. Sélectionnez Dossier par défaut.

   

   Pour modifier l’emplacement par défaut, procédez comme suit :

   1. Sélectionnez Parcourir.

      

   2. Sélectionnez l’emplacement de l’espace de travail du projet.

   3. Sélectionnez Sélectionner un dossier.

      

8. Entrez un nom approprié pour votre application, puis sélectionnez la touche Entrée .

   

   Une boîte de dialogue s’affiche, dans laquelle vous devez choisir oui ou non pour approuver les auteurs des fichiers dans ce dossier.

   

Vous avez maintenant créé votre espace de travail de projet de bot de conversation IA.

Découvrez le code source de l’application bot

Une fois la génération de modèles automatique terminée, explorez les répertoires de projet et les fichiers dans la section EXPLORATEUR du Visual Studio Code.

Créer et exécuter votre application de bot de conversation IA

Créer une clé et un point de terminaison OpenAI pour votre bot de conversation ia

1. Accédez au portail Azure.

2. Sélectionnez Créer une ressource et recherchez Azure OpenAI.

3. Sélectionnez Azure OpenAI, puis créer.

   

4. Renseignez les informations requises et sélectionnez Suivant.

   

5. Sélectionnez Tous les réseaux, y compris Internet, peuvent accéder à cette ressource, puis sélectionnez Suivant.

   

6. Renseignez les informations requises et sélectionnez Suivant.

   

7. Sélectionnez Créer.

   

Vous avez créé une clé et un point de terminaison pour votre bot de conversation IA.

Obtenir Azure clés et point de terminaison OpenAI

1. Sélectionnez Accéder aux ressources.

   

2. Sélectionnez Clés et point de terminaison dans le volet gauche, puis copiez la CLÉ et le point de terminaison. Vous pouvez copier KEY 1 ou KEY 2.

   

   Enregistrez la clé et le point de terminaison pour une utilisation ultérieure.

3. Sélectionnez Déploiements de modèles dans le volet gauche, puis Sélectionnez Gérer les déploiements.

   

   La fenêtre Azure OpenAI Studio s’affiche.

4. Sélectionnez Déploiements dans le volet gauche, puis + Créer un déploiement.

   

5. Sélectionnez les détails suivants :

   1. Sélectionnez gpt-35-turbo dans la liste déroulante Sélectionner un modèle .

      Remarque

      Seul le modèle gpt-35-turbo est pris en charge pour le bot de conversation IA.

   2. Sélectionnez 0301 (par défaut) dans la liste déroulante Version du modèle .

   3. Entrez Nom du déploiement , puis sélectionnez Créer.

      

   4. Copiez et enregistrez le nom du déploiement pour une utilisation ultérieure.

      

Mettre à jour Azure clé et points de terminaison OpenAI

1. Ouvrez votre projet dans Visual Studio Code.

2. Sous EXPLORATEUR, accédez au fichier env.env.playground.user>.

3. Entrez votre SECRET_AZURE_OPENAI_API_KEY et SECRET_AZURE_OPENAI_ENDPOINT.

   ...
   SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key>
   SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>
   

4. Accédez au fichier deapp.jssrc>.

5. Commentez le OpenAI code et supprimez les marques de commentaire du Azure OpenAI code.

6. Entrez votre Azure nom de déploiement OpenAI dans azureDefaultDeployment.

   
   // Use OpenAI
   // apiKey: config.openAIKey,
   // defaultModel: "gpt-3.5-turbo",
   
   azureApiKey: config.azureOpenAIKey,
   azureDefaultDeployment: "gpt-35-turbo",
   azureEndpoint: config.azureOpenAIEndpoint,
   
   

Déboguer et exécuter votre application de bot de conversation ia

1. Dans le volet gauche, sélectionnez EXÉCUTER et DÉBOGUER (Ctrl+Maj+D), puis sélectionnez Déboguer dans Agents Playground dans la liste déroulante.

   

2. Agents Playground ouvre votre bot de conversation IA dans une page web.

   

Déclencheurs d’activité

Il existe deux types de déclencheurs d’activité :

Déclencheurs d’activité prédéfinis

Agents Playground fournit des déclencheurs d’activité prédéfinis pour tester les fonctionnalités de votre bot.

Les déclencheurs d’activité prédéfinis sont disponibles dans le menu Simuler une activité dans Agents Playground.

Pour simuler une activité Ajouter un utilisateur , procédez comme suit :

1. Dans Agents Playground, accédez à Simuler une activité>Ajouter un utilisateur.

   

   Une boîte de dialogue s’affiche pour afficher un aperçu du gestionnaire d’activités.

2. Sélectionnez Envoyer l’activité.

   

   Le bot envoie la réponse suivante :

   

Déclencheurs d’activité personnalisés

Vous pouvez utiliser l’activité personnalisée pour personnaliser les déclencheurs d’activité, par exemple, reactionsAdded afin de répondre aux exigences de votre application bot. Agents Playground remplit automatiquement les propriétés requises de l’activité. Vous pouvez également modifier le type d’activité et ajouter d’autres propriétés.

1. Sélectionnez Simuler une activité>Activité personnalisée.

   

2. Ajoutez messageReaction pour personnaliser l’activité sous la type propriété :

   {
       "type": "messageReaction",
       "reactionsAdded": [
       {
           "type": "like"
       }
       ],
       "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
   }
   

3. Sélectionnez Envoyer l’activité.

   

   Le bot envoie un onReactionsAdded gestionnaire en réponse.

   

Relever le défi

Avez-vous trouvé une sortie comme celle-ci ?

Félicitations ! Vous avez créé une application de bot de conversation IA. Maintenant, vous avez appris à déboguer votre application de bot de conversation IA dans Agents Playground.

Vous pouvez utiliser des extensions de message basées sur l’API pour intégrer des services externes couramment utilisés dans le flux de travail métier. Par exemple, une entreprise qui utilise fréquemment un système CRM pour la gestion des clients peut utiliser une extension de message pour extraire et afficher les données client directement à partir de Teams. Cette application permet de gagner du temps et d’améliorer l’efficacité en réduisant le besoin de basculer entre différentes applications. Cette fonctionnalité est prise en charge sur toutes les plateformes où Teams est disponible, y compris les ordinateurs de bureau, le web et les appareils mobiles.

Conditions préalables à la création d’une extension de message

Voici une liste des outils dont vous avez besoin pour créer et déployer vos applications.

Configurer votre locataire de développement Teams

Un locataire est comme un espace ou un conteneur pour votre organization dans Teams, où vous discutez, partagez des fichiers et exécutez des réunions. Cet espace est également l’endroit où vous chargez et testez votre application personnalisée. Vérifions si vous êtes prêt à développer avec le locataire.

Rechercher l’option de chargement d’application personnalisée

Après avoir créé l’application, vous devez charger votre application dans Teams sans la distribuer. Ce processus est appelé chargement d’application personnalisée. Connectez-vous à votre compte Microsoft 365 pour afficher cette option.

Avez-vous déjà un locataire et disposez-vous de l’accès administrateur ? Nous allons case activée si vous le faites vraiment !

Vérifiez si vous pouvez charger une application personnalisée dans Teams :

1. Dans le client Teams, sélectionnez l’icône Applications .

2. Sélectionnez Gérer vos applications.

3. Sélectionnez Charger une application.

4. Recherchez l’option Charger une application personnalisée. Si vous voyez l’option , le chargement d’applications personnalisées est activé.

   

Créer un locataire développeur Teams gratuit (facultatif)

Si vous n’avez pas de compte de développeur Teams, vous pouvez l’obtenir gratuitement. Rejoignez le programme des développeurs Microsoft 365 !

1. Accédez auProgramme pour les développeurs Microsoft 365.

2. Sélectionnez Rejoindre maintenant et suivez les instructions à l’écran.

3. Dans l’écran d’accueil, sélectionnez Configurer l’abonnement E5.

4. Configurez votre compte d’administrateur. Une fois que vous avez terminé, l’écran suivant s’affiche.

   

5. Connectez-vous à Teams à l’aide du compte d’administrateur que vous venez de configurer. Vérifiez que vous disposez de l’option Charger une application personnalisée dans Teams.

Obtenir un compte Azure gratuit

Si vous souhaitez héberger votre application ou accéder aux ressources dans Azure, vous devez disposer d’un abonnement Azure. Créez un compte gratuit avant de commencer.

Vous disposez de tous les outils pour configurer votre compte. Ensuite, nous allons configurer votre environnement de développement et commencer à créer ! Sélectionnez d’abord l’application que vous souhaitez générer.

Créer un document de description OpenAPI

La description OpenAPI (OAD) est la spécification standard qui décrit la façon dont les fichiers OpenAPI sont structurés et décrits. Il s’agit d’un format indépendant du langage et lisible par l’homme pour décrire les API. Il est facile pour les humains et les machines de lire et d’écrire. Le schéma est lisible par l’ordinateur et représenté en YAML ou JSON.

Pour interagir avec les API, un document De description OpenAPI est nécessaire. Le document De description OpenAPI doit répondre aux critères suivants :

• La auth propriété ne doit pas être spécifiée.

• JSON et YAML sont les formats pris en charge.

• Les versions 2.0 et 3.0.x d’OpenAPI sont prises en charge.

• Teams ne prend pas en charge les constructions oneOf, anyOf, allOf et pas (swagger.io).

• La construction de tableaux pour la requête n’est pas prise en charge, mais les objets imbriqués dans un corps de requête JSON sont pris en charge.

• Le corps de la demande, le cas échéant, doit être une application/Json pour garantir la compatibilité avec un large éventail d’API.

• Définissez une URL de serveur de protocole HTTPS pour la servers.url propriété .

• Seule la recherche par paramètre unique est prise en charge.

• Un seul paramètre obligatoire sans valeur par défaut est autorisé.

• Seules les méthodes POST et GET HTTP sont prises en charge.

• Le document De description OpenAPI doit avoir un operationId.

• L’opération ne doit pas nécessiter de paramètres Header ou Cookie sans valeurs par défaut.

• Une commande doit avoir exactement un paramètre.

• Vérifiez qu’il n’existe aucune référence distante dans le document Description OpenAPI.

• Un paramètre obligatoire avec une valeur par défaut est considéré comme facultatif.

  Nous avons utilisé la description OpenAPI suivante comme exemple pour ce tutoriel :

  OpenAPI Description

      openapi: 3.0.1
      info:
      title: OpenTools Plugin
      description: A plugin that allows the user to find the most appropriate AI tools for their use cases, with their pricing information.
      version: 'v1'
      servers:
          - url: https://gptplugin.opentools.ai
      paths:
      /tools:
      get:
      operationId: searchTools
      summary: Search for AI Tools
          parameters:
          - in: query
            name: search
            required: true
            schema:
            type: string
            description: Used to search for AI tools by their category based on the keywords. For example, a search for "tool to create music" provides a list of tools that can create music.
          responses:
          "200":
            description: OK
            content:
            application/json:
              schema:
              $ref: '#/components/schemas/searchToolsResponse'
          "400":
            description: Search Error
            content:
            application/json:
              schema:
              ref: '#/components/schemas/searchToolsError'
          components:
          schemas:
          searchToolsResponse:
          required:
          - search
          type: object
          properties:
          tools:
          type: array
          items:
          type: object
          properties:
          name:
          type: string
          description: The name of the tool.
          opentools_url:
          type: string
          description: The URL to access the tool.
          main_summary:
          type: string
          description: A summary of what the tool is.
          pricing_summary:
          type: string
          description: A summary of the pricing of the tool.
          categories:
          type: array
          items:
          type: string
          description: The categories assigned to the tool.
          platforms:
          type: array
          items:
          type: string
          description: The platforms that this tool is available on.
          description: The list of AI tools.
          searchToolsError:
          type: object
          properties:
          message:
          type: string
          description: Message of the error.
  
  

  Remarque

  Vérifiez que la required: true propriété n’est disponible que pour un seul paramètre. S’il existe plusieurs paramètres requis, vous pouvez mettre à jour la propriété requise sur required: false pour les autres paramètres.

Vous pouvez vérifier si le document De description OpenAPI est valide. Pour le vérifier, procédez comme suit :

1. Accédez à Swagger ou au validateur OpenAPI et validez le document Description OpenAPI.

2. Enregistrez le document De description OpenAPI.

3. Accédez à l’éditeur Swagger.

4. Dans le volet gauche, collez la description OpenAPI dans l’éditeur.

5. Dans le volet droit, sélectionnez GET.

6. Sélectionnez Essayer.

7. Entrez les valeurs du paramètre de recherche en tant qu’outil pour créer de la musique.

8. Sélectionnez Exécuter. L’éditeur swagger affiche une réponse avec une liste de produits.

   

9. Accédez àCorps de la réponse du serveur>.

10. Sous products, copiez le premier produit de la liste et enregistrez-le pour référence ultérieure.

    

Créer un modèle de rendu de réponse

Un document De description OpenAPI nécessite un modèle de rendu de réponse pour que l’application réponde aux requêtes GET ou POST. Le modèle de rendu de réponse se compose d’un modèle de carte adaptative, d’un modèle de carte d’aperçu et de métadonnées.

Modèle de carte adaptative

Pour créer un modèle de carte adaptative, procédez comme suit :

1. Accédez à ChatGPT et posez la requête suivante dans la zone de composition des messages :

   
   Create an Adaptive Card Template that binds to the following response:
       "categories": [
           "Music Generation",
           "AI Detection"
       ],
       "chatbot_short_url": "https://goto.opentools.ai/c/ai-music-generator",
       "main_summary": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. With advanced AI technology, AI Music Generator makes music production accessible to everyone.",
       "name": "AI Music Generator",
       "opentools_url": "https://goto.opentools.ai/ai-music-generator",
       "platforms": [
           "Web",
           "App",
           "API"
       ]
   

2. Sélectionnez Envoyer un message.

3. ChatGPT génère une réponse avec un modèle de carte adaptative qui lie les exemples de données. Enregistrez le modèle de carte adaptative pour référence ultérieure.

   Voici un exemple de modèle de carte adaptative :

   Modèle de carte adaptative

   
   {
   "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
   "type": "AdaptiveCard",
   "version": "1.4",
   "body": [
       {
       "type": "TextBlock",
       "text": "AI Music Generator",
       "weight": "Bolder",
       "size": "Large"
       },
       {
       "type": "TextBlock",
       "text": "Categories",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
        "text": "Music Generation, AI Detection",
        "wrap": true
       },
       {
       "type": "TextBlock",
       "text": "Description",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
       "text": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. AI Music Generator is powered by advanced AI technology, and it makes music production accessible to everyone.",
       "wrap": true
       },
       {
       "type": "TextBlock",
       "text": "Platform",
       "size": "Medium"
       },
       {
       "type": "TextBlock",
       "text": "Web, App, API",
       "wrap": true
       }
   ],
   "actions": [
       {
       "type": "Action.OpenUrl",
       "title": "Learn More",
       "url": "https://goto.opentools.ai/ai-music-generator"
       },
       {
       "type": "Action.OpenUrl",
       "title": "Try It",
       "url": "https://goto.opentools.ai/c/ai-music-generator"
       }
   ]
   }
   
   

4. Pour vérifier si la carte adaptative générée est liée aux exemples de données, procédez comme suit :

   1. Accédez à La carte adaptative Designer.

   2. Accédez à Sélectionner l’application hôte, puis sélectionnez Microsoft Teams dans la liste déroulante.

   3. Accédez à CARD PAYLOAD EDITOR et collez le code du modèle de carte adaptative.

   4. Accédez à SAMPLE DATA EDITOR et collez la réponse de l’API GET que vous avez enregistrée précédemment.

      

   5. Sélectionnez Mode d’aperçu. Le concepteur de cartes adaptatives affiche une carte adaptative avec les données qui lient la réponse au modèle.

      

Créer un modèle de carte en préversion

L’aperçu carte modèle peut contenir des titlepropriétés , subtitleet image . Si la réponse de l’API n’a pas d’image, vous pouvez supprimer la propriété image.

Voici un exemple de modèle de carte en préversion :

   "previewCardTemplate": {
        "title": "${if(name, name, 'N/A')}",
        "subtitle": "$${if(price, price, 'N/A')}"
    } 

Modèle de rendu de réponse

Le modèle de rendu de réponse doit être conforme au schéma hébergé sur https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json.

Pour créer un modèle de rendu de réponse, procédez comme suit :

1. Créez un fichier JSON et ajoutez le code suivant au fichier :

   { 
     "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json", 
     "version": "1.0", 
     "jsonPath": "", 
     "responseLayout": "", 
     "responseCardTemplate": { 
    },
    "previewCardTemplate": {
        }
    }
   

2. Mettez à jour les propriétés dans le modèle de rendu de réponse comme suit :

   #	Nom de la propriété	Valeur
   1.	"$schema"	"https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json"
   2.	"version"	"1.0" version est la version du modèle de rendu à utiliser.
   3.	"jsonPath"	"tools" jsonPath est le chemin d’accès à un ou plusieurs résultats dans la réponse JSON de réponse. Ajoutez au jsonPath tableau/données appropriés à partir de la liste des produits dans la réponse de l’API. Dans ce cas, le est des jsonPath outils. Pour plus d’informations sur la façon de déterminer le chemin JSON, consultez Interrogation de JSON avec le chemin d’accès JSON.
   4.	"responseLayout"	"list" responseLayout spécifie la disposition des pièces jointes. Utilisé pour les réponses du résultat de type. Les types pris en charge sont list et grid. Si le corps de la réponse contient un objet avec plusieurs éléments tels que le texte, le titre et l’image, la disposition de la réponse doit être définie sur list. Si la réponse de l’API contient uniquement des images ou des miniatures, la disposition de la réponse doit être définie sur grid.
   5.	"responseCardTemplate"	Collez le code du modèle de carte adaptative que vous avez enregistré précédemment. responseCardTemplate est un modèle de carte adaptative pour mapper la réponse JSON à une carte adaptative.
   6.	"previewCardTemplate"	Collez l’aperçu carte code de modèle que vous avez enregistré précédemment. previewCardTemplateest un aperçu carte modèle est utilisé pour afficher un aperçu des résultats dans le menu volant d’extension de message.

3. Enregistrez le modèle de rendu de réponse dans le même dossier que celui où vous avez enregistré le document De description OpenAPI.

Le code suivant est un exemple de modèle de rendu de réponse :

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.ResponseRenderingTemplate.schema.json",
    "version": "1.0",
    "jsonPath": "tools",
    "responseLayout": "list",
    "responseCardTemplate": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
            {
            "type": "TextBlock",
            "text": "AI Music Generator",
            "weight": "Bolder",
            "size": "Large"
            },
            {
            "type": "TextBlock",
            "text": "Categories",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "Music Generation, AI Detection",
            "wrap": true
            },
            {
            "type": "TextBlock",
            "text": "Description",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "AI Music Generator is an AI-powered music composing tool that allows users to create original and personalized music for various purposes. It can generate melodies, harmonies, and rhythms tailored to specific needs and preferences, with customization options such as genre, mood, length, and instrumentation. The tool is designed for creative individuals, from beginners to professionals, and can produce high-quality music in seconds. Every generated piece of music is royalty-free and can be used instantly, with no limitations on beat creation. With advanced AI technology, AI Music Generator makes music production accessible to everyone.",
            "wrap": true
            },
            {
            "type": "TextBlock",
            "text": "Platform",
            "size": "Medium"
            },
            {
            "type": "TextBlock",
            "text": "Web, App, API",
            "wrap": true
            }
        ],
        "actions": [
            {
            "type": "Action.OpenUrl",
            "title": "Learn More",
            "url": "https://goto.opentools.ai/ai-music-generator"
            },
            {
            "type": "Action.OpenUrl",
            "title": "Try It",
            "url": "https://goto.opentools.ai/c/ai-music-generator"
            }
        ]
    },
    "previewCardTemplate": {
        "title": "${if(name, name, 'N/A')}",
        "subtitle": "$${if(price, price, 'N/A')}"
    } 
}

Créer un manifeste d’application

Maintenant, vous devez créer un manifeste d’application (précédemment appelé manifeste d’application Teams). Le manifeste de l’application décrit comment votre application s’intègre au produit Microsoft Teams.

Créer un manifeste d’application Teams

Pour créer le manifeste, procédez comme suit :

1. Créez un fichier JSON. Votre manifeste d’application doit être conforme à la version 1.20 du schéma défini dans Schéma du manifeste d’application.

2. Ajoutez le code suivant au fichier JSON :

   Manifeste de l’application

   {
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.schema.json",
    "manifestVersion": "1.20",
    "version": "1.0.3",
    "id": "<<YOUR-MICROSOFT-APP-ID>>",
    "packageName": "com.microsoft.teams.extension",
    "developer": {
        "name": "Teams App, Inc.",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    },
    "name": {
        "short": "Search ME API",
        "full": "Search ME API full"
    },
    "description": {
        "short": "product app for testing API Message Extensions",
        "full": "product app for testing API Message Extensions"
    },
    "accentColor": "#FFFFFF",
    "composeExtensions": [
        {
            "composeExtensionType": "",
            "apiSpecificationFile": "",
            "commands": [
                {
                    "context": [
                        "compose"
                    ],
                    "type": "query",
                    "title": "API for fetching Klarna.",
                    "id": "",
                    "parameters": [
                        {
                            "name": "",
                            "title": "",
                            "description": ""
                        }
                    ],
                    "description": "",
                    "apiResponseRenderingTemplateFile": ""
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "validDomains": []
   }
   

3. Mettez à jour les propriétés du manifeste de l’application comme suit :

   • Remplacez par <<YOUR-MICROSOFT-APP-ID>> l’ID d’application Microsoft du bot.
   • Mettez à jour la valeur de sur composeExtensionTypeapiBased.
   • Mettez à jour la valeur de avec apiSpecificationFile le chemin d’accès de votre fichier de description OpenAPI.
   • Mettez à jour la valeur de sur commands.idsearchTools.
   • Mettez à jour la valeur de sur commands.titleSearch for AI Tools.
   • Mettez à jour la valeur de sur commands.descriptionSearch for AI Tools.
   • Mettez à jour la valeur de sur parameters.namesearch. S’il n’existe aucun paramètre, les valeurs doivent être des paramètres de requête ou properties.name si une propriété est référencée dans le schéma du corps de la requête.
   • Mettez à jour vers apiResponseRenderingTemplateFile le chemin d’accès de votre fichier de modèle de rendu de réponse.
   • Mettez à jour la valeur de sur validDomains le service URL point de terminaison défini dans le fichier de description OpenAPI.

4. Enregistrez le manifeste de l’application Teams dans le même dossier que celui où vous avez enregistré le document Description OpenAPI et le modèle de rendu de réponse.

   • Vous avez besoin d’une image couleur et d’une image hiérarchique. Ces images doivent être incluses dans le dossier et référencées dans le manifeste de votre application Teams.

   • Compressez le contenu du dossier. Le fichier zip doit inclure les fichiers suivants :

     • Document de description OpenAPI
     • Modèle de rendu de réponse
     • Manifeste d'application
     • Icône de couleur
     • Icône de contour

Charger une application personnalisée dans Teams

Connectez-vous à l’environnement de test Teams pour tester votre application dans Teams. Pour charger une application personnalisée dans Teams, procédez comme suit :

1. Accédez à Microsoft Teams et connectez-vous à l’aide de vos informations d’identification de locataire de test.

2. Accédez à Applications>Gérer votre application>Charger une application.

3. Sélectionnez Charger une application personnalisée.

4. Sélectionnez le fichier zip créé, puis sélectionnez Ouvrir.

5. Sélectionnez Ajouter.

   

6. Sélectionnez Ouvrir.

   

7. Accédez à une conversation, puis sélectionnez + dans la zone de rédaction des messages, puis recherchez votre application.

8. Sélectionnez l’application et effectuez une requête de recherche.

   

9. L’application répond avec une carte adaptative dans la fenêtre de conversation.

10. Sélectionnez Envoyer.

    

Félicitations ! Vous avez réussi ! Vous avez appris à créer une extension de message basée sur l’API à l’aide du document De description OpenAPI.

Un bot se comporte différemment en fonction de la conversation dans laquelle il est impliqué :

• Les bots dans les conversations de conversation de canal et de groupe nécessitent que les utilisateurs @mention accèdent au bot.
• Les bots dans une conversation en face à face ne nécessitent pas de @mention. Tous les messages envoyés par l’utilisateur acheminent vers le bot.

Ce guide pas à pas vous aide à créer un bot avec l’authentification unique. Vous verrez la sortie suivante :

Conditions préalables à la création d’un bot

Veillez à installer les outils suivants et à configurer votre environnement de développement :

Configurer le locataire de développement Teams

Un locataire est comme un espace ou un conteneur dans lequel vous discutez, partagez des fichiers et exécutez des réunions pour votre organization dans Teams. Vous pouvez également charger et tester l’application personnalisée.

Rechercher une option de chargement d’application personnalisée

Après avoir créé l’application, vous devez charger votre application dans Teams sans la distribuer. Ce processus est appelé chargement d’application personnalisée. Connectez-vous à votre compte Microsoft 365 pour afficher cette option.

Avez-vous déjà un locataire et disposez-vous de l’accès administrateur ? Nous allons case activée si vous le faites vraiment !

Pour vérifier les applications de chargement personnalisées dans Teams :

1. Dans le client Teams, sélectionnez l’icône Applications .

2. Sélectionnez Gérer vos applications.

3. Sélectionnez Charger une application.

4. Recherchez l’option Charger une application personnalisée. Si vous voyez l’option , le chargement d’applications personnalisées est activé.

   

Créer un locataire développeur Teams gratuit

Si vous n’avez pas de compte de développeur Teams, vous pouvez l’obtenir gratuitement. Rejoignez le programme des développeurs Microsoft 365 !

1. Accédez auProgramme pour les développeurs Microsoft 365.

2. Sélectionnez Rejoindre maintenant et suivez les instructions à l’écran.

3. Dans l’écran d’accueil, sélectionnez Configurer l’abonnement E5.

4. Configurez un compte d’administrateur. Une fois que vous avez terminé, l’écran suivant s’affiche.

   

5. Connectez-vous à Teams à l’aide du nouveau compte administrateur que vous venez de configurer. Vérifiez que vous disposez de l’option Charger une application personnalisée dans Teams.

Configurer l’environnement local

Pour cloner le dépôt, procédez comme suit :

1. Ouvrez Microsoft-Teams-Samples.

2. Sélectionnez Code.

3. Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.

   

4. Sélectionnez Cloner.

Inscrire Microsoft Entra application

Les étapes suivantes vous aident à créer et à inscrire votre bot dans le Portail Azure :

• Créez et inscrivez votre application Azure.
• Créez une clé secrète client pour activer l’authentification unique du bot.
• Ajoutez un canal Teams pour déployer le bot.
• Créez un tunnel vers les points de terminaison de votre serveur web à l’aide du tunnel de développement (recommandé) ou de ngrok.
• Ajoutez un point de terminaison de messagerie au tunnel de développement que vous avez créé.

Ajouter une inscription d’application

1. Accédez au portail Azure.

2. Sélectionner les inscriptions d’applications.

   

3. Sélectionnez + Nouvelle inscription.

   

4. Entrez le nom de votre application.

5. Sélectionnez l’option de locataire, si nécessaire.

6. Sélectionner Inscription.

   

   Votre application est inscrite dans Microsoft Entra ID. La page vue d’ensemble de l’application s’affiche.

   

   Remarque

   Enregistrez l’ID d’application à partir de l’ID d’application (client) et de l’ID d’annuaire (locataire) pour une utilisation ultérieure.

Créer un tunnel

Suivez l’une des deux méthodes suivantes pour créer un tunnel.

ngrok http --host-header=localhost 3978

Ajouter l’authentification web

1. Dans le volet gauche, sous Gérer, sélectionnez Authentification.

2. Sélectionnez Ajouter une plateforme>web.

   

3. Entrez l’URI de redirection de votre application en ajoutant auth-end au nom de domaine complet. Par exemple : https://your-devtunnel-domain/auth-end ou https://your-ngrok-domain/auth-end.

4. Sous Octroi implicite et flux hybrides, cochez les cases Jetons d’accès et jetons d’ID .

5. Sélectionnez Configurer.

   

6. Sous Web, sélectionnez Ajouter un URI.

7. Entrez https://token.botframework.com/.auth/web/redirect.

8. Sélectionnez Enregistrer.

   

Créer une clé secrète client

1. Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.

2. Sous Clés secrètes client, sélectionnez + Nouvelle clé secrète client.

   

   La fenêtre Ajouter une clé secrète client s’affiche.

3. Entrez Description.

4. Sélectionnez Ajouter.

   

5. Sous Valeur, sélectionnez Copier dans le Presse-papiers pour enregistrer la valeur de clé secrète client en vue d’une utilisation ultérieure.

   

Ajouter des autorisations d'API

1. Dans le volet gauche, sélectionnez Autorisations d’API.

2. Sélectionnez + Ajouter une autorisation.

   

3. Sélectionnez Microsoft Graph.

4. Sélectionnez Autorisations déléguées.

5. Sélectionnez User>User.Read.

6. Sélectionnez Ajouter des autorisations.

   

   Remarque

   • Si une application ne reçoit pas le consentement de l’administrateur informatique, les utilisateurs doivent fournir le consentement la première fois qu’ils utilisent une application.
   • Les utilisateurs doivent donner leur consentement aux autorisations d’API uniquement si l’application Microsoft Entra est inscrite dans un autre locataire.

Ajouter un URI d’ID d’application

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. En regard de URI d’ID d’application, sélectionnez Ajouter.

   

3. Mettez à jour l’URI de l’ID d’application au api://botid-{AppID} format et sélectionnez Enregistrer.

   

Ajouter une étendue

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. Sélectionnez + Ajouter une étendue.

   

3. Entrez access_as_user comme nom de l’étendue.

4. Sous Qui peut donner son consentement ?, sélectionnez Administrateurs et utilisateurs.

5. Mettez à jour les valeurs du reste des champs comme suit :

   1. Entrez Teams peut accéder au profil de l’utilisateur en tant que nom d’affichage de consentement Administration.

   2. Entrez Permet à Teams d’appeler les API web de l’application en tant qu’utilisateur actuelAdministration description du consentement.

   3. Entrez Teams peut accéder au profil utilisateur et effectuer des demandes au nom de l’utilisateur en tant que nom d’affichage du consentement de l’utilisateur.

   4. Entrez Autoriser Teams à appeler les API de cette application avec les mêmes droits que l’utilisateur comme description du consentement de l’utilisateur.

6. Vérifiez que State est défini comme Enabled.

7. Sélectionnez Ajouter une étendue.

   L’image suivante montre les champs et les valeurs :

   

   Remarque

   Le nom de l’étendue doit correspondre à l’URI d’ID d’application avec /access_as_user ajouté à la fin.

   

Ajouter une application cliente

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

   Sous Applications clientes autorisées, identifiez les applications que vous souhaitez autoriser pour l’application web de votre application.

2. Sélectionnez + Ajouter une application cliente.

   

3. Ajoutez Teams mobile ou de bureau et l’application web Teams.

   1. Pour Teams mobile ou de bureau : entrez l’ID client sous la forme 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. Pour le web Teams : entrez l’ID client en tant que 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Cochez la case Étendues autorisées .

5. Sélectionnez Ajouter une application.

   

   L’image suivante affiche l’ID client :

   

Mise à jour du manifeste

1. Dans le volet gauche, sélectionnez Manifeste.

2. Définissez la valeur de sur requestedAccessTokenVersion2 et sélectionnez Enregistrer.

   

Créer votre bot

Créer une ressource de bot Azure

1. Accéder à l’Accueil

2. Sélectionnez + Créer une ressource.

3. Dans la zone de recherche, entrez Azure Bot.

4. Ensuite, sélectionnez Entrée.

5. Sélectionnez Azure Bot.

6. Sélectionnez Créer.

   

7. Entrez le nom du bot dans Descripteur de bot.

8. Sélectionnez votre abonnement dans la liste déroulante.

9. Sélectionnez votre groupe de ressources dans la liste déroulante.

   

   Si vous n’avez pas de groupe de ressources existant, vous pouvez en créer un. Pour créer un groupe de ressources, procédez comme suit :

   1. Sélectionnez Créer.
   2. Entrez le nom de la ressource et sélectionnez OK.
   3. Sélectionnez un emplacement dans la liste déroulante Nouvel emplacement du groupe de ressources .

   

10. Sous Tarification, sélectionnez Modifier le plan.

    

11. Sélectionnez FO Free>Select.

    

12. Sous ID d’application Microsoft, sélectionnez Type d’applicationcomme multilocataire.

13. Dans Type de création, sélectionnez Utiliser l’inscription d’application existante.

14. Entrez l’ID d’application.

    Remarque

    Vous ne pouvez pas créer plusieurs bots avec le même ID d’application Microsoft.

15. Sélectionnez Examiner et créer.

    

16. Une fois la validation réussie, sélectionnez Créer.

    L’approvisionnement du bot prend quelques minutes.

17. Sélectionnez Accéder à la ressource.

    

    Vous avez créé votre bot Azure.

    

Ajouter un canal Teams

1. Dans le volet gauche, sélectionnez Canaux.

2. Sous Canaux disponibles, sélectionnez Microsoft Teams.

   

3. Cochez la case pour accepter les conditions d’utilisation du service.

4. Sélectionnez Accepter.

   

5. Sélectionnez Appliquer.

   

Ajouter un point de terminaison de messagerie

Utilisez l’une des méthodes suivantes pour ajouter un point de terminaison de messagerie :

Ajouter des paramètres de connexion OAuth

1. Dans le volet gauche, sélectionnez Configuration.

2. Sélectionnez le bouton Ajouter des paramètres de connexion OAuth.

3. Sous Nouveau paramètre de connexion, mettez à jour les informations suivantes :

   • Nom : entrez un nom pour votre nouveau paramètre de connexion. Vous pouvez utiliser le nom dans les paramètres de votre code de service de bot.
   • Fournisseur de services : dans la liste déroulante, sélectionnez Azure Active Directory v2.
   • ID client : Mettez à jour votre ID d’application Microsoft.
   • Clé secrète client : Mettez à jour la valeur des secrets client.
   • URL d’échange de jetons : mettez à jour l’URI de l’ID d’application.
   • ID de locataire : entrez Commun.
   • Étendues : entrez User.Read.

4. Sélectionnez Enregistrer.

   

Configurer les paramètres d’application et les fichiers manifestes

1. Accédez au fichier appsettings.json dans le dépôt cloné.

   

2. Ouvrez le fichier appsettings.json et mettez à jour les informations suivantes :

   • Définissez sur "MicrosoftAppId"l’ID d’application Microsoft de votre bot.
   • Définissez sur "MicrosoftAppPassword" la valeur de l’ID de clé secrète client de votre bot.
   • Définissez ConnectionName en tant que nom de connexion OAuth.
   • Définissez "MicrosoftAppType"sur Multi-locataire.
   • Définissez sur "MicrosoftAppTenantId"commun.

   

3. Accédez au fichier manifest.json dans le dépôt cloné.

   

4. Ouvrez le fichier manifest.json et mettez à jour les modifications suivantes :

   • Remplacez toutes les occurrences de par votre ID d’application"{TODO: MicrosoftAppId}" Microsoft.
   • Définissez sur "<<domain-name>>" votre domaine ngrok ou dev tunnel.

   

Générer et exécuter le service

1. Ouvrez Visual Studio.

2. Accédez à Fichier>Ouvrir>le projet/la solution....

   

3. Dans le dossier csharp_dotnetcore bot-conversation-sso-quickstart>, sélectionnez BotConversationSsoQuickstart.sln fichier.

   

4. Sélectionnez F5 pour exécuter le projet.

5. Si une boîte de dialogue Avertissement de sécurité s’affiche, sélectionnez Oui.

   

   Une page web s’ouvre avec un message Votre bot est prêt !.

   Remarque

   Cette page s’affiche uniquement lorsque vous accédez à l’URL localhost.

   

   Dépannage

   Si vous obtenez l’erreur de package Impossible de trouver , procédez comme suit :

   1. Accédez à Outils Paramètres> duGestionnaire> depackage NuGet.
   2. Dans la fenêtre Options qui s’affiche, sélectionnezSources de packagedu Gestionnaire> de package NuGet.
   3. Sélectionnez Ajouter.
   4. Dans Nom, entrez nuget.org et dans Source, entrez https://api.nuget.org/v3/index.json.
   5. Sélectionnez Mettre à jour et OK.
   6. Régénérez votre projet.

Charger le bot dans Teams

1. Dans votre dépôt cloné, accédez à Microsoft-Teams-Samples>samples>bot-conversation-sso-quickstart>csharp_dotnetcore>TeamsApplicationPackage>.

2. Créez un fichier .zip avec les fichiers suivants présents dans le dossier appPackage :

   • manifest.json
   • outline.png
   • color.png

   

3. Accédez à Microsoft Teams.

   1. Dans le client Teams, sélectionnez Applications.
   2. Sélectionnez Gérer vos applications.
   3. Sélectionnez Charger une application.
   4. Recherchez l’option Charger une application personnalisée.

   

4. Sélectionnez Ouvrir pour charger le fichier .zip que vous avez créé dans le dossier Manifeste .

   

5. Sélectionnez Ajouter pour ajouter le bot à votre conversation.

   

6. Sélectionnez Ouvrir.

   

   Vous pouvez interagir avec le bot en lui envoyant un message. Le bot échange un jeton d’authentification unique et appelle le API Graph en votre nom. Il vous maintient connecté, sauf si vous envoyez un message pour vous déconnecter.

7. Envoyez un message au bot. Le bot de conversation demande le consentement pour la première fois.

8. Pour le bureau : sélectionnez Continuer pour accorder des autorisations au client Teams pour accéder au bot.

   

   Remarque

   Vous avez maintenant configuré l’authentification unique avec votre application de bot et c’est la seule fois que vous devez donner votre consentement.

9. Pour les appareils mobiles : sélectionnez Accepter.

   Remarque

   Vous avez maintenant configuré l’authentification unique avec votre application bot sur mobile, et c’est la seule fois que vous devrez donner votre consentement.

   

Tu as trouvé quelque chose comme ça ?

Vous avez terminé le tutoriel pour commencer à créer un bot avec l’authentification unique.

Ce guide pas à pas vous aide à créer un onglet avec microsoft 365 Agents Toolkit (précédemment appelé Kit de ressources Teams). Vous verrez la sortie suivante une fois que vous aurez terminé ce guide :

Conditions préalables à la création de votre application

Voici la liste des outils que vous devez installer pour créer et déployer une application Teams.

Installer le kit de ressources Agents

Agents Toolkit permet de simplifier le processus de développement avec des outils permettant de créer une structure de projet pour votre application. Il crée la structure de répertoires nécessaire pour toutes les fonctionnalités sélectionnées avec les fichiers requis en place, prêts à générer le projet.

Vous pouvez télécharger le dernier programme d’installation de Visual Studio. Agent Toolkit est disponible en tant qu’extension dans Visual Studio.

Après avoir ouvert le programme d’installation de Visual Studio dans la fenêtre contextuelle des charges de travail :

1. Sélectionnez ASP.NET et développement web.

2. Sous Détails >de l’installationFacultatif, sélectionnez Outils de développement Microsoft Teams.

3. Sélectionnez Installer.

   

4. Sélectionnez Lancer. La fenêtre de l’application Visual Studio 2022 s’affiche.

   

5. Accédez à Extensions>Gérer les extensions.

   

   La fenêtre Gérer l’extension s’affiche :

   

6. Dans le volet gauche, sélectionnez Installé. L’extension Microsoft 365 Agents Toolkit est disponible.

   

Configurer votre locataire de développement Teams

Un locataire est comme un espace ou un conteneur pour votre organization dans Teams, où vous discutez, partagez des fichiers et exécutez des réunions. Cet espace est également l’endroit où vous chargez et testez votre application personnalisée. Vérifions si vous êtes prêt à développer avec le locataire.

Rechercher l’option de chargement d’application personnalisée

Après avoir créé l’application, vous devez charger votre application dans Teams sans la distribuer. Ce processus est appelé chargement d’application personnalisée. Connectez-vous à votre compte Microsoft 365 pour afficher cette option.

Disposez-vous déjà d’un locataire et d’un accès administrateur ? Nous allons case activée si vous le faites !

Vérifiez si vous pouvez charger des applications personnalisées dans Teams :

1. Ouvrez Microsoft Teams, sélectionnez l’icône Applications .

2. Sélectionnez Gérer vos applications.

3. Sélectionnez Charger une application.

4. Recherchez l’option Charger une application personnalisée . Si vous voyez l’option , le chargement d’applications personnalisées est activé.

   

Créer un locataire développeur Teams gratuit (facultatif)

Si vous n’avez pas de compte Teams, vous pouvez l’obtenir gratuitement. Rejoignez le programme des développeurs Microsoft 365 !

1. Accédez auProgramme pour les développeurs Microsoft 365.

2. Sélectionnez Rejoindre maintenant et suivez les instructions à l’écran.

3. Dans l’écran d’accueil, sélectionnez Configurer l’abonnement E5.

4. Configurez votre compte d’administrateur. Une fois que vous avez terminé, l’écran suivant s’affiche :

   

5. Connectez-vous à Teams à l’aide du compte d’administrateur que vous avez configuré. Vérifiez que vous disposez de l’option Charger une application personnalisée dans Teams.

Obtenir un compte Azure gratuit

Si vous souhaitez héberger votre application ou accéder aux ressources dans Azure, vous devez disposer d’un abonnement Azure. Créez un compte gratuit avant de commencer.

Vous disposez maintenant de tous les outils pour configurer votre compte. Ensuite, nous allons configurer votre environnement de développement et commencer à créer ! Sélectionnez d’abord l’application que vous souhaitez créer.

Créer un espace de travail de projet pour votre application d’onglet à l’aide de C sharp

Démarrez le développement d’applications Microsoft Teams en créant votre première application. Cette application utilise la fonctionnalité d’onglet. Si les conditions préalables sont en place, commençons !

Les étapes suivantes vous aident à créer un espace de travail de projet pour votre application d’onglet dans Visual Studio :

1. Ouvrez Visual Studio.

2. Sélectionnez Nouveau projet.

   

3. Dans la zone de recherche, entrez Teams.

4. Sélectionnez Agents >Microsoft 365Suivant.

   

5. Entrez les informations suivantes pour configurer votre nouveau projet.

6. Entrez le nom de projet requis dans Nom du projet.

7. Sélectionnez l’emplacement requis pour enregistrer les fichiers et dossiers du projet.

8. Sélectionnez Créer.

   

9. Sélectionnez Tab Créer>.

   

L’application d’onglet Teams est créée en quelques secondes.

Créer et exécuter votre première application d’onglet à l’aide de C sharp

Après avoir configuré votre espace de travail de projet avec Agents Toolkit, générez votre application d’onglet.

Connectez-vous à votre compte Microsoft 365

Utilisez votre compte Microsoft 365 pour vous connecter à Teams. Si vous utilisez un locataire du programme de développement Microsoft 365, le compte d’administrateur que vous avez configuré lors de l’inscription est votre compte Microsoft 365.

1. Dans le Explorateur de solutions, sous Solution MyTeamsApp, cliquez avec le bouton droit sur MyTeamsApp.

2. Sélectionnez Microsoft 365 Agents Toolkit>Sélectionnez compte Microsoft 365.

   

3. SélectionnezCompte>Microsoft 365Continuer.

   

Générer et exécuter votre application localement dans Visual Studio

Pour créer et exécuter votre application localement :

1. Sélectionnez Déboguer>Démarrer le débogage ou F5.

   

   Visual Studio démarre le processus de débogage et ouvre le client web Teams dans un navigateur. Si vous y êtes invité, connectez-vous à l’aide de votre compte Microsoft 365.

2. Sélectionnez Ajouter.

   

3. Sélectionnez Ouvrir pour ouvrir l’application dans l’étendue personnelle.

Vous pouvez également rechercher et sélectionner l’étendue requise, ou sélectionner un canal ou une conversation dans la liste, puis parcourir la boîte de dialogue pour sélectionner Accéder.

Félicitations, votre première application d’onglet s’exécute sur Teams !

Vous avez créé une application d’onglet à l’aide de C#. Agents Toolkit a ajouté la structure nécessaire à la structure de répertoires de votre application. Le didacticiel est maintenant terminé.

Ce guide pas à pas vous aide à créer des onglets et des extensions de message permettant Microsoft Entra’authentification unique. Vous verrez la sortie suivante :

Conditions préalables à l’ajout de l’authentification unique aux applications

Veillez à installer les outils suivants et à configurer votre environnement de développement :

Configurer l’environnement local

1. Ouvrez Microsoft-Teams-Samples.

2. Sélectionnez Code.

3. Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.

   

4. Sélectionnez Cloner.

Inscrire Microsoft Entra application

Les étapes suivantes vous aident à créer et à inscrire votre bot dans Portail Azure :

• Créez et inscrivez votre application Azure.
• Créez une clé secrète client pour activer l’authentification unique du bot.
• Ajoutez un canal Teams pour déployer le bot.
• Créez un tunnel vers les points de terminaison de votre serveur web à l’aide du tunnel de développement (recommandé) ou de ngrok.
• Ajoutez un point de terminaison de messagerie au tunnel de développement que vous avez créé.

Ajouter une inscription d’application

1. Accédez au portail Azure.

2. Sélectionner les inscriptions d’applications.

   

3. Sélectionnez + Nouvelle inscription.

   

4. Entrez le nom de votre application.

5. Sélectionnez Comptes dans n’importe quel annuaire organisationnel (n’importe quel locataire Microsoft Entra ID - Multilocataire).

6. Sélectionner Inscription.

   

   Votre application est inscrite dans Microsoft Entra ID. La page vue d’ensemble de l’application s’affiche.

   

   Remarque

   Enregistrez l’ID d’application à partir de l’ID d’application (client) et de l’ID d’annuaire (locataire) pour une utilisation ultérieure.

Créer un tunnel

Sélectionnez l’une des méthodes suivantes pour créer un tunnel :

ngrok http --host-header=localhost xxxx

Ajouter une authentification web

1. Dans le volet gauche, sous Gérer, sélectionnez Authentification.

2. Sélectionnez Ajouter une plateforme>web.

   

3. Entrez l’URI de redirection de votre application en ajoutant auth-end au nom de domaine complet. Par exemple : https://your-devtunnel-domain/auth-end ou https://your-ngrok-domain/auth-end.

4. Sous Octroi implicite et flux hybrides, cochez les cases Jetons d’accès et jetons d’ID .

5. Sélectionnez Configurer.

   

6. Sous Web, sélectionnez Ajouter un URI.

7. Entrez https://token.botframework.com/.auth/web/redirect.

8. Sélectionnez Enregistrer.

   

Créer une clé secrète client

1. Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.

2. Sous Clés secrètes client, sélectionnez + Nouvelle clé secrète client.

   

   La fenêtre Ajouter une clé secrète client s’affiche.

3. Entrez Description.

4. Sélectionnez Ajouter.

   

5. Sous Valeur, sélectionnez Copier dans le Presse-papiers pour enregistrer la valeur de clé secrète client en vue d’une utilisation ultérieure.

   

Ajouter des autorisations d'API

1. Dans le volet gauche, sélectionnez Autorisations d’API.

2. Sélectionnez + Ajouter une autorisation.

   

3. Sélectionnez Microsoft Graph.

4. Sélectionnez Autorisations déléguées.

5. Sélectionnez User>User.Read.

6. Sélectionnez Ajouter des autorisations.

   

   Remarque

   • Si une application ne reçoit pas le consentement de l’administrateur informatique, les utilisateurs doivent fournir le consentement la première fois qu’ils utilisent une application.
   • Les utilisateurs doivent donner leur consentement aux autorisations d’API uniquement si l’application Microsoft Entra est inscrite dans un autre locataire.

Ajouter un URI d’ID d’application

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. En regard de URI d’ID d’application, sélectionnez Ajouter.

   

3. Mettez à jour l’URI de l’ID d’applicationapi://your-devtunnel-domain/botid-{AppID} au format ou et api://your-ngrok-domain/botid-{AppID} sélectionnez Enregistrer.

   

   L’image suivante montre le nom de domaine :

   

Ajouter une étendue

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. Sélectionnez + Ajouter une étendue.

   

3. Entrez access_as_user comme nom de l’étendue.

4. Sous Qui peut donner son consentement ?, sélectionnez Administrateurs et utilisateurs.

5. Mettez à jour les valeurs du reste des champs comme suit :

   • Entrez Teams peut accéder au profil de l’utilisateur en tant que nom d’affichage de consentement Administration.

   • Entrez Permet à Teams d’appeler les API web de l’application en tant qu’utilisateur actuelAdministration description du consentement.

   • Entrez Teams peut accéder au profil utilisateur et effectuer des demandes au nom de l’utilisateur en tant que nom d’affichage du consentement de l’utilisateur.

   • Entrez Autoriser Teams à appeler les API de cette application avec les mêmes droits que l’utilisateur comme description du consentement de l’utilisateur.

6. Vérifiez que State est défini comme Enabled.

7. Sélectionnez Ajouter une étendue.

   L’image suivante montre les champs et les valeurs :

   

   Remarque

   Le nom de l’étendue doit correspondre à l’URI d’ID d’application avec /access_as_user ajouté à la fin.

   

Ajouter une application cliente

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

   Sous Applications clientes autorisées, identifiez les applications que vous souhaitez autoriser pour l’application web de votre application.

2. Sélectionnez + Ajouter une application cliente.

   

3. Ajoutez Teams mobile ou de bureau et l’application web Teams.

   1. Pour Teams mobile ou de bureau : entrez l’ID client sous la forme 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. Pour le web Teams : entrez l’ID client en tant que 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Cochez la case Étendues autorisées .

5. Sélectionnez Ajouter une application.

   

   L’image suivante affiche l’ID client :

   

Mise à jour du manifeste

1. Dans le volet gauche, sélectionnez Manifeste.

2. Définissez la valeur de sur requestedAccessTokenVersion2 et sélectionnez Enregistrer.

   

Créer un bot

Créer une ressource de bot Azure

1. Accéder à l’Accueil

2. Sélectionnez + Créer une ressource.

3. Dans la zone de recherche, entrez Azure Bot.

4. Ensuite, sélectionnez Entrée.

5. Sélectionnez Azure Bot.

6. Sélectionnez Créer.

   

7. Entrez le nom du bot dans Descripteur de bot.

8. Sélectionnez votre abonnement dans la liste déroulante.

9. Sélectionnez votre groupe de ressources dans la liste déroulante.

   

   Si vous n’avez pas de groupe de ressources existant, vous pouvez en créer un. Pour créer un groupe de ressources, procédez comme suit :

   1. Sélectionnez Créer.
   2. Entrez le nom de la ressource et sélectionnez OK.
   3. Sélectionnez un emplacement dans la liste déroulante Nouvel emplacement du groupe de ressources .

   

10. Sous Tarification, sélectionnez Modifier le plan.

    

11. Sélectionnez FO Free>Select.

    

12. Sous ID d’application Microsoft, sélectionnez Type d’applicationcomme multilocataire.

13. Dans Type de création, sélectionnez Utiliser l’inscription d’application existante.

14. Entrez l’ID d’application.

    Remarque

    Vous ne pouvez pas créer plusieurs bots avec le même ID d’application Microsoft.

15. Sélectionnez Examiner et créer.

    

16. Une fois la validation réussie, sélectionnez Créer.

    L’approvisionnement du bot prend quelques minutes.

17. Sélectionnez Accéder à la ressource.

    

    Vous avez créé votre bot Azure.

    

Ajouter un canal Teams

1. Dans le volet gauche, sélectionnez Canaux.

2. Sous Canaux disponibles, sélectionnez Microsoft Teams.

   

3. Cochez la case pour accepter les conditions d’utilisation du service.

4. Sélectionnez Accepter.

   

5. Sélectionnez Appliquer.

   

Pour ajouter un point de terminaison de messagerie

Ajouter des paramètres de connexion OAuth

1. Dans le volet gauche, sélectionnez Configuration.

2. Sélectionnez le bouton Ajouter des paramètres de connexion OAuth.

3. Sous Nouveau paramètre de connexion, mettez à jour les informations suivantes :

   • Nom : entrez un nom pour votre nouveau paramètre de connexion. Vous pouvez utiliser le nom dans les paramètres de votre code de service de bot.
   • Fournisseur de services : dans la liste déroulante, sélectionnez Azure Active Directory v2.
   • ID client : Mettez à jour votre ID d’application Microsoft.
   • Clé secrète client : Mettez à jour la valeur des secrets client.
   • URL d’échange de jetons : mettez à jour l’URI de l’ID d’application.
   • ID de locataire : entrez Commun.
   • Étendues : entrez User.Read.

4. Sélectionnez Enregistrer.

   

Configurer les paramètres de l’application

1. Accédez au fichier appsettings.json dans le dépôt cloné.

   

2. Ouvrez le fichier appsettings.json dans Visual Studio.

3. Mettez à jour les informations suivantes :

   • Remplacez par "MicrosoftAppId"l’ID d’application Microsoft de votre bot.
   • Remplacez par "MicrosoftAppPassword" la valeur des secrets clients de votre bot.
   • Remplacez par "SiteUrl" votre URL ngrok.
   • Remplacez par "ConnectionName" le nom du paramètre de connexion OAuth.
   • Remplacez par "TenantId" l’ID de locataire du locataire où l’application est utilisée.
   • Remplacez par "ClientId"l’ID d’application Microsoft de votre bot.
   • Remplacez par "AppSecret" la valeur des secrets clients de votre bot.
   • Remplacez "ApplicationIdURI" sous la forme .api://*******.ngrok.io/botid-{AppID}

   

Configurer le fichier manifeste

1. Accédez au fichier manifest.json dans le dépôt cloné.

   

2. Ouvrez le fichier manifest.json dans Visual Studio et apportez les modifications suivantes :

   • Remplacez par DOMAIN-NAME votre URL ngrok.

   • Remplacez par YOUR-MICROSOFT-APP-IDl’ID d’application Microsoft de votre bot.

     Remarque

     Selon le scénario [YOUR-MICROSOFT-APP-ID] et [DOMAIN-NAME] peut se produire plusieurs fois.

   • Remplacez par resourceapi://*******.ngrok.io/botid-{AppID}.
     

     

Générer et exécuter le service

Pour générer et exécuter le service, utilisez Visual Studio ou la ligne de commande.

dotnet run