Démarrage rapide : Configurer et exécuter l’exemple d’assistant du SDK Assistant Claude JavaScript

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Dans ce guide de démarrage rapide, parcourez la configuration d’un assistant JavaScript Claude 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.

Prérequis

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)
Les packages du SDK Claude Agent et une clé d’API Anthropic
Aire de jeu des agents
Accès aux installations de npm (Node Package Manager)
Accès à GitHub
Un projet d'agent IA existant. Ce guide de démarrage rapide utilise un exemple d’agent Claude à partir de la galerie Microsoft 365 Agents Toolkit (ATK dans VS Code).
CLI A365
Authentification d’identité de l’assistant

Configurer l’exemple Claude + Node.js à partir du kit de ressources Microsoft 365 Agents

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

Dans Visual Studio Code, ouvrez le panneau Extensions (Ctrl+Shift+X), recherchez Microsoft 365 Agent Toolkit, et sélectionnez Install.
Ouvrez la vue Kit d’outils M365 Agents à partir de la barre d’activité VS Code et choisissez Afficher les exemples.
Sélectionnez l’exemple Claude + Node.js, choisissez Créer, puis choisissez (ou créez) le dossier dans lequel le projet doit être généré (par exemple, C:\A365-Ignite-Demo). Le kit d’outils crée un sous-dossier (par exemple sample_agent) et l’ouvre dans VS Code.

Une fois le processus de génération de la structure terminé, vous avez un projet prêt à être exécuté. Les étapes suivantes se déroulent dans le nouveau dossier d'exemple.

Installez les dépendances et configurez l’environnement

Le fichier package.json généré répertorie déjà les packages nécessaires à l’exemple, installez donc tout en une seule fois :

npm install

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

Le serveur de développement écoute sur le port configuré dans l’exemple (localhost:3978 par défaut) et est prêt à accepter des requêtes depuis Agents Playground ou la CLI.

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. Le package @microsoft/agents-a365-tooling-extensions-claude relie ces serveurs MCP à votre orchestrateur Claude afin que le Kit de développement logiciel (SDK) de l'Agent puisse appeler les outils de Microsoft 365 conformément aux compétences définies dans votre plan d'agent Claude.

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. Mettez à jour src/client.ts pour initialiser le SDK d’observabilité Agent 365 et encapsuler chaque invocation de l’assistant dans un InferenceScope, afin que les entrées, les sorties et les métadonnées puissent être capturées automatiquement.

import {
  InferenceOperationType,
  InferenceScope,
  ObservabilityManager
} from '@microsoft/agents-a365-observability';

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;
}

Ce code constitue la configuration complète d’observabilité requise pour l’exemple Node.js + Claude. Remplacez les métadonnées de remplacement par les valeurs que vous avez déjà configurées pour l’assistant. 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 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.

Vue d’ensemble des étapes de test

Ajoutez votre ANTHROPIC_API_KEY et vos paramètres de modèle à un fichier .env afin que l’exemple puisse communiquer avec Claude.
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, Outlook ou d'autres surfaces Microsoft 365.

En savoir plus sur les tests

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 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 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. 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 ?

Last updated on 2026-03-10