hack
Étincelle
0 XP / 250
M8 · L'API Anthropicleçon 2/4 · 8 min

Ton premier appel API

Le script Python complet, ligne à ligne : client, system prompt, message, réponse. Puis tu le fais tourner.

🧠 Concept — Trois lignes qui comptent

Le SDK Python d'Anthropic réduit l'appel API à l'essentiel. Dans le script ci-dessous, repère les 3 moments clés :

  1. anthropic.Anthropic() : crée le client — il lit tout seul la variable d'environnement ANTHROPIC_API_KEY. Zéro clé dans le code : c'est exactement ce qu'on veut.
  2. system=... : le rôle permanent. Ici, l'assistant support Electra avec ses consignes de ton.
  3. messages=[...] : la question de l'utilisateur. La réponse arrive dans response.content[0].text.

Prérequis une seule fois : pip install anthropic et exporter ta clé dans l'environnement.

premier_appel.py — l'assistant support Electra

import anthropic

# Le client lit ANTHROPIC_API_KEY depuis l'environnement.
# La clé n'apparaît NULLE PART dans ce fichier — et c'est voulu.
client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-haiku-4-5",   # noms à jour : docs.claude.com
    max_tokens=500,
    system=(
        "Tu es l'assistant support Electra, opérateur de recharge "
        "rapide pour véhicules électriques. Tu réponds en français, "
        "avec empathie et concision. Tu ne promets jamais de délai "
        "d'intervention que tu ne peux pas garantir."
    ),
    messages=[
        {
            "role": "user",
            "content": "La borne 3 de la station de Rennes affiche "
                       "une erreur E42, que dire au client ?",
        }
    ],
)

print(response.content[0].text)
print("---")
print("Tokens utilisés :", response.usage.input_tokens,
      "en entrée,", response.usage.output_tokens, "en sortie")

💡 Réflexe pro — Le system prompt est ton volant

Relance le même script en changeant UNIQUEMENT le system prompt : « Tu réponds en 2 phrases max » vs « Tu détailles la procédure pas à pas » vs « Tu réponds en allemand pour la zone DACH ». Même question, réponses radicalement différentes. En prod, 80 % de la qualité se joue dans ce champ — c'est là que tu réinvestis tout le Module 2 sur le prompting.

🛠️ À toi de jouer — 🛠️ Fais-le tourner, puis fais-le tien

Ouvre Claude Code (ou Claude avec exécution de code) et lance le prompt ci-dessous. Si tu n'as pas de clé API sous la main, demande à Claude de simuler la réponse de l'API pour valider la logique — mais l'objectif du badge reste un vrai appel.

Ton point de départ
Voici un script Python qui appelle l'API Anthropic [colle le script premier_appel.py de la leçon]. 1) Explique-moi chaque ligne, en particulier comment la clé API est chargée sans jamais apparaître dans le code. 2) Aide-moi à l'exécuter (vérifie que le paquet anthropic est installé et que ANTHROPIC_API_KEY est définie — sans jamais afficher la valeur de la clé). 3) Ensuite, modifie le system prompt pour mon métier chez Electra [décris ton métier : déploiement, support, énergie, foncier...] et change la question user pour un cas réel de mon quotidien. Montre-moi les deux réponses côte à côte.

Checklist de validation