Outils et function calling : brancher le modèle sur tes données#

1. TOI     -> API : la question + la liste des outils disponibles
2. API     -> TOI : stop_reason = "tool_use", avec un bloc tool_use
                     { name: "query_database", input: {...}, id: "toolu_01..." }
3. TOI            : ton code execute vraiment la requete
4. TOI     -> API : la conversation + un bloc tool_result portant le meme tool_use_id
5. API     -> TOI : la reponse finale en texte

import anthropic

client = anthropic.Anthropic()

outils = [
    {
        "name": "get_weather",
        "description": "Get the current weather for a given location.",
        "input_schema": {
            "type": "object",
            "properties": {
                "location": {"type": "string", "description": "City and state, e.g. San Francisco, CA"}
            },
            "required": ["location"],
        },
    }
]
messages = [{"role": "user", "content": "Quel temps fait-il a San Francisco ?"}]

# 1er appel : le modele demande l'outil
reponse = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    tools=outils,
    messages=messages,
)
appel = next(b for b in reponse.content if b.type == "tool_use")

# ton code execute reellement
resultat = ma_fonction_meteo(appel.input["location"])

# 2e appel : tu renvoies le resultat
messages += [
    {"role": "assistant", "content": reponse.content},
    {"role": "user", "content": [
        {"type": "tool_result", "tool_use_id": appel.id, "content": resultat}
    ]},
]
finale = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    tools=outils,
    messages=messages,
)

{
  "name": "get_weather",
  "description": "Get the current weather in a given location",
  "input_schema": {
    "type": "object",
    "properties": {
      "location": {
        "type": "string",
        "description": "The city and state, e.g. San Francisco, CA"
      },
      "unit": {
        "type": "string",
        "enum": ["celsius", "fahrenheit"],
        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
      }
    },
    "required": ["location"]
  }
}

{
  "name": "get_stock_price",
  "description": "Retrieves the current stock price for a given ticker symbol. The ticker symbol must be a valid symbol for a publicly traded company on a major US stock exchange like NYSE or NASDAQ. The tool will return the latest trade price in USD. It should be used when the user asks about the current or most recent price of a specific stock. It will not provide any other information about the stock or company.",
  "input_schema": {
    "type": "object",
    "properties": {
      "ticker": {
        "type": "string",
        "description": "The stock ticker symbol, e.g. AAPL for Apple Inc."
      }
    },
    "required": ["ticker"]
  }
}

{
  "name": "get_stock_price",
  "description": "Gets the stock price for a ticker.",
  "input_schema": {
    "type": "object",
    "properties": {
      "ticker": {"type": "string"}
    },
    "required": ["ticker"]
  }
}

{
  "name": "query_database",
  "description": "Interroge la base de donnees.",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {"type": "string"}
    },
    "required": ["query"]
  }
}

{
  "name": "query_database",
  "description": "Execute une requete SELECT en lecture seule sur l'entrepot BigQuery de production (projet 'acme-dwh', dataset 'marts') et renvoie les lignes au format JSON. Utilise cet outil des que la reponse depend de donnees reelles : chiffres, volumes, dates, listes de valeurs existantes. N'utilise PAS cet outil pour des questions generales sur le SQL, pour expliquer un concept, ou quand la reponse est deja dans la conversation. Le dialecte est GoogleSQL (BigQuery standard), pas Legacy SQL et pas T-SQL. Seules les instructions SELECT et WITH sont autorisees : toute requete contenant INSERT, UPDATE, DELETE, MERGE, CREATE ou DROP est rejetee et renvoie une erreur. La requete doit etre qualifiee en `dataset.table`. Chaque appel est limite a 1000 lignes et a 50 Go scannes ; au-dela, l'outil renvoie une erreur et tu dois ajouter un filtre sur la colonne de partition. L'outil ne renvoie PAS le schema des tables : appelle d'abord 'describe_table' si tu n'es pas sur des colonnes disponibles.",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "La requete GoogleSQL complete. Tables qualifiees en dataset.table, par exemple 'marts.fct_commandes'. Inclure toujours un filtre sur la colonne de partition (date_commande) quand la table est partitionnee."
      },
      "max_rows": {
        "type": "integer",
        "description": "Nombre maximum de lignes a renvoyer, entre 1 et 1000. Par defaut 100. Mets une valeur basse quand tu veux seulement verifier la forme du resultat.",
        "minimum": 1,
        "maximum": 1000
      },
      "dry_run": {
        "type": "boolean",
        "description": "Si true, la requete n'est pas executee : l'outil renvoie seulement le volume estime de donnees scannees et la validite syntaxique. Utilise dry_run=true avant toute requete que tu juges couteuse."
      }
    },
    "required": ["query"]
  },
  "input_examples": [
    {"query": "SELECT COUNT(*) AS n FROM marts.fct_commandes WHERE date_commande >= '2026-09-01'", "max_rows": 1},
    {"query": "SELECT canal, SUM(montant_ht) AS ca FROM marts.fct_commandes WHERE date_commande BETWEEN '2026-09-01' AND '2026-09-30' GROUP BY canal", "max_rows": 20},
    {"query": "SELECT * FROM marts.fct_commandes WHERE date_commande >= '2026-01-01'", "dry_run": true}
  ]
}

