Les scripts du projet 09 : lequel sert à quoi

Chaque script commence par un en-tête détaillé : ce qu'il fait, quand l'utiliser, ses prérequis, toutes ses options avec un exemple, ce qu'il crée ou supprime, le résultat attendu, les erreurs fréquentes. Cette page en donne la carte. Sans argument (ou avec --help pour les scripts Python à options), la plupart affichent leur mode d'emploi.

Avant tout : deux règles

Lancer depuis le dossier du projet, Python du projet activé :

cd ~/Desktop/09-agents-multi-projets-gemini-enterprise && source .venv/bin/activate

Charger la configuration (pour tous les scripts qui touchent Google Cloud). Dans chaque nouveau terminal, et toujours avec source, jamais derrière un | :
```
source scripts/config.sh config/12-1-agents-dans-projet-exp.env      # ou config/12-2-agents-dans-projet-app.env
```
Les scripts lisent alors $PROJET_AGENTS, $REGION, $AGENTS_LISTE, $GE_SA…, sans rien retaper.

Légende du tableau :

👁 = lecture seule, ne change rien ;
♻ = se relance sans danger (ce qui existe est gardé) ;
⚠ = crée ou supprime des ressources dans Google Cloud.

La carte des scripts

Configuration et vérifications

Script	Il sert à	Exemple
`config.sh`	Charger le fichier de configuration dans le terminal : variables pour gcloud, les scripts et Terraform (`TF_VAR_…`, espace de travail), vérification des valeurs, résumé	`source scripts/config.sh config/12-1-agents-dans-projet-exp.env`	👁
`verifier_droits.sh`	Vérifier vos droits sur le projet des agents, étape par étape (OK / MANQUANT + rôle à demander), rôles de groupe compris	`./scripts/verifier_droits.sh`	👁
`verifier_api.sh`	Vérifier des API sur un projet et activer seulement celles qui manquent	`./scripts/verifier_api.sh $PROJET_AGENTS run.googleapis.com cloudbuild.googleapis.com`	♻

Déployer les agents (sans Terraform)

Script	Il sert à	Exemple
`deployer_shell.sh`	Méthode shell sans rien taper : préparer (filtres, dépôt, compte de construction), déployer sur Cloud Run (image par Cloud Build), sur Agent Runtime, déclarer au registre, tester ; `oauth` (API Google des agents OAuth) ; `carte` (la fiche à coller dans Gemini Enterprise). Agents lus dans `AGENTS`	`./scripts/deployer_shell.sh cloudrun` · `… runtime taille`	⚠ ♻
`deployer_agent_runtime.py`	Déployer un agent sur Agent Runtime par l'API (ou en supprimer un)	`python scripts/deployer_agent_runtime.py --projet $PROJET_AGENTS --agent meteo_agent --nom meteo-shell --compte-service …`	⚠ ♻ (refuse un doublon)
`carte_a2a.py`	Écrire la carte A2A d'un agent (à coller dans Gemini Enterprise), ou les variables d'environnement de son service Cloud Run	`python3 scripts/carte_a2a.py meteo https://meteo-a2a-shell-NUM.europe-west1.run.app > carte-meteo.json`	👁

Tester

Script	Il sert à	Exemple
`test_trio.py`	Tests hors ligne des agents de `agents/trio` (outils, Model Armor, catalogue)	`python scripts/test_trio.py` → `tests trio OK (9 scénarios, 6 agents)`	👁
`test_agents.py`	Tests hors ligne des agents du dossier `terraform/` racine (stock, orchestrateur, appel entre agents)	`python scripts/test_agents.py`	👁
`query.py`	Poser une question à un agent Agent Runtime déployé (voir les outils appelés)	`AGENT_NAME=projects/…/reasoningEngines/ID python scripts/query.py - "question"`	👁
`simuler_gemini_enterprise.sh`	Appeler les agents comme le fera Gemini Enterprise, avant de toucher à l'app : `preparer`, `droits`, `tout` (bilan ACCEPTÉ / REFUSÉ), `oauth` (avec / `--sans-jeton`), `retirer-droits` ; ou un agent : `a2a URL`, `runtime NOM` (docs/12-1-5)	`./scripts/simuler_gemini_enterprise.sh tout`	⚠ (simulateur et ses droits seulement)

Les tests des agents déployés sur Cloud Run sont dans 01-bis-cloud-run-a2a/test.sh ; ceux d'Agent Runtime (Terraform) dans 02-bis-agent-runtime/test.sh ; Dialogflow : 04-bis-dialogflow/test.sh.

Agent Registry

Script	Il sert à	Exemple
`registry.py`	Explorer le registre d'un projet (le vôtre ou celui d'une autre équipe) : agents, serveurs MCP, et comment les ajouter	`python scripts/registry.py $PROJET_AGENTS europe-west1`	👁
`autoriser_passerelle.sh`	Mode « Agents depuis Agent Registry » : donner (ou retirer) au compte de l'app le droit de passer la passerelle vers une entrée du registre	`./scripts/autoriser_passerelle.sh meteo-a2a-shell` · `… retirer`	⚠ ♻

