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

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.

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

Configurez l’exemple Claude + 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 Claude + Node.js en local 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+Maj+X), recherchez Kit d’outils Microsoft 365 Agents, puis sélectionnez Installer.
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 la génération de la structure terminée, vous disposez d’un projet exécutable. Les étapes suivantes se déroulent dans le nouveau dossier de l’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 connecte ces serveurs MCP à votre orchestrateur Claude, afin que le SDK de l’assistant puisse appeler les outils Microsoft 365 directement, conformément aux compétences définies dans votre plan d’assistant 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 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.

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

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