Créer un premier agent Python avec Microsoft Agent Framework

Microsoft Agent Framework est le successeur recommandé d’AutoGen et de Semantic Kernel pour les nouveaux projets Microsoft. Il sépare le client de modèle, l’agent, ses outils et son état conversationnel afin de faire évoluer chaque partie indépendamment.

Préparer le projet

Créez un environnement virtuel et installez le paquet correspondant au fournisseur utilisé. Les noms de paquets évoluent rapidement : vérifiez la commande exacte dans le guide officiel avant de figer vos dépendances.

python -m venv .venv
source .venv/bin/activate
pip install agent-framework
export OPENAI_API_KEY="votre-cle"

Conservez les secrets hors du dépôt et verrouillez les versions dans votre gestionnaire de dépendances.

Créer l’agent

Le principe est de construire un client, puis de l’associer à un agent avec des instructions explicites :

import asyncio
from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient

async def main():
    agent = Agent(
        name="assistant",
        instructions="Réponds en français et cite tes hypothèses.",
        client=OpenAIChatClient(model="gpt-5"),
    )
    result = await agent.run("Propose trois noms pour une API météo.")
    print(result)

asyncio.run(main())

Adaptez le modèle et l’authentification à votre fournisseur. Une configuration compatible avec OpenAI, Azure, Anthropic, Ollama ou Microsoft Foundry peut nécessiter un paquet additionnel.

Ajouter un outil sûr

Un outil est une fonction que le modèle peut demander d’exécuter. Donnez-lui un nom clair, des types précis et une portée limitée. Validez toujours les entrées côté code et demandez une confirmation humaine pour toute action irréversible.

Commencez par un outil sans effet externe, par exemple une conversion d’unité. Vérifiez ensuite dans les traces que l’agent appelle l’outil uniquement lorsque nécessaire et restitue correctement son résultat.

Conserver une conversation

Utilisez une session distincte par utilisateur ou conversation pour maintenir l’état entre les appels. Ne partagez jamais une session entre clients. Définissez aussi une durée de conservation et une procédure de suppression.

Avant la production, testez les erreurs du fournisseur, les délais, les boucles d’outils et les coûts. Un agent utile doit échouer proprement et rester observable, pas seulement réussir sa démonstration nominale.