Aller au contenu

TechnologieBase de connaissances

Pydantic AI

SFEIR AI Rédaction humaine et IA · Comment nous écrivons
Publié le

En bref

Framework Python d'agents (MIT) de l'équipe Pydantic : sorties validées, dépendances typées, traces OpenTelemetry ; v2 depuis le 23 juin 2026.

Typé de bout en bout

Pydantic AI est le framework d'agents de l'équipe qui maintient Pydantic, la bibliothèque de validation de données de Python. Il en reprend la logique : la sortie d'un agent est validée contre un modèle Pydantic, et le schéma JSON de chaque outil se déduit des annotations de type de la fonction.

L'injection de dépendances fait passer connexions et contexte à l'agent et à ses outils sans état global. L'agent déclare un type de dépendances, chaque outil reçoit un contexte d'exécution typé, et un test remplace la vraie base de données par une doublure. Deux bibliothèques complètent le framework : Pydantic Graph pour les workflows en graphe, Pydantic Evals pour l'évaluation.

Traces OpenTelemetry

Pydantic AI émet ses traces au standard OpenTelemetry. Logfire, le service d'observabilité commercial de Pydantic, s'y branche en deux appels, mais tout autre backend OpenTelemetry convient.

Versions

La v1.0.0 date du 4 septembre 2025 ; l'équipe s'engageait alors à ne rien casser jusqu'à la v2. Celle-ci sort le 23 juin 2026. Elle introduit les capabilities, une unité qui regroupe instructions, outils, hooks et réglages de modèle, dont Pydantic AI Harness fournit un premier recueil, allège le cœur (Bedrock, Groq et Mistral deviennent optionnels, OpenAI, Anthropic et Google restent inclus) et ramène de six à trois mois la période sans rupture entre versions majeures.

Voisins

Pydantic AI vise l'agent unique, fiable et testable. Pour coordonner plusieurs agents avec état partagé et reprise, LangGraph et CrewAI sont mieux outillés. Mastra joue un rôle proche en TypeScript. Les sorties validées font de Pydantic AI un bon critique déterministe dans un pattern Générateur-Critique.

Questions fréquentes

  • Faut-il Logfire pour utiliser Pydantic AI ?

    Non. Les traces suivent le standard OpenTelemetry : Logfire s'y branche en deux appels, mais n'importe quel backend OpenTelemetry les reçoit.

  • Quelle version de Pydantic AI utiliser ?

    La v2, version majeure courante depuis le 23 juin 2026. Le guide de migration du changelog liste les changements de comportement, dont le passage des modèles openai: à l'API Responses.

  • Pydantic AI convient-il aux systèmes multi-agents ?

    Il sait déléguer d'un agent à un autre et propose Pydantic Graph, mais son point fort reste l'agent unique typé et testable. Pour un graphe d'agents avec état persistant, LangGraph ou CrewAI sont mieux outillés.

Sources

  1. Pydantic — Pydantic AI, documentation · 2026-11-15
  2. Pydantic — Pydantic AI v2 · 2026-06-23
  3. Pydantic AI — Upgrade Guide (changelog) · 2026-11-15

    In September 2025, Pydantic AI reached V1 and committed to API stability

  4. GitHub — pydantic/pydantic-ai (licence MIT) · 2026-11-15

Passer à l’action

Pydantic AI dans vos projets

Échanger avec SFEIR