Lab ADK : extraire des factures PDF vers la comptabilité

Chaque mois, le service comptable ressaisit des dizaines de factures fournisseurs : numéro, dates, lignes, HT, TVA, TTC. C'est lent, et une facture fausse (un total qui ne correspond pas aux lignes, une TVA mal calculée) passe parfois inaperçue. Dans ce lab, un agent ADK lit les factures, et du code Python vérifie tout ce qui peut l'être avant de produire les écritures comptables.

Pour qui ?

• Vous connaissez Python et les bases d'ADK (un Agent, un Runner).
• Pas besoin d'être comptable : les trois comptes utilisés sont expliqués.
• Aucun projet Google Cloud n'est nécessaire.

Ce que vous allez construire

flowchart LR
  P["factures/*.pdf (fictives)"] --> T["pypdf : texte"]
  T --> A["Agent ADK extracteur (output_schema = Facture)"]
  A --> J["JSON validé par pydantic"]
  J --> C{"Contrôles Python"}
  C -->|"cohérente"| E["ecritures.csv (journal des achats)"]
  C -->|"anomalie"| X["anomalies.json : à vérifier"]

1. generer_factures.py crée quatre factures PDF fictives avec ReportLab, dont trois avec un défaut volontaire.
2. factures.py extrait chaque facture en JSON contraint par un schéma pydantic, applique cinq contrôles de cohérence, écrit ecritures.csv pour les factures saines et anomalies.json pour toutes.
3. test_factures.py teste les contrôles et la chaîne complète sans clé d'API.

Prérequis techniques

• Python 3.10 ou plus récent, une clé d'API Gemini.
• requirements.txt : google-adk==2.10.0, pypdf, reportlab, pydantic>=2, python-dotenv, pytest.

Programme

En local ou sur Google Cloud ?

Code complet : files/. Testé le 2026-10-15 avec google-adk 2.10.0 et gemini-3.5-flash.