Chargement

Exécuter les fonctions d'outils

Leçon 2510 min
Chargement

Lorsque Claude répond avec une demande d'utilisation d'outils, votre serveur doit réellement exécuter l'outil demandé et renvoyer les résultats. Cette étape implique d'extraire les parties d'utilisation d'outils de la réponse de Claude, d'exécuter les fonctions appropriées, et de formater correctement les résultats.

Gérer les demandes d'outils multiples

Claude peut envoyer plusieurs parties d'utilisation d'outils dans une seule réponse. Votre code doit gérer cette possibilité de manière défensive. Un message d'assistant peut contenir une partie texte suivie d'une, deux, voire davantage de parties d'utilisation d'outils.

Parties d'un message d'assistant : une partie « Texte » proposant de trouver l'heure actuelle et une partie « toolUse » pour get_current_datetime.

Le flux fonctionne ainsi : Claude envoie une demande avec un schéma JSON, reçoit une partie d'utilisation d'outils, puis votre serveur exécute l'outil et renvoie une partie de résultat d'outil afin que Claude puisse fournir une réponse finale.

Notre serveur envoie à Claude le message utilisateur « Quelle heure est-il ? », la partie texte et la partie d'utilisation d'outils de l'assistant, puis une partie de résultat d'outil.

Extraire les parties d'utilisation d'outils

Créez d'abord une fonction pour traiter toutes les parties renvoyées par une demande de conversation :

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]

Cette compréhension filtre la liste des parties pour n'inclure que les dictionnaires contenant une clé « toolUse », en ignorant les parties texte.

Exécuter les outils réels

Créez une fonction d'assistance pour exécuter l'outil demandé :

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

Le détail essentiel ici est l'utilisation de **tool_input pour déployer le dictionnaire d'arguments dans votre fonction d'outil. Claude renvoie toujours les arguments sous forme d'objet dictionnaire, vous devez donc le décompresser correctement.

Créer les parties de résultat d'outil

Après avoir exécuté un outil, vous devez formater la réponse sous forme de partie de résultat d'outil :

Une liste de contenu de message d'assistant avec une partie texte et deux parties « toolUse », pour get_current_datetime et other_tool.

Les parties de résultat d'outil nécessitent trois propriétés clés :

  • toolUseId - Doit correspondre à l'ID de la partie d'utilisation d'outils d'origine
  • content - La sortie de votre outil, sérialisée sous forme de chaîne de caractères
  • status - Soit « success », soit « error »

Comprendre les ID d'utilisation d'outils

Le système d'ID d'utilisation d'outils devient important lorsque Claude demande plusieurs outils en parallèle. Par exemple, si Claude souhaite exécuter un outil de calculatrice deux fois :

Claude envoie les utilisations d'outils de calculatrice ab3 pour 10 + 10 et po9 pour 30 + 30 ; notre serveur renvoie la sortie po9 60 et la sortie ab3 20. Claude envoie les utilisations d'outils de calculatrice ab3 pour 10 + 10 et po9 pour 30 + 30 ; notre serveur renvoie la sortie po9 60 et la sortie ab3 20.

Chaque utilisation d'outil reçoit un ID unique (comme « ab3 » et « po9 »), et vos résultats d'outils doivent inclure les ID correspondants afin que Claude sache quel résultat correspond à quelle demande.

Gestion des erreurs

Encadrez l'exécution de vos outils dans des blocs try-catch. Claude est intelligent face aux erreurs d'outils et peut ajuster son approche si vous renvoyez des informations d'erreur appropriées :

python
try:
    tool_output = run_tool(tool_name, tool_input)
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": json.dumps(tool_output)}],
            "status": "success"
        }
    }
except Exception as e:
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": f"Error: {e}"}],
            "status": "error"
        }
    }

Implémentation complète

Voici la fonction complète qui traite les demandes d'outils et renvoie les résultats formatés :

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]
        
        try:
            tool_output = run_tool(tool_name, tool_input)
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": json.dumps(tool_output)}],
                    "status": "success"
                }
            }
        except Exception as e:
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": f"Error: {e}"}],
                    "status": "error"
                }
            }
        
        tool_result_parts.append(tool_result_part)
    
    return tool_result_parts

Une fois que vous disposez des parties de résultat d'outil, vous pouvez les renvoyer à Claude dans votre prochaine demande de conversation, complétant ainsi le cycle d'utilisation d'outils.