Chargement

Envoi des résultats d'outils

Leçon 267 min
Chargement

Après que Claude a demandé un appel d'outil, vous devez exécuter la fonction et renvoyer les résultats. Cela complète le flux de travail d'utilisation d'outils en fournissant à Claude les informations qu'il a demandées.

Exécution de la fonction de l'outil

Lorsque Claude répond avec un bloc d'utilisation d'outils, vous extrayez les paramètres d'entrée et appelez votre fonction. Voici comment accéder aux paramètres de l'outil :

python
# Accéder au bloc d'utilisation d'outils
tool_use_block = response.content[1]

# Récupérer les paramètres d'entrée
input_params = tool_use_block.input

# Appeler votre fonction avec les paramètres
result = get_current_datetime(**input_params)

Le double astérisque (**) déploie le dictionnaire en arguments nommés que votre fonction attend.

Bloc de résultat d'outil

Après avoir exécuté l'outil, vous renvoyez les résultats à Claude à l'aide d'un bloc de résultat d'outil. Ce bloc comporte plusieurs propriétés importantes :

Exemple de JSON de résultat d'outil avec type "tool_result", content "12:47:13", is_error False et un tool_use_id correspondant.

  • tool_use_id - Doit correspondre à l'ID du bloc d'utilisation d'outil d'origine
  • content - La sortie de votre fonction d'outil, convertie en chaîne de caractères
  • is_error - Défini sur true si une erreur s'est produite pendant l'exécution

Gestion de plusieurs appels d'outils

Claude peut demander plusieurs appels d'outils dans une seule réponse. Par exemple, si un utilisateur demande « Combien font 10 + 10 et 30 + 30 ? », Claude pourrait envoyer deux blocs d'utilisation d'outils distincts :

Claude envoie des blocs d'utilisation d'outil calculatrice ab3 pour 10 + 10 et po9 pour 30 + 30 ; les résultats reviennent sous forme de sortie po9 60 puis ab3 20.

Chaque bloc d'utilisation d'outil obtient un ID unique, et vous devez faire correspondre ces ID lors de l'envoi des résultats :

Claude renvoie les utilisations d'outils ab3 pour 10 + 10 et po9 pour 30 + 30 ; notre serveur répond par la sortie po9 60, puis la sortie ab3 20.

Ce système d'ID garantit que Claude peut correctement faire correspondre chaque résultat à sa demande correspondante, même si les résultats arrivent dans un ordre différent.

Envoi de la requête de suivi

Votre requête de suivi à Claude doit inclure l'historique complet de la conversation ainsi que le nouveau résultat d'outil :

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

Le déroulement de la conversation se présente ainsi :

Notre serveur envoie à Claude le schéma de l'outil, la question « Quelle heure est-il actuellement ? », les blocs d'utilisation d'outil et de résultat d'outil.

N'oubliez pas d'inclure le schéma de l'outil dans votre requête de suivi, même si Claude n'aura probablement pas besoin d'appeler à nouveau des outils. Claude a besoin du schéma pour comprendre les références d'outils dans l'historique de la conversation.

Flux de travail complet

Voici le processus complet :

  1. L'utilisateur pose une question nécessitant l'utilisation d'outils
  2. Claude répond avec un bloc d'utilisation d'outil
  3. Vous exécutez la fonction d'outil demandée
  4. Vous envoyez une requête de suivi avec le résultat de l'outil
  5. Claude fournit une réponse finale en utilisant la sortie de l'outil

La requête finale inclut votre historique complet de messages, le bloc de résultat d'outil et le schéma de l'outil. Claude répond alors par un message texte normal qui intègre les informations issues de l'exécution de votre outil.