10. Rejouer tout le flux, commande par commande, avec les résultats attendus

export PROJET_A=aiml-gemini-entreprise-ldbr        # projet de l'app Gemini Enterprise (A)
export NUM_A=98547854221                            # son NUMÉRO (à vérifier, voir ci-dessous)
export PROJET_X=mon-projet-agents                   # projet des agents (X) : à remplacer
export REGION=europe-west1                          # app en multi-région eu => agents en europe-*
export GE_LOCATION=eu
export GE_SA=service-$NUM_A@gcp-sa-discoveryengine.iam.gserviceaccount.com   # compte de Gemini Enterprise
export SIMU=ge-simulateur@$PROJET_A.iam.gserviceaccount.com                  # compte simulateur (partie 6)
export DOSSIER=~/09-agents-multi-projets-gemini-enterprise                   # où se trouve le dossier 09

gcloud projects describe $PROJET_A --format='value(projectNumber)'

09-agents-multi-projets-gemini-enterprise/
├── agents/trio/                     LES 6 AGENTS (code unique, utilisé par 01-bis et 02-bis)
│   ├── commun.py                    accès au modèle (identité Vertex AI ou clé d'API) + Model Armor
│   ├── catalogue.json               noms affichés, descriptions, compétences A2A (lu par Terraform)
│   ├── requirements.txt             dépendances (ADK 2.10, Agent Platform 2.2, Model Armor)
│   └── meteo_agent/ redaction_agent/ traduction_agent/ …   un dossier par agent (agent.py)
├── agents/specialist/stock_agent/   agent STOCK (partie 10, projet X)
├── agents/orchestrator/             agent ORCHESTRATEUR (partie 10, projet A) : trouve et appelle l'agent stock
├── 02-bis-agent-runtime/            Terraform + test.sh : les agents sur Agent Runtime
├── 01-bis-cloud-run-a2a/            Dockerfile + cloudbuild.yaml (construction dans Google Cloud) + main.py (serveur A2A) + Terraform + test.sh : les agents sur Cloud Run
├── terraform/                       Terraform de la partie 10 (stock dans X, orchestrateur dans A, droits entre les deux)
│   └── modules/adk_agent, armor_templates   modules partagés (un agent Agent Runtime ; une paire de templates Model Armor)
└── scripts/
    ├── test_trio.py                 tests hors ligne des agents du trio
    ├── test_agents.py               tests hors ligne de l'agent stock et de l'orchestrateur
    ├── query.py                     interroger un agent Agent Runtime (comme le ferait une application)
    ├── registry.py                  lire l'Agent Registry d'un projet, et dire comment ajouter chaque agent
    ├── simuler_gemini_enterprise.sh appeler un agent avec les mêmes droits que Gemini Enterprise
    ├── add_agent_to_ge.sh           ajouter un agent existant à l'app (ADK ou A2A)
    └── register_agent.sh            utilisé par Terraform pour publier dans l'app

gcloud version | head -1 ; terraform version | head -1 ; uv --version

Google Cloud SDK 587.0.0
Terraform v1.16.0
uv 0.8.x

gcloud auth login                         # pour gcloud (et Cloud Build)
gcloud auth application-default login     # pour Terraform et les scripts Python
gcloud config set project $PROJET_X

cd $DOSSIER && ls

gcloud billing accounts list                                   # repérer l'ID : XXXXXX-XXXXXX-XXXXXX
export BILLING=XXXXXX-XXXXXX-XXXXXX
export PROJET_A=essai-ge-app-$RANDOM PROJET_X=essai-ge-agents-$RANDOM
for P in $PROJET_A $PROJET_X; do
  gcloud projects create $P --name="$P"                        # ajouter --folder=ID ou --organization=ID chez Acme
  gcloud billing projects link $P --billing-account=$BILLING
done
export NUM_A=$(gcloud projects describe $PROJET_A --format='value(projectNumber)')
export GE_SA=service-$NUM_A@gcp-sa-discoveryengine.iam.gserviceaccount.com SIMU=ge-simulateur@$PROJET_A.iam.gserviceaccount.com
echo "A=$PROJET_A ($NUM_A)  X=$PROJET_X"

for P in $PROJET_A $PROJET_X; do
  gcloud services enable cloudresourcemanager.googleapis.com serviceusage.googleapis.com --project=$P
done

Operation "operations/acat.p2-111122223333-eab204d8-…" finished successfully.
Operation "operations/acat.p2-98547854221-a52458d4-…" finished successfully.

cd $DOSSIER
uv venv -p '>=3.12' .venv && source .venv/bin/activate
uv pip install -r agents/orchestrator/requirements.txt      # mêmes dépendances que agents/trio
python scripts/test_trio.py
python scripts/test_agents.py

tests trio OK (9 scénarios, 6 agents)
tests agents OK (5 scénarios)

export LOCAL_DEV=1 GOOGLE_CLOUD_PROJECT=$PROJET_X
gcloud services enable aiplatform.googleapis.com --project=$PROJET_X
adk web --port 8080 agents/trio          # Cloud Shell : bouton « Aperçu sur le Web » > port 8080

gcloud services enable discoveryengine.googleapis.com --project=$PROJET_A
gcloud beta services identity create --service=discoveryengine.googleapis.com --project=$PROJET_A

Operation "operations/acat.p2-98547854221-…" finished successfully.
Service identity created: service-100000000001@gcp-sa-discoveryengine.iam.gserviceaccount.com

cd $DOSSIER && export GE_PROJECT=$PROJET_A
./scripts/simuler_gemini_enterprise.sh preparer

Created service account [ge-simulateur].
Service account email: ge-simulateur@<PROJET_A>.iam.gserviceaccount.com
Updated IAM policy for serviceAccount [ge-simulateur@<PROJET_A>.iam.gserviceaccount.com].
simulateur prêt : ge-simulateur@<PROJET_A>.iam.gserviceaccount.com
Les jetons peuvent mettre 1 à 2 minutes à fonctionner après la création.

cd $DOSSIER/02-bis-agent-runtime/terraform
cat > terraform.tfvars <<EOF
agents_project_id = "$PROJET_X"
ge_project_number = "$NUM_A"
region            = "$REGION"
ge_location       = "$GE_LOCATION"
EOF
cat terraform.tfvars

terraform init
terraform plan        # lire la fin : « Plan: 49 to add, 0 to change, 0 to destroy. »
terraform apply       # taper yes ; 10 à 15 minutes
cp terraform.tfstate ~/sauvegarde-02bis.tfstate     # Terraform est lancé EN LOCAL : sauvegarder l'état

Apply complete! Resources: 49 added, 0 changed, 0 destroyed.

Outputs:

agents = {
  "identite" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/…"
  "meteo" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/5587992970264576000"
  "redaction" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/1022468848017735680"
  "retour" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/…"
  "taille" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/…"
  "traduction" = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/976306951837188096"
}
ge_agents_page = "(ge_app_id vide : agents non publiés)"
ge_service_agent = "serviceAccount:service-100000000001@gcp-sa-discoveryengine.iam.gserviceaccount.com"

cd $DOSSIER/02-bis-agent-runtime && source ../.venv/bin/activate && ./test.sh

== meteo  (projects/<PROJET_X>/locations/europe-west1/reasoningEngines/5587992970264576000)
  -> outil : meteo({'ville': 'Lille', 'jours': 2})
  -> outil : conseil_equipement({'temperature_c': 10, 'vent_kmh': 27, 'activite': 'course à pied', 'pluie_mm': 8.6})
agent : Demain matin à Lille, de la pluie faible est prévue avec environ 10°C et du vent à 27 km/h.
Pour votre course, portez un t-shirt technique respirant sous une veste imperméable et respirante. …

== redaction  (projects/<PROJET_X>/locations/europe-west1/reasoningEngines/1022468848017735680)
  -> outil : charte_redactionnelle({'canal': 'email_client'})
  -> outil : analyser_texte({'texte': 'ton velo est pret passe avant samedi'})
  -> outil : analyser_texte({'texte': "Bonjour,\n\nBonne nouvelle : votre vélo est prêt ! …"})
agent : Bonjour, … Avant : 7 mots, après : 27 mots

== traduction  (projects/<PROJET_X>/locations/europe-west1/reasoningEngines/976306951837188096)
  -> outil : glossaire({'langue_cible': 'es'})
  -> outil : verifier_traduction({…})
agent : Su tienda de campaña Quechua está disponible para recogida en tienda.  Contrôle : conforme

gcloud agent-registry agents list --location=$REGION --project=$PROJET_X --format="table(displayName,agentId)"

DISPLAY_NAME      AGENT_ID
meteo-agent       urn:agent:projects-111122223333:projects:111122223333:locations:europe-west1:aiplatform:reasoningEngines:5587992970264576000
redaction-agent   urn:agent:projects-111122223333:projects:111122223333:locations:europe-west1:aiplatform:reasoningEngines:1022468848017735680
traduction-agent  urn:agent:projects-111122223333:projects:111122223333:locations:europe-west1:aiplatform:reasoningEngines:976306951837188096

# les agents Agent Runtime du projet, par l'API
curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://$REGION-aiplatform.googleapis.com/v1/projects/$PROJET_X/locations/$REGION/reasoningEngines" \
  | python3 -c 'import json,sys; [print(e["displayName"], e["name"]) for e in json.load(sys.stdin).get("reasoningEngines",[])]'
# le droit de Gemini Enterprise sur le projet X
gcloud projects get-iam-policy $PROJET_X --flatten=bindings --filter="bindings.members:$GE_SA" --format="value(bindings.role)"

cd $DOSSIER/01-bis-cloud-run-a2a/terraform
cat > terraform.tfvars <<EOF
agents_project_id = "$PROJET_X"
ge_project_number = "$NUM_A"
region            = "$REGION"
ge_location       = "$GE_LOCATION"
EOF
terraform init
terraform plan        # « Plan: 63 to add » (6 agents : 23 pour le 1er, +8 par agent en plus)
terraform apply       # yes ; ~10 min (Cloud Build construit une image par agent, ~1 min 20 s chacune, puis 6 services)
cp terraform.tfstate ~/sauvegarde-01bis.tfstate

Apply complete! Resources: 63 added, 0 changed, 0 destroyed.

Outputs:

cards = {
  "meteo" = "{\"capabilities\":{\"streaming\":true},…,\"protocolVersion\":\"0.3\",…,\"url\":\"https://meteo-a2a-111122223333.europe-west1.run.app\",\"version\":\"1.0.0\"}"
  "redaction" = "{…}"
  "traduction" = "{…}"
  …                       (une ligne par agent : 6 au total)
}
ge_agents_page = "(ge_app_id vide : agents non publiés)"
ge_service_agent = "serviceAccount:service-100000000001@gcp-sa-discoveryengine.iam.gserviceaccount.com"
urls = {
  "meteo" = "https://meteo-a2a-xxxxxxxxxx-ew.a.run.app"
  "redaction" = "https://redaction-a2a-xxxxxxxxxx-ew.a.run.app"
  "traduction" = "https://traduction-a2a-xxxxxxxxxx-ew.a.run.app"
  …
}

curl -s -o /dev/null -w "%{http_code}\n" $(terraform output -json urls | python3 -c 'import json,sys; print(json.load(sys.stdin)["meteo"])')

cd $DOSSIER/01-bis-cloud-run-a2a && ./test.sh

== meteo  carte : meteo_agent (A2A 0.3)
   Q1 > Quel temps fait-il à Chamonix ?
   R1 < À Chamonix, le temps est actuellement brumeux (8°C, ressenti 7°C) avec d'importantes averses prévues (25 mm).
   Q2 > Et pour y randonner, quoi porter ?
   R2 < Pour votre randonnée, le temps prévu est très humide avec de fortes pluies (25 mm) et une température fraîche de 8°C.
== redaction  carte : redaction_agent (A2A 0.3)
   …
== traduction  carte : traduction_agent (A2A 0.3)
   Q1 > Traduis en espagnol : 'Votre tente Quechua est disponible en retrait en magasin.'
   R1 < Tu tienda de campaña Quechua está disponible para recogida en tienda.
   Q2 > Et en italien ?
   R2 < La tua tenda Quechua è disponibile per il ritiro in negozio.
OK : les agents répondent en A2A v0.3, avec mémoire de conversation

gcloud agent-registry services list --location=$REGION --project=$PROJET_X --format="table(displayName,name)"

DISPLAY_NAME               NAME
Traduction Acme       projects/<PROJET_X>/locations/europe-west1/services/traduction-a2a
Rédaction & reformulation  projects/<PROJET_X>/locations/europe-west1/services/redaction-a2a
Météo & équipement         projects/<PROJET_X>/locations/europe-west1/services/meteo-a2a

cd $DOSSIER && python scripts/registry.py $PROJET_X $REGION

== 7 agent(s) dans <PROJET_X>/europe-west1
- meteo_agent: Météo réelle d'une ville (jusqu'à 7 jours) et équipement conseillé pour faire du
    ajout : a2a  https://meteo-a2a-111122223333.europe-west1.run.app/.well-known/agent-card.json  [carte A2A dans le registre]
