Claude Academy
Chargement

L'outil d'édition de texte

Leçon 305 min

Remarque importante : les chaînes de version d'outil pour toutes les versions de modèle peuvent être trouvées ici : https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Claude est livré avec un outil intégré que vous n'avez pas besoin de créer à partir de zéro : l'outil d'édition de texte. Cet outil donne à Claude la capacité de travailler avec des fichiers et des répertoires, tout comme vous le feriez dans un éditeur de texte standard.

Ce que l'outil d'édition de texte peut faire

L'outil d'édition 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
  • Annuler les modifications récentes apportées aux fichiers

Cela élargit considérablement les capacités de Claude et lui donne 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 toujours fournir l'implémentation réelle. Pensez-y ainsi : Claude sait comment demander des opérations sur les fichiers, mais vous devez écrire le code qui effectue réellement ces opérations.

Lorsque vous utilisez d'autres outils, vous écrivez à la fois le schéma JSON et l'implémentation de la fonction. Avec l'outil d'édition 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 du 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 de vos 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-7-sonnet"):
        return {
            "type": "text_editor_20250124",
            "name": "str_replace_editor",
        }
    elif model.startswith("claude-3-5-sonnet"):
        return {
            "type": "text_editor_20241022", 
            "name": "str_replace_editor",
        }

Claude voit ce petit schéma et l'étend automatiquement en la spécification complète de l'outil d'édition de texte en arrière-plan.

Exemple pratique

Voyons l'outil d'édition 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 d'édition 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'au 5ème chiffre. 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 d'édition 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 d'édition de texte devient précieux dans les scénarios où :

  • Vous construisez 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 d'édition de fichiers directement dans vos applications alimentées par Claude

Essentiellement, l'outil d'édition 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.