Démarrage rapide : Configurer et exécuter l’exemple d’agent d’infrastructure Python Agent

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, découvrez comment configurer un agent d’infrastructure agent Python opérationnel à l’aide de l’agent 365 pour les outils, les notifications, l’observabilité et le test de l’agent à l’aide des agents Playground et Teams.

Prérequis

  • Si vous envisagez d’utiliser Visual Studio Code, vous devez avoir .NET installé. (.NET 8.0 est recommandé.)

  • Python 3.11+ installé

  • Gestionnaire de packages UV installé. Installez-le dans un terminal à l’aide de pip install uv.

  • Dépendances du kit d’outils des assistants Microsoft / Agent Framework

    L’exemple utilisé dans la procédure pas à pas s’appuie sur les bibliothèques Agent Framework fournies via le kit de ressources Microsoft 365 Agents ou ATK. Ces éléments seront installés automatiquement lorsque vous utiliserez l’extension Agents Toolkit dans VS Code pour générer l’exemple, ou vous pouvez installer le package manuellement à l’aide de la commande suivante :

    uv pip install -e . --prerelease=allow

  • Accès à GitHub

  • Un projet d'agent IA existant. Ce guide de démarrage rapide utilise un exemple d’agent 365 à partir du kit d'outils de l'agent Microsoft 365 également appelé ATK dans VS Code.

  • CLI A365

  • Authentification d’identité de l’assistant

Configurer le framework Agent et l'exemple Python à partir du toolkit des agents Microsoft 365

Pour tout préparer, vous installez la trousse à outils Microsoft 365 Agents dans VS Code, ouvrez la galerie d'exemples et déployez le framework d'agents ainsi que l'exemple Python localement afin de pouvoir les configurer et les exécuter ultérieurement. Les captures d’écran suivantes montrent ce à quoi vous pouvez vous attendre au fil de la procédure.

  1. Ouvrez Visual Studio Code, ouvrez ensuite le panneau Extensions panneau Ctrl+Shift+X.

  2. Dans la barre de recherche, saisissez « Agents Toolkit ».
    Vous devez voir le résultat affiché dans la capture d’écran ici :

    Capture d’écran de la recherche « Agents Toolkit » dans la Marketplace des extensions.

  3. Sélectionnez Outils pour agents Microsoft 365.

  4. Sélectionnez Installer.

    VS Code affiche une vue des détails de l’extension similaire à celle-ci :

    Capture d’écran de la page Détails de l’extension avec les boutons Installer et Activer.

  5. Une fois installé, l’icône Kit d’outils M365 Agents s’affiche dans la barre de navigation de gauche.

  6. 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 :

    Capture d’écran de la vue d’accueil du kit d’outils, avec les options « Créer un assistant déclaratif », « Créer un assistant ou une application » et « Voir les exemples ».

  7. Sélectionnez Afficher des exemples.

  8. Dans la liste des exemples, faites défiler pour rechercher l’exemple d’agent Agent framework + Python.

  9. Sélectionnez-le.

    Vous verrez deux choix : Create (structure localement) ou View sur GitHub.

  10. Cliquez sur Créer.

    Capture d'écran de l'agent du framework Agent avec le SDK Agent 365 utilisant un exemple en Python.

  11. 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-python-sample

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

    Une fois la génération de la charpente terminée, vous disposez maintenant d’un framework d’agent entièrement fonctionnel et d’un projet d’agent Python sur votre ordinateur.

  12. Installez les packages Agent 365 requis

    Avant d’exécuter l’exemple, ouvrez le fichier pyproject.toml 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 consulté le pyproject.toml, installez tout en exécutant cette commande :

    uv pip install -e . --prerelease=allow

    Cette étape télécharge l’ensemble des bibliothèques du SDK 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.

  13. Après l’installation, vérifiez que le projet se construit et s’exécute correctement en lançant le serveur de développement à l’aide de cette commande :

    uv run python start_with_generic_host.py

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 du SDK 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.py.

if notification_type == NotificationTypes.EMAIL_NOTIFICATION: 
if not hasattr(notification_activity, "email") or not notification_activity.email: return "I could not find the email notification details."
email = notification_activity.email
email_body = getattr(email, "html_body", "") or getattr(email, "body", "")

message = (
    "You have received the following email. "
    "Please follow any instructions in it. "
    f"{email_body}"
)

result = await self.agent.run(message)
return self._extract_result(result) or "Email notification processed."

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 agent.py.

def _enable_agentframework_instrumentation(self): 
"""Enable Agent Framework instrumentation.""" 
try: 
AgentFrameworkInstrumentor().instrument() 
logger.info("✅ Instrumentation enabled")
 except Exception as e: 
logger.warning(f"⚠️ Instrumentation failed: {e}")

Ce code est la configuration d’observabilité complète requise pour l’exemple d’infrastructure Python + Agent. 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 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, 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

  • Last updated on