- traduction-agent: Traduit un texte en 7 langues européennes en respectant le glossaire et les marq
    ajout : adk  projects/111122223333/locations/europe-west1/reasoningEngines/976306951837188096

cd $DOSSIER && export GE_PROJECT=$PROJET_A
export RT=$(terraform -chdir=02-bis-agent-runtime/terraform output -json agents | python3 -c 'import json,sys; print(json.load(sys.stdin)["traduction"])')
export URL=$(terraform -chdir=01-bis-cloud-run-a2a/terraform output -json urls | python3 -c 'import json,sys; print(json.load(sys.stdin)["traduction"])')

./scripts/simuler_gemini_enterprise.sh runtime $RT "Traduis en italien : retrait en magasin"
./scripts/simuler_gemini_enterprise.sh a2a $URL "Traduis en anglais : retour gratuit"

REFUSÉ (403) : le compte de Gemini Enterprise n'a pas roles/discoveryengine.serviceAgent sur le projet de l'agent.
REFUSÉ (403) : le compte de Gemini Enterprise n'a pas roles/run.invoker sur ce service.

gcloud projects add-iam-policy-binding $PROJET_X --condition=None \
  --role=roles/discoveryengine.serviceAgent --member=serviceAccount:$SIMU
gcloud run services add-iam-policy-binding traduction-a2a --region=$REGION --project=$PROJET_X \
  --role=roles/run.invoker --member=serviceAccount:$SIMU

