Chargement

L'outil de modification de texte

Leçon 305 min

Remarque importante : les chaînes de version d'outil pour toutes les versions de modèles se trouvent ici : https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Chargement

Claude est fourni avec un outil intégré que vous n'avez pas besoin de créer de toutes pièces : l'outil de modification de texte. Cet outil donne à Claude la capacité de travailler avec des fichiers et des répertoires, tout comme vous le feriez avec un éditeur de texte standard.

Ce que l'outil de modification de texte peut faire

L'outil de modification de texte fournit à Claude un ensemble complet de capacités de manipulation de fichiers :

  • Afficher le contenu d'un fichier ou d'un répertoire
  • Afficher des plages spécifiques de lignes dans un fichier
  • Remplacer du texte dans un fichier
  • Créer de nouveaux fichiers
  • Insérer du texte à des lignes spécifiques dans un fichier

L'outil de modification de texte est intégré à Claude, mais seulement son schéma, vous devez donc fournir l'implémentation de l'outil réel.

Cela élargit considérablement les capacités de Claude et lui confère essentiellement le pouvoir d'agir comme un ingénieur logiciel dès le départ.

Comprendre les exigences d'implémentation

Voici où les choses deviennent un peu confuses : bien que le schéma de l'outil soit intégré à Claude, vous devez tout de même fournir l'implémentation réelle. Voyez-le de cette façon : Claude sait comment demander des opérations sur les fichiers, mais vous devez écrire le code qui effectue réellement ces opérations.

Le schéma JSON text_editor_tool_schema et une case « Fonction » affichant trois points d'interrogation, la fonction que vous devez écrire.

Lorsque vous utilisez d'autres outils, vous écrivez à la fois le schéma JSON et l'implémentation de la fonction. Avec l'outil de modification de texte, Claude fournit la connaissance du schéma, mais vous devez écrire des fonctions pour traiter les demandes de Claude visant à créer des fichiers, lire des répertoires, remplacer du texte, et ainsi de suite.

Versions de schéma

Bien que le schéma principal soit intégré à Claude, vous devez tout de même inclure un petit stub de schéma lors des requêtes. Le schéma exact dépend du modèle Claude que vous utilisez :

python
def get_text_edit_schema(model):
    if model.startswith("claude-3"):
        return {
            "type": "text_editor_20250124",
            "name": "str_replace_editor",
        }
    else:
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }

Éditeur de code avec main.py ouvert, dont le seul contenu est l'en-tête de fonction « def greeting » et une ligne 2 vide.

Claude voit ce petit schéma et l'étend automatiquement dans la spécification complète de l'outil de modification de texte en coulisses.

Exemple pratique

Voyons l'outil de modification de texte en action. Lorsque vous demandez à Claude de travailler avec des fichiers, il utilisera l'outil pour lire, modifier et créer des fichiers selon les besoins.

Par exemple, si vous demandez à Claude d'« Ouvrir le fichier ./main.py et de résumer son contenu », Claude va :

  1. Utiliser l'outil de modification de texte pour afficher le fichier
  2. Lire le contenu
  3. Vous fournir un résumé

Vous pouvez aller plus loin en demandant à Claude de modifier des fichiers. Par exemple : « Ouvre le fichier ./main.py et écris une fonction pour calculer pi jusqu'à la 5ème décimale. Crée ensuite un fichier ./test.py pour tester ton implémentation. »

Claude va :

  1. Afficher le fichier main.py existant
  2. Remplacer son contenu par une nouvelle implémentation incluant la fonction de calcul de pi
  3. Créer un nouveau fichier test.py avec des tests unitaires appropriés

Pourquoi utiliser l'outil de modification de texte ?

Vous vous demandez peut-être pourquoi cet outil existe alors que les éditeurs de code modernes disposent déjà d'assistants IA intégrés. L'outil de modification de texte devient utile dans les scénarios suivants :

  • Vous développez des applications qui doivent modifier des fichiers de manière programmatique
  • Vous travaillez dans des environnements sans accès à des éditeurs de code complets
  • Vous souhaitez intégrer des capacités de modification de fichiers directement dans vos applications propulsées par Claude

Essentiellement, l'outil de modification de texte vous permet de reproduire une grande partie des fonctionnalités d'un éditeur de code sophistiqué alimenté par l'IA au sein de vos propres applications, vous donnant un contrôle précis sur la façon dont Claude interagit avec votre système de fichiers.