Démarrage rapide : Configurer et exécuter l’exemple d’assistant JavaScript LangChain

Dans ce guide de démarrage rapide, parcourez la configuration d’un assistant JavaScript LangChain fonctionnel utilisant l’outillage Agent 365, les notifications, l’observabilité, ainsi que le test de l’assistant à l’aide d’Agents Playground et de Teams.

Prerequisites

Si vous envisagez d’utiliser Visual Studio Code, vous devez avoir .NET installé. (.NET 8.0 est recommandé.)
Node.js (version 18 ou ultérieure)
LangChain
Aire de jeu des agents
L’accès à Npm (Node Gestionnaire de package) est installé avec NodeJS
Accès à GitHub
Un projet d'agent IA existant. Ce guide de démarrage rapide utilise un agent modèle Agent 365 à partir du kit de ressources d'agent Microsoft 365, également appelé ATK dans VS Code.
CLI A365
Authentification d’identité de l’assistant

Configurer l'exemple LangChain + Node.js du Toolkit d'agents de Microsoft 365

Pour préparer tout ce qui est prêt, vous installez le kit de ressources Microsoft 365 Agents dans VS Code, ouvrez l’exemple de galerie et créez la structure de l’exemple LangChain + Node.js localement afin de pouvoir le configurer et l’exécuter ultérieurement. Les captures d’écran suivantes montrent ce à quoi vous pouvez vous attendre au fil de la procédure.

Ouvrez Visual Studio Code, ouvrez ensuite le panneau Extensions panneau Ctrl+Shift+X.
Dans la barre de recherche, saisissez « Agents Toolkit ».
Vous devez voir le résultat affiché dans la capture d’écran ici :
Sélectionnez Outils pour agents Microsoft 365.
Sélectionnez Installer.

VS Code affiche une vue des détails de l’extension similaire à celle-ci :
Une fois installé, l’icône Kit d’outils M365 Agents s’affiche dans la barre de navigation de gauche.
Sélectionnez-la pour ouvrir l’écran d’accueil.

Vous devez maintenant voir des options telles que Générer un assistant déclaratif, Créer un assistant/une application et Afficher des exemples, comme illustré ici :
Sélectionnez Afficher des exemples.
Dans la liste des échantillons, faites défiler pour trouver l’échantillon d'agent LangChain + Node.js.
Sélectionnez-le.

Vous verrez deux choix : Create (structure localement) ou View sur GitHub.
Cliquez sur Créer.
Lorsque vous y êtes invité(e), sélectionnez un dossier sur votre ordinateur où l’exemple doit être généré. Par exemple : C:\A365-Ignite-Demo

Le kit d’outils génère automatiquement l’exemple LangChain + Node.js dans un sous-dossier (tel que sample_agent), puis l’ouvre automatiquement dans VS Code.

Une fois l'échafaudage terminé, vous disposez désormais d'un projet d'assistant LangChain + Node.js entièrement fonctionnel sur votre appareil.

Installez les packages Agent 365 requis

Avant d’exécuter l’exemple, ouvrez le fichier package.json dans votre projet et vérifiez que toutes les dépendances Agent 365 et Agent Framework requises sont répertoriées. L’exemple généré par le kit de ressources agents Microsoft 365 inclut déjà ces entrées.

Une fois que vous avez examiné le package.json, installez le tout en exécutant :

npm install

Cette étape télécharge l’ensemble des bibliothèques Agent 365, les dépendances d’Agent Framework, les composants d’hébergement, ainsi que toutes les autres dépendances définies dans l’exemple. Après l’installation, vérifiez que le projet se construit et s’exécute correctement en lançant le serveur de développement

npm run dev

Ajouter des outils Microsoft 365 (serveurs MCP)

Vous pouvez explorer et gérer des serveurs MCP à l’aide des commandes a365 develop de la CLI.

Lorsque vous utilisez les outils MCP de Microsoft, vous pouvez :

Découvrir quels serveurs MCP sont disponibles
Ajouter un ou plusieurs serveurs MCP à votre configuration de l’assistant
Examiner les serveurs MCP actuellement configurés
Supprimer les serveurs MCP dont vous n’avez plus besoin

Une fois les serveurs MCP ajoutés, le manifeste d’outillage de votre assistant s’enrichit pour inclure des entrées similaires à :

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Découvrez comment ajouter et gérer des outils

Abonnement et gestion des notifications

