Déboguer votre Teams application

Agent Toolkit crée Microsoft Entra applications pour les projets avec bot par défaut à l’aide d’une botAadApp/create action.

Pour utiliser un bot existant, vous pouvez définir BOT_ID et SECRET_BOT_PASSWORD avec env/.env.local vos propres valeurs.

Utilisez l’exemple d’extrait de code suivant pour configurer un bot existant pour le débogage :

# env/.env.local

# Built-in environment variables
TEAMSFX_ENV=local

# Generated during provision, you can also add your own variables.
BOT_ID={YOUR_OWN_BOT_ID}
...

SECRET_BOT_PASSWORD={YOUR_OWN_BOT_PASSWORD}
...

> "prerequisites" "Validate prerequisites" "args" >Sous .vscode/tasks.json , mettez à jour les vérifications de prérequis que vous souhaitez ignorer.

1. Dans m365agents.local.yml, supprimez devCert de l’action devTool/install (ou supprimez l’action entière devTool/install si elle contient devCertuniquement ).

2. Dans m365agents.local.yml, définissez "SSL_CRT_FILE" et "SSL_KEY_FILE" en action sur file/createOrUpdateEnvironmentFile le chemin d’accès du fichier de certificat et le chemin du fichier de clé.

   # m365agents.local.yml
   ...
     # Remove devCert or this whole action
     - uses: devTool/install
       with:
         # devCert:
     ...
     - uses: file/createOrUpdateEnvironmentFile
       with:
         target: ./.localSettings
         envs:
           ...
           # set your own cert values
           SSL_CRT_FILE: ...
           SSL_KEY_FILE: ...
   ...
   

Dans m365agents.local.yml, modifiez args l’action cli/runNpmCommand .

# m365agents.local.yml
...
  - uses: cli/runNpmCommand
    with:
      # edit the npm command args
      args: install --no-audit
...

• Bot

  1. Recherchez "3978" dans votre projet et recherchez des apparences dans tasks.json et index.js.

  2. Remplacez-le par votre port.

     

• Tab

  1. Recherchez "53000" dans votre projet et recherchez des apparences dans m365agents.local.yml et tasks.json.

  2. Remplacez-le par votre port.

     

Agent Toolkit par défaut crée un ensemble d’actions teamsApp pour gérer le package d’application. Vous pouvez les mettre à jour dans m365agents.local.yml pour utiliser votre propre package d’application.

# m365agents.local.yml
...
  - uses: teamsApp/create # Creates a Teams app
    ...
  - uses: teamsApp/validateManifest # Validate using manifest schema
    ...
  - uses: teamsApp/zipAppPackage # Build Teams app package with latest env value
    ...
  - uses: teamsApp/validateAppPackage # Validate app package using validation rules
    ...
  - uses: teamsApp/update # Apply the app manifest (previously called Teams app manifest) to an existing Teams app in Teams Developer Portal.
    ...
...

"Start Teams App Locally"Sous .vscode/tasks.json , vous pouvez mettre à jour "Start Local tunnel".

# env/.env.local

# Built-in environment variables
TEAMSFX_ENV=local
...
BOT_DOMAIN={YOUR_OWN_TUNNEL_DOMAIN}
BOT_ENDPOINT={YOUR_OWN_TUNNEL_URL}
...

# env/.env.local

# Built-in environment variables
TEAMSFX_ENV=local
...
BOT_DOMAIN={YOUR_OWN_TUNNEL_DOMAIN}
BOT_ENDPOINT={YOUR_OWN_TUNNEL_URL}
...

Vous pouvez ajouter des variables d’environnement à .localConfigs fichier pour l’onglet, le bot, l’extension de message et Azure Functions. Agents Toolkit charge les variables d’environnement que vous avez ajoutées pour démarrer les services pendant le débogage local.

Agent Toolkit utilise Visual Studio Code débogage multi-cible pour déboguer l’onglet, le bot, l’extension de message et Azure Functions en même temps. Vous pouvez mettre à jour .vscode/launch.json et .vscode/tasks.json déboguer un composant partiel. Si vous souhaitez déboguer l'onglet uniquement dans un projet tab plus bot avec Azure Functions, utilisez les étapes suivantes :

1. Mettez à jour "Attach to Bot" et "Attach to Backend" à partir du composé de débogage dans .vscode/launch.json.

   {
       "name": "Debug in Teams (Edge)",
        "configurations": [
           "Attach to Frontend (Edge)",
           // "Attach to Bot",
           // "Attach to Backend"
           ],
           "preLaunchTask": "Start Teams App Locally",
           "presentation": {
               "group": "all",
               "order": 1
           },
           "stopAll": true
   
   }
   

2. Mettre à jour "Start Backend" et "Start Bot" à partir de la tâche Démarrer tout dans .vscode/tasks.json.

   {
   
       "label": "Start application",
       "dependsOn": [
           "Start Frontend",
             // "Start Backend",
             // "Start Bot"
   
         ]
   
   }
   

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.

   

7. Dans le volet gauche, sélectionnez Certificats & secrets pour créer une clé secrète client pour votre application.

   1. Sous Clés secrètes client, sélectionnez ➕ Nouvelle clé secrète client.
   2. Ajoutez une description pour identifier ce secret auprès d’autres personnes que vous devrez peut-être créer pour cette application, comme l’application d’identité bot dans Teams.
   3. Configurez la Date d’expiration de votre sélection.
   4. Sélectionnez Ajouter.

8. Mettez à jour le .env fichier avec le secret du bot.

9. Provisionnez ou déployez l’application en fonction des besoins.

10. Si votre application est déjà déployée, veillez à mettre à jour la configuration app service dans la ressource Azure avec le secret du bot nouvellement créé.