Chargement

Envoi des résultats d'outils

Leçon 2510 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
response.content[1].input

Cela vous donne un dictionnaire des arguments que Claude souhaite transmettre à votre fonction. Puisque votre fonction attend des arguments nommés plutôt qu'un dictionnaire, vous utilisez la syntaxe de décompression (unpacking) de Python :

python
get_current_datetime(**response.content[1].input)

Cellule de notebook exécutant l'appel de décompression présenté ci-dessus, qui renvoie la chaîne d'heure « 14:41:05 ».

Bloc de résultat d'outil

Après avoir exécuté la fonction de l'outil, vous devez renvoyer les résultats à Claude à l'aide d'un bloc de résultat d'outil. Ce bloc se trouve à l'intérieur d'un message utilisateur et indique à Claude ce qui s'est passé lors de l'exécution de l'outil.

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

Le bloc de résultat d'outil possède plusieurs propriétés importantes :

  • tool_use_id - Doit correspondre à l'id du bloc ToolUse auquel ce ToolResult correspond
  • content - Sortie de l'exécution de votre outil, sérialisée sous forme de chaîne
  • is_error - True si une erreur s'est produite

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 répondre avec deux blocs ToolUse distincts.

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

Chaque appel d'outil reçoit un identifiant unique, et vous devez faire correspondre ces identifiants lors de l'envoi des résultats. Cela garantit que Claude sait quel résultat correspond à quelle demande, même si les résultats arrivent dans un ordre différent.

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

Construction 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. Voici la structure :

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

L'historique complet des messages contient maintenant :

  • Message utilisateur d'origine
  • Message de l'assistant avec bloc d'utilisation d'outil
  • Message utilisateur avec bloc de résultat d'outil

Réalisation de la requête finale

Lors de l'envoi de la requête de suivi, vous devez toujours inclure le schéma de l'outil même si vous ne vous attendez pas à ce que Claude effectue un nouvel appel d'outil. Claude a besoin du schéma pour comprendre les références à l'outil dans votre historique de conversation.

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

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.

Claude répondra ensuite avec un message final qui intègre les résultats de l'outil dans une réponse naturelle pour l'utilisateur. Le flux de travail d'utilisation d'outils est maintenant terminé - vous avez réussi à permettre à Claude d'accéder à des informations en temps réel grâce à votre fonction personnalisée.