Gemini Enterprise (l'app)

Script	Il sert à	Exemple
`connecter_app.sh`	Connecter les agents déployés à l'app : `apps` (trouver APP_ID), `verifier` (lecture seule), `droits` (projet des agents), `ajouter` (dans l'app), `lister`, `retirer` ; liste + confirmation avant tout changement (docs/12-1-4)	`./scripts/connecter_app.sh verifier` · `… droits` · `… ajouter meteo`	👁 / ⚠ ♻
`add_agent_to_ge.sh`	Ajouter à l'app un agent déjà déployé (Agent Runtime ou A2A), avec le droit nécessaire ; lister ; retirer	`./scripts/add_agent_to_ge.sh a2a carte-meteo.json "Météo (A2A)"` · `… list` · `… delete "Météo (A2A)"`	⚠ ♻ (pas de doublon)
`register_agent.sh`	Appelé par Terraform (`PUBLIER=oui`) pour ajouter / retirer un agent de l'app ; remplace sans doublon	(automatique)	⚠ ♻
`autorisation_oauth.sh`	Créer / renommer / lister / supprimer une autorisation OAuth dans l'app (agents qui agissent avec le compte de l'utilisateur) ; nom affiché dans l'encadré « Autoriser »	`./scripts/autorisation_oauth.sh create acces-gmail client_secret.json "…/gmail.readonly" "Gmail (lecture seule)"` · `… renommer acces-gmail "Gmail"`	⚠
`personnaliser_agent.sh`	Soigner un agent déjà dans l'app : nom, questions proposées, texte de saisie, langue, icône (valeurs du catalogue) ; avant/après, confirmation, retour arrière	`GE_PROJECT=… GE_APP=… ./scripts/personnaliser_agent.sh "Nom actuel" courriels` · `… --annuler avant-<ID>.json`	⚠ (modifie seulement l'agent dans l'app, retour arrière possible)
`fiche_ge.py`	La fiche d'un agent pour la console Gemini Enterprise (appelé par `deployer_shell.sh carte`)	`./scripts/deployer_shell.sh carte courriels`	👁

Créer, nettoyer

Script	Il sert à	Exemple
`nouvel_agent.py`	Créer le squelette d'un nouvel agent (dossier, `agent.py`, entrée du catalogue)	`python scripts/nouvel_agent.py velo "Atelier vélo" "…"`	⚠ (fichiers locaux)
`nettoyer.py`	Inventaire de ce que les guides ont créé dans le projet, puis suppression après confirmation	`python scripts/nettoyer.py` (inventaire) · `--agent meteo` · `--supprimer`	👁 / ⚠

Utilisés par Terraform (rien à lancer)

Script	Il sert à
`pack.py`	Empaqueter le code d'un agent (son dossier + le code commun) pour Agent Runtime, toujours avec les mêmes octets : même code = rien à redéployer
`register_agent.sh`	Voir plus haut

Générer les documents (PDF, PowerPoint)

Script	Il produit
`build_pdf_tuto.py`	`Gemini-Enterprise-Agents-Tutoriel-Pas-a-Pas.pdf` (tutoriel pas à pas)
`build_pdf.py`	`Gemini-Enterprise-Agents-Guide-Equipes.pdf` (guide pour les équipes, PM, RH)
`pdf_style.py`	Le style commun des deux PDF (polices, couleurs, tableaux) : n'est pas lancé seul
`build_pptx.js`	`Gemini-Enterprise-Agents-Guide-Equipes.pptx` (présentation)

Commandes (depuis le dossier du projet) :

python3 scripts/build_pdf_tuto.py            # le python3 du SYSTÈME (reportlab), pas celui du .venv
python3 scripts/build_pdf.py
npm install --prefix ~/pptx-deps pptxgenjs react react-dom sharp react-icons     # une fois
NODE_PATH=~/pptx-deps/node_modules node scripts/build_pptx.js Gemini-Enterprise-Agents-Guide-Equipes.pptx

Les polices nécessaires, les chemins propres à ce poste et les erreurs fréquentes sont dans l'en-tête de chacun.

Quel script à quelle étape (méthode shell, docs/12-1-1)

 1. source scripts/config.sh config/…env                  configuration
 2. ./scripts/verifier_api.sh $PROJET_AGENTS …            API
 3. ./scripts/deployer_shell.sh preparer                  filtres, dépôt, compte de construction
 4. ./scripts/deployer_shell.sh cloudrun | runtime        déployer
 5. ./scripts/deployer_shell.sh registre                  catalogue
 6. ./scripts/deployer_shell.sh tester                    tester
 7. ./scripts/deployer_shell.sh carte [clé]               la fiche pour Gemini Enterprise (carte-<clé>.json, chemin…)
    (agents OAuth, docs/12-1-8 : « oauth » avant, CLIENT_ID=… devant « carte », personnaliser_agent.sh après l'ajout)
 8. ./scripts/simuler_gemini_enterprise.sh tout          simuler l'appel de l'app (docs/12-1-5)
 9. ./scripts/connecter_app.sh verifier | droits | ajouter  connecter à l'app (docs/12-1-4)
10. python scripts/nettoyer.py [--supprimer]              inventaire / nettoyage

Avec Terraform (docs/12-1-2), seuls config.sh et verifier_api.sh se lancent à la main. Terraform appelle pack.py et register_agent.sh tout seul.