Chargement

Gestion des réponses d'utilisation d'outils

Leçon 247 min
Chargement

Lorsque Claude décide d'utiliser un outil, il renvoie une structure de réponse spéciale qui nécessite un traitement attentif. Comprendre ce format de réponse et mettre en œuvre une gestion appropriée de la conversation est essentiel pour créer des applications robustes exploitant l'utilisation d'outils.

Configuration du choix d'outil

Avant d'aborder les réponses, il est utile de comprendre comment contrôler le moment où Claude utilise les outils. Le paramètre toolChoice vous offre trois options :

Trois paramètres toolChoice écrits en JSON, "auto", "any" et "tool" avec un nom, associés aux comportements listés ci-dessous.

  • auto - Claude décide s'il doit utiliser un outil (comportement par défaut)
  • any - Claude doit utiliser un outil mais peut choisir lequel
  • specific tool - Force Claude à utiliser un outil particulier en le nommant

La troisième option est particulièrement utile pour les tests lorsque vous souhaitez vous assurer que Claude appelle une fonction spécifique.

Structure de message en plusieurs parties

Lorsque Claude souhaite utiliser un outil, il renvoie un message assistant comportant plusieurs parties de contenu au lieu d'un simple texte :

Liste de contenu d'un message assistant : une partie "Text" et une partie "toolUse" appelant get_current_datetime avec date_format %H:%M:%S.

La réponse contient deux parties :

  • Text Part - Une explication lisible par un humain telle que « Je peux vous aider à connaître l'heure actuelle. Laissez-moi rechercher cette information pour vous »
  • ToolUse Part - Des données structurées indiquant quel outil exécuter et avec quels arguments

Comprendre la partie ToolUse

La partie ToolUse contient trois informations clés :

Exemple de partie ToolUse nommant l'outil "get_current_datetime" avec l'entrée date_format "%H:%M:%S", plus un toolUseId.

  • toolUseId - Un identifiant unique dont vous aurez besoin lors du renvoi du résultat de l'outil
  • name - Le nom exact de l'outil, issu de votre schéma JSON, que Claude souhaite appeler
  • input - Un dictionnaire d'arguments que Claude souhaite transmettre à votre fonction d'outil

Déroulement de la conversation avec les outils

L'utilisation d'outils suit un schéma de conversation spécifique qui nécessite de conserver l'historique complet des messages :

Notre serveur envoie à Claude tout l'historique : utilisateur « Quelle heure est-il ? », texte de l'assistant et partie ToolUse, partie ToolResult de l'utilisateur.

Lorsque vous recevez une demande d'utilisation d'outil, vous devez :

  1. Extraire les informations de l'outil depuis la partie ToolUse
  2. Exécuter votre fonction d'outil réelle
  3. Renvoyer un message ToolResult accompagné de l'historique complet de la conversation
  4. Inclure le message utilisateur d'origine ainsi que le message d'utilisation d'outil de l'assistant dans votre prochaine requête

Mise à jour des fonctions d'assistance

Pour traiter correctement les messages en plusieurs parties, vous devrez mettre à jour vos fonctions de gestion des messages. Voici comment rendre vos fonctions suffisamment flexibles pour gérer à la fois du texte simple et du contenu complexe en plusieurs parties :

python
def add_user_message(messages, content):
    if isinstance(content, str):
        user_message = {"role": "user", "content": [{"text": content}]}
    else:
        user_message = {"role": "user", "content": content}
    messages.append(user_message)

def add_assistant_message(messages, content):
    if isinstance(content, str):
        assistant_message = {"role": "assistant", "content": [{"text": content}]}
    else:
        assistant_message = {"role": "assistant", "content": content}
    messages.append(assistant_message)

Vous voudrez également mettre à jour votre fonction de chat afin qu'elle renvoie à la fois le texte et la liste complète des parties :

python
def chat(messages, system=None, temperature=1.0, stop_sequences=[], tools=None):
    # ... code de configuration existant ...
    
    response = client.converse(**params)
    
    text = response["output"]["message"]["content"][0]["text"]
    parts = response["output"]["message"]["content"]
    
    return text, parts

Vérification du motif d'arrêt

La réponse de Claude inclut également un champ de premier niveau stopReason. Lorsqu'il est égal à "tool_use", Claude souhaite appeler un outil plutôt que de simplement fournir une réponse textuelle — c'est votre signal pour extraire les informations de l'outil et exécuter la fonction demandée. L'assistant chat() présenté ci-dessus n'expose pas encore ce champ, donc pour l'instant vous pouvez détecter l'utilisation d'un outil en vérifiant si la liste de parties renvoyée contient une entrée avec une clé toolUse. Vous étendrez chat() pour qu'elle renvoie directement stopReason dans une leçon ultérieure.

Avec ces schémas en place, vous êtes prêt à traiter les demandes d'utilisation d'outils de Claude et à maintenir un déroulement de conversation approprié tout au long des interactions multi-tours avec les outils.