L’exemple d’assistant s’abonne à toutes les notifications Agent 365 au moyen de onAgentNotification("*") et les achemine vers un gestionnaire unique. Ce gestionnaire permet à l’assistant de réagir à des événements en arrière-plan ou à des événements système, et pas uniquement aux messages provenant directement de l’utilisateur.

Découvrez comment notifier des assistants

Le code suivant montre comment la notification est configurée dans le fichier agent.ts.

constructor() {
   super();

   this.onAgentNotification("agents:*", async(context, state, activity) => {

      await this.handleAgentNotificationActivity(context, state, activity);

   });
}

async handleAgentNotificationActivity(context, state, activity)
{
   await context.sendActivity("Received an AgentNotification!");

   // Add custom handling here
}

Observability

Important

Cet échantillon utilise le SDK d’observabilité Agent 365, déprécié. N’utilisez pas ce modèle pour une nouvelle intégration d’observabilité. Utilisez plutôt la distribution Microsoft OpenTelemetry.

L’extrait suivant initialise le SDK d’observabilité obsolète d’Agent 365 et enveloppe chaque invocation d’agent dans un InferenceScope, afin que les entrées, les sorties et les métadonnées puissent être capturées automatiquement.

Le code suivant montre un exemple d’observabilité rationalisée dans le fichier client.ts.

const sdk = ObservabilityManager.configure(b =>
   b.withService('<service-name>', '<version>')
);

sdk.start();

async invokeAgentWithScope(prompt: string) {

   const scope = InferenceScope.start(
      { 
         operationName: InferenceOperationType.CHAT, 
         model: '<llm-name>' 
      },
      { 
         agentId: '<agent-id>', 
         agentName: '<agent-name>', 
         conversationId: '<conv-id>' 
      },
      { tenantId: '<tenant-id>' }
   );

   const response = await this.invokeAgent(prompt);
   scope?.recordInputMessages([prompt]);
   scope?.recordOutputMessages([response]);
   scope?.recordResponseId(`resp-${Date.now()}`);
   return response;

}

Cet extrait montre le motif SDK d’observabilité Agent 365 obsolète utilisé par l’échantillon Node.js + LangChain. Pour les conseils complets de configuration et de migration, consultez la documentation du SDK obsolète.

Tester votre assistant

Définissez les variables d’environnement requises, choisissez un mode d’authentification et démarrez l’assistant en local. Vous pouvez tester tout de bout en bout avec Agents Playground sans avoir besoin d’un locataire Microsoft 365, sauf si vous souhaitez publier l’agent et l’utiliser dans des applications telles que Teams ou Outlook. Reportez-vous aux étapes détaillées décrites dans En savoir plus sur les tests pour configurer le test de l’assistant avec Agents Playground.

Vue d’ensemble des étapes de test

Ajoutez vos clés API et vos paramètres de modèle à un fichier .env afin que l’exemple puisse communiquer avec un grand modèle de langage.
Choisissez votre mode d’authentification. Pour le développement en local, l’exemple prend en charge l’authentification agentique à l’aide des valeurs créées à partir de votre blueprint d’assistant.
Démarrez l'agent localement, ce qui l'expose à des outils comme Agents Playground.
Utiliser Agents Playground pour tester les messages, les outils et les notifications sans configurer un locataire ou déployer quoi que ce soit.
Lorsque vous êtes prêt pour un comportement en conditions réelles, publiez un client Microsoft 365 et testez l'agent dans Teams, dans Outlook, ou sur d'autres surfaces Microsoft 365.

Publier votre agent

Lorsque votre agent est prêt pour des expériences authentiques de Microsoft 365 telles que les conversations Teams, les messages Outlook, Word @mentions, vous le publiez sur un client Microsoft 365. La commande CLI publish Agent 365 gère l’emballage : elle met à jour votre manifeste, regroupe tout et télécharge l’agent dans le centre d’administration Microsoft.

Lors de la publication, révisez et personnalisez le nom, la description, les icônes et la version de l’assistant avant de finaliser le chargement. Une fois publié, votre assistant est alors enregistré et installable au sein du locataire.

Important

Après avoir publié votre agent, vous devez configurer le blueprint de l’agent dans le Portail Développeur avant de créer des instances. Apprenez à configurer le plan d’agent dans le Portail développeur

Vous pouvez voir les assistants publiés ici : https://admin.cloud.microsoft/#/agents/all

En savoir plus sur le flux de travail complet et les instructions pas à pas

Commentaires

Cette page a-t-elle été utile ?

Dernière mise à jour : 2026-10-02