درس 1

Prérequis

30min

هذا المحتوى غير مترجم بعد. تُعرض النسخة الأصلية.

Outils

OutilVersion minimaleVérification
gcloud CLIrécentegcloud version
Terraform1.8terraform version
Python3.11python3 --version
Docker24docker version

Structure du dépôt

agent-adk/
├── app/
│   ├── __init__.py
│   └── agent.py
├── Dockerfile
├── requirements.txt
├── infra/
│   ├── main.tf
│   ├── variables.tf
│   └── outputs.tf
└── .github/workflows/deploy.yml

L'agent minimal

app/agent.py
from google.adk.agents import Agent


def heure_serveur() -> dict:
    """Renvoie l'heure courante du serveur (UTC)."""
    from datetime import datetime, timezone
    return {"utc": datetime.now(timezone.utc).isoformat()}


root_agent = Agent(
    name="assistant_cloud",
    model="gemini-2.5-flash",
    description="Assistant qui répond aux questions sur l'infrastructure.",
    instruction="Tu es un assistant concis. Utilise les outils quand c'est utile.",
    tools=[heure_serveur],
)

Testez localement avec l'interface web d'ADK :

pip install google-adk
export GOOGLE_GENAI_USE_VERTEXAI=TRUE
export GOOGLE_CLOUD_PROJECT=second-project-511608
export GOOGLE_CLOUD_LOCATION=europe-west1
adk web
التالي