1 Prérequis Participants

Adservio — Workshop Agents IA

1.1 Avant le Workshop

1.1.1 Obligatoire

• Python 3.10+ installé et fonctionnel

  python --version  # >= 3.10

• Git configuré avec accès aux repos Adservio

  git clone git@github.com:Adservio-Dev/<repo-test>.git

• Claude Pro Max — licence activée

  • Tester : https://claude.ai → conversation fonctionnelle

• Claude Code CLI installé (recommandé)

  claude --version

• Éditeur avec support Python (VS Code recommandé)

1.1.2 Selon le Parcours

1.1.2.1 Parcours A — Testing Agent

• pytest installé

  pip install pytest pytest-cov
  pytest --version

1.1.2.2 Parcours B — RAG Code/Docs

• Dépendances RAG

  pip install faiss-cpu sentence-transformers
  # ou alternative : pip install rank-bm25

1.1.2.3 Parcours C — MCP Server

• MCP SDK

  pip install mcp

• Claude Desktop ou Claude Code configuré pour MCP

1.2 Vérification Rapide

Exécutez ce script pour valider votre environnement :

#!/bin/bash
echo "=== Vérification Environnement ==="

echo -n "Python: "
python --version 2>&1 || echo "NON INSTALLÉ"

echo -n "Git: "
git --version 2>&1 || echo "NON INSTALLÉ"

echo -n "pytest: "
python -c "import pytest; print(pytest.__version__)" 2>&1 || echo "NON INSTALLÉ"

echo -n "Claude CLI: "
claude --version 2>&1 || echo "NON INSTALLÉ (optionnel)"

echo "=== Fin ==="

1.3 Ce qu’on Suppose Acquis

• Vous savez coder en Python
• Vous savez utiliser Git (clone, commit, push)
• Vous avez déjà utilisé un LLM (ChatGPT, Claude, etc.)
• Vous savez lire de la documentation technique

On n’expliquera pas : ce qu’est un test, ce qu’est un vecteur, ce qu’est une API.

1.4 Ce qu’on Va Apprendre

• Comment travailler avec un agent (pas juste l’utiliser)
• Pourquoi la traçabilité est non-négociable
• Comment distinguer raisonnement et exécution
• Où les agents échouent silencieusement

1.5 En Cas de Problème

1. Vérifiez ce document
2. Demandez à un collègue du même parcours
3. Contactez l’animateur avant le workshop

Checklist à valider au plus tard la veille du workshop.