Outils de code Qwen

Qwen Code inclut des outils intégrés que le modèle utilise pour interagir avec votre environnement local, accéder à des informations et effectuer des actions. Ces outils améliorent les capacités du CLI, lui permettant d’aller au-delà de la génération de texte et de vous aider dans un large éventail de tâches.

Aperçu des outils Qwen Code

Dans le contexte de Qwen Code, les outils sont des fonctions ou modules spécifiques que le modèle peut demander d’exécuter. Par exemple, si vous demandez au modèle de “Résumer le contenu de my_document.txt”, il identifiera probablement le besoin de lire ce fichier et demandera l’exécution de l’outil read_file.

Le composant principal (packages/core) gère ces outils, présente leurs définitions (schémas) au modèle, les exécute lorsqu’ils sont demandés et renvoie les résultats au modèle pour un traitement supplémentaire dans une réponse destinée à l’utilisateur.

Ces outils fournissent les capacités suivantes :

Accès aux informations locales : Les outils permettent au modèle d’accéder à votre système de fichiers local, de lire le contenu des fichiers, de lister les répertoires, etc.
Exécution de commandes : Avec des outils comme run_shell_command, le modèle peut exécuter des commandes shell (avec des mesures de sécurité appropriées et confirmation de l’utilisateur).
Interaction avec le web : Les outils peuvent récupérer du contenu à partir d’URLs.
Réalisation d’actions : Les outils peuvent modifier des fichiers, écrire de nouveaux fichiers ou effectuer d’autres actions sur votre système (là encore, généralement avec des protections).
Ancrage des réponses : En utilisant des outils pour récupérer des données en temps réel ou des données locales spécifiques, les réponses peuvent être plus précises, pertinentes et ancrées dans votre contexte actuel.

Comment utiliser les outils Qwen Code

Pour utiliser les outils Qwen Code, il suffit de fournir un prompt au CLI. Le processus fonctionne comme suit :

Vous fournissez un prompt au CLI.
Le CLI envoie le prompt au core.
Le core, accompagné de votre prompt et de l’historique de conversation, transmet la liste des outils disponibles ainsi que leurs descriptions/schémas à l’API du modèle configuré.
Le modèle analyse votre requête. S’il détermine qu’un outil est nécessaire, sa réponse inclura une demande d’exécution d’un outil spécifique avec certains paramètres.
Le core reçoit cette demande d’outil, la valide, puis (souvent après confirmation de l’utilisateur pour les opérations sensibles) exécute l’outil.
La sortie de l’outil est renvoyée au modèle.
Le modèle utilise la sortie de l’outil pour formuler sa réponse finale, qui est ensuite transmise via le core jusqu’au CLI et affichée à l’utilisateur.

En général, vous verrez des messages dans le CLI indiquant quand un outil est appelé, ainsi que s’il a réussi ou échoué.

Sécurité et confirmation

De nombreux outils, en particulier ceux qui peuvent modifier votre système de fichiers ou exécuter des commandes (write_file, edit, run_shell_command), sont conçus avec la sécurité en tête. Qwen Code va généralement :

Demander une confirmation : Vous invite à confirmer avant d’exécuter des opérations potentiellement sensibles, en vous montrant l’action qui va être effectuée.
Utiliser le sandboxing : Tous les outils sont soumis aux restrictions imposées par le sandboxing (voir Sandboxing dans Qwen Code). Cela signifie que lors d’une exécution dans un sandbox, tous les outils (y compris les serveurs MCP) que vous souhaitez utiliser doivent être disponibles à l’intérieur de l’environnement du sandbox. Par exemple, pour exécuter un serveur MCP via npx, l’exécutable npx doit être installé dans l’image Docker du sandbox ou être disponible dans l’environnement sandbox-exec.

Il est important de toujours lire attentivement les messages de confirmation avant d’autoriser un outil à continuer.

En savoir plus sur les outils de Qwen Code

Les outils intégrés de Qwen Code peuvent être classés de la manière suivante :

Outils du système de fichiers : Pour interagir avec les fichiers et répertoires (lecture, écriture, listage, recherche, etc.).
Outil Shell (run_shell_command) : Pour exécuter des commandes shell.
Outil Web Fetch (web_fetch) : Pour récupérer le contenu d’URLs.
Outil Web Search (web_search) : Pour effectuer des recherches sur le web.
Outil Multi-File Read (read_many_files) : Un outil spécialisé pour lire le contenu de plusieurs fichiers ou répertoires, souvent utilisé par la commande @.
Outil Mémoire (save_memory) : Pour sauvegarder et rappeler des informations entre différentes sessions.
Outil Todo Write (todo_write) : Pour créer et gérer des listes de tâches structurées pendant les sessions de codage.

En outre, ces outils intègrent :

Serveurs MCP : Les serveurs MCP agissent comme un pont entre le modèle et votre environnement local ou d’autres services tels que les APIs.
Sandboxing : Le sandboxing isole le modèle et ses modifications de votre environnement afin de réduire les risques potentiels.