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.

Configuration requise

Si vous envisagez d’utiliser Visual Studio Code, vous devez installer .NET. (.NET 8.0 est recommandé.)
Node.js (version 18 ou ultérieure)
LangChain
Agents Playground
L’accès à Npm (Node Package Manager) est configuré avec NodeJS
Accès à GitHub
Un projet Assistant IA existant. Ce démarrage rapide utilise un exemple d’assistant Agent 365 à partir du kit d’outils Microsoft 365 Agent également appelé ATK dans VS Code.
CLI A365
Authentification d’identité de l’assistant

Configurez l’exemple LangChain + Node.js à partir du kit d’outils Microsoft 365 Agents

Pour tout préparer, installez le kit d’outils Microsoft 365 Agents dans VS Code, ouvrez la galerie d’exemples et générez la structure de l’exemple LangChain + Node.js en local 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, puis ouvrez le panneau ExtensionsCtrl+Maj+X.
Dans la barre de recherche, saisissez « Agents Toolkit ».
Vous devez voir le résultat affiché dans la capture d’écran ici :
Sélectionnez Kit d’outils Microsoft 365 Agents.
Cliquez sur 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 exemples, faites défiler pour rechercher l’exemple d’assistant LangChain + Node.js .
Sélectionnez-le.

Vous verrez deux choix : Créer (structurer localement) ou Afficher 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 la génération du projet terminée, vous disposez 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 d’outils Microsoft 365 Agents 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 travaillez avec des serveurs mCP, 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
}

Observabilité

Cet extrait de code montre les modifications minimales nécessaires pour activer l’observabilité dans l’exemple. Il initialise le SDK d’observabilité Agent 365 et encapsule chaque invocation d’assistant 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 illustre le modèle de base permettant d’activer l’observabilité dans l’exemple Node.js + LangChain. Pour obtenir la configuration complète de l’observabilité, consultez En savoir plus sur l’observabilité

Tester votre assistant

Définissez les variables d’environnement requises, choisissez un mode d’authentification et démarrez l’assistant en local. Vous pouvez tout tester de bout en bout avec Agents Playground sans avoir besoin d’un locataire Microsoft 365, sauf si vous souhaitez publier l’assistant et l’utiliser dans des applications comme 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émarrer l’assistant localement, ce qui l’expose à des outils tels qu’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 serez prêt pour un comportement en conditions réelles, publiez dans un locataire Microsoft 365 et testez l’assistant dans Teams, Outlook ou d’autres surfaces Microsoft 365.

Publier votre agent

Lorsque votre assistant est prêt pour de véritables expériences Microsoft 365, comme des conversations Teams, des messages Outlook ou des @mentions dans Word, vous le publiez dans un locataire Microsoft 365. La commande Agent 365 CLIpublish gère l’empaquetage : elle met à jour votre manifeste, regroupe tous les éléments et charge l’assistant 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 devient découvrable 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. Voir 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 ?

Last updated on 2025-12-18