<use_parallel_tool_calls>
If you intend to call multiple tools and there are no dependencies between the tool
calls, make all of the independent tool calls in parallel. ... However, if some tool
calls depend on previous calls to inform dependent values like the parameters, do NOT
call these tools in parallel and instead call them sequentially. Never use placeholders
or guess missing parameters in tool calls.
</use_parallel_tool_calls>

try:
    lignes = executer_bigquery(appel.input["query"], appel.input.get("max_rows", 100))
    contenu, erreur = json.dumps(lignes, ensure_ascii=False), False
except VolumeTropGrand as e:
    contenu = (
        f"Erreur : la requete scannerait {e.go} Go, la limite est 50 Go. "
        f"Ajoute un filtre sur la colonne de partition date_commande, "
        f"ou relance avec dry_run=true pour estimer avant."
    )
    erreur = True
except ColonneInconnue as e:
    contenu = (
        f"Erreur : la colonne '{e.colonne}' n'existe pas dans {e.table}. "
        f"Colonnes disponibles : {', '.join(e.colonnes_reelles)}."
    )
    erreur = True

bloc_resultat = {
    "type": "tool_result",
    "tool_use_id": appel.id,
    "content": contenu,
    "is_error": erreur,
}

{
  "name": "[SERVICE]_[ACTION]",
  "description": "[PHRASE_1 : ce que fait l'outil, sur quel systeme precis]. [PHRASE_2 : quand l'utiliser - 'Utilise cet outil des que ...']. [PHRASE_3 : quand NE PAS l'utiliser - 'N'utilise PAS cet outil pour ...']. [PHRASE_4 : ce qui est renvoye et dans quel format]. [PHRASE_5 : limites, quotas, ce que l'outil ne renvoie PAS, et quel autre outil appeler dans ce cas].",
  "input_schema": {
    "type": "object",
    "properties": {
      "[PARAM_1]": {
        "type": "[string|integer|boolean|array|object]",
        "description": "[CE_QUE_C_EST + FORMAT_ATTENDU + EXEMPLE_CONCRET]"
      },
      "[PARAM_2]": {
        "type": "string",
        "enum": ["[VALEUR_1]", "[VALEUR_2]"],
        "description": "[CE_QUE_CHAQUE_VALEUR_CHANGE]"
      }
    },
    "required": ["[PARAM_OBLIGATOIRE]"]
  },
  "input_examples": [
    {"[PARAM_1]": "[CAS_SIMPLE]"},
    {"[PARAM_1]": "[CAS_COMPLET]", "[PARAM_2]": "[VALEUR_1]"}
  ]
}

Tu es [ROLE] et tu travailles sur [SYSTEME].

Regles d'utilisation des outils :
- Utilise les outils pour investiguer avant de repondre. Ne devine jamais une
  valeur qui existe dans [LA_SOURCE_DE_VERITE].
- Avant d'ecrire une requete sur une table que tu ne connais pas, appelle
  [OUTIL_DE_SCHEMA].
- Si un outil renvoie une erreur, lis le message, corrige, et reessaie une fois.
  Si la deuxieme tentative echoue, explique le blocage a l'utilisateur.
- [ACTION_DANGEREUSE, ex: declencher un DAG en production] : demande toujours
  confirmation avant.

Voici la definition d'un de mes outils. Audite-la.

<definition>
[COLLE_TON_JSON]
</definition>

<contexte>
Systeme reel : [DECRIS_LE_SYSTEME]
Ce que l'outil fait vraiment : [DECRIS_LE_COMPORTEMENT_REEL]
Limites reelles : [QUOTAS, DROITS, VOLUMES]
</contexte>

Pour chaque point, dis si c'est present et suffisant :
1. Ce que l'outil fait
2. Quand l'utiliser
3. Quand NE PAS l'utiliser
4. Ce qui est renvoye, dans quel format
5. Ce qui n'est PAS renvoye
6. Description de chaque parametre
7. Contraintes machines (enum, minimum, maximum)

Puis reecris la definition complete corrigee.