ACCEPTÉ (Agent Runtime) : ritiro in negozio  Contrôle : conforme
ACCEPTÉ (A2A v0.3) : free returns  Contrôle : conforme

gcloud projects remove-iam-policy-binding $PROJET_X --condition=None \
  --role=roles/discoveryengine.serviceAgent --member=serviceAccount:$SIMU
gcloud run services remove-iam-policy-binding traduction-a2a --region=$REGION --project=$PROJET_X \
  --role=roles/run.invoker --member=serviceAccount:$SIMU

cd $DOSSIER/terraform
cat > terraform.tfvars <<EOF
agents_project_id = "$PROJET_X"
ge_project_id     = "$PROJET_A"
region            = "$REGION"
ge_location       = "$GE_LOCATION"
EOF
terraform init
terraform plan        # « Plan: 26 to add » ; repérer les 2 droits :
                      #   google_vertex_ai_reasoning_engine_iam_member.orchestrator_calls_stock
                      #   google_project_iam_member.orchestrator_reads_registry[0]
terraform apply       # yes ; 10 à 15 min
cp terraform.tfstate ~/sauvegarde-09.tfstate

Apply complete! Resources: 26 added, 0 changed, 0 destroyed.

Outputs:

ge_agents_page = "(ge_app_id vide : agents non publiés)"
orchestrator = "projects/<PROJET_A>/locations/europe-west1/reasoningEngines/7589843004630761472"
stock_agent = "projects/<PROJET_X>/locations/europe-west1/reasoningEngines/2978860673645150208"

cd $DOSSIER && python scripts/query.py stock_agent "Stock de 8771234 à Lyon ?"

  -> outil : get_store_stock({'sku': '8771234', 'store': 'lyon'})
agent : Le produit **Tente 2 secondes 2 places** (SKU: 8771234) est en **rupture de stock** dans le magasin de **lyon** (stock : 0).

python scripts/query.py orchestrator "Il reste des tentes 8771234 à Lyon ?"

  -> outil : ask_stock_agent({'question': "Est-ce qu'il reste des tentes avec le code article 8771234 à Lyon ?"})
agent : Non, la **Tente 2 secondes 2 places** (code article **8771234**) est actuellement en **rupture de stock** dans le magasin de **Lyon** (0 article disponible).

Si besoin, sachez qu'il en reste dans d'autres magasins :
*   **Lille** : 12 en stock
*   **Paris-La-Défense** : 4 en stock

cd $DOSSIER/terraform
terraform destroy -target=google_vertex_ai_reasoning_engine_iam_member.orchestrator_calls_stock   # yes
sleep 120 && cd .. && python scripts/query.py orchestrator "Il reste des tentes 8771234 à Lyon ?"
cd terraform && terraform apply                                                                     # yes : le droit revient

  -> outil : ask_stock_agent({'question': "Est-ce qu'il reste des tentes avec le code article 8771234 dans les magasins de Lyon ?"})
agent : Malheureusement, je ne parviens pas à joindre l'outil de suivi des stocks pour le moment en raison d'un problème
technique (l'agent de l'équipe Supply est indisponible). …

export GEMINI_API_KEY="votre-clé"        # ou VERTEX_API_KEY
adk web --port 8080 agents/trio

gcloud services enable secretmanager.googleapis.com --project=$PROJET_X
printf '%s' "votre-clé" | gcloud secrets create gemini-api-key --data-file=- --project=$PROJET_X
# dans 02-bis-agent-runtime/terraform/terraform.tfvars (ou 01-bis-…) :
#   model_api_key_secret = "gemini-api-key"
#   model_api_key_type   = "gemini"          # ou vertex
terraform apply

cd $DOSSIER && export GE_PROJECT=$PROJET_A GE_APP=ID_DE_L_APP GE_LOCATION=$GE_LOCATION
# Agent Runtime (ressource de la partie 7)
./scripts/add_agent_to_ge.sh adk $RT "Traduction Acme" "Traduit un texte en 7 langues européennes en respectant le glossaire et les marques Acme."
# A2A (carte de la partie 8, enregistrée en fichier)
terraform -chdir=01-bis-cloud-run-a2a/terraform output -json cards | python3 -c 'import json,sys; print(json.load(sys.stdin)["traduction"])' > carte-traduction.json
./scripts/add_agent_to_ge.sh a2a carte-traduction.json "Traduction Acme (A2A)"
./scripts/add_agent_to_ge.sh list

# Cloud Run
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="meteo-a2a" AND severity>=WARNING' \
  --project=$PROJET_X --freshness=30m --limit=10 --format="value(timestamp,severity,textPayload)"
# Agent Runtime
gcloud logging read 'resource.type="aiplatform.googleapis.com/ReasoningEngine" AND severity>=ERROR' \
  --project=$PROJET_X --freshness=1h --limit=10 --format="value(timestamp,resource.labels.reasoning_engine_id,textPayload)"

cd $DOSSIER
terraform -chdir=terraform destroy                   # yes -> Destroy complete! Resources: 26 destroyed.
terraform -chdir=02-bis-agent-runtime/terraform destroy   # yes -> Resources: 49 destroyed.
terraform -chdir=01-bis-cloud-run-a2a/terraform destroy   # yes -> Resources: 63 destroyed.
gcloud iam service-accounts delete $SIMU --project=$PROJET_A --quiet

gcloud run services list --project=$PROJET_X --region=$REGION
for P in $PROJET_X $PROJET_A; do
  curl -s -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://$REGION-aiplatform.googleapis.com/v1/projects/$P/locations/$REGION/reasoningEngines" \
    | python3 -c 'import json,sys; print("agents Agent Runtime :", [e["displayName"] for e in json.load(sys.stdin).get("reasoningEngines",[])])'
done