Claude Academy
Cargando

La herramienta de edición de texto

Lección 305 min

Nota importante: Las cadenas de versión de la herramienta para todas las versiones del modelo se pueden encontrar aquí: https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Claude viene con una herramienta integrada que no necesitas crear desde cero: la herramienta de edición de texto. Esta herramienta le da a Claude la capacidad de trabajar con archivos y directorios tal como lo harías en un editor de texto estándar.

Qué puede hacer la herramienta de edición de texto

La herramienta de edición de texto proporciona a Claude un conjunto completo de capacidades de manipulación de archivos:

  • Ver el contenido de un archivo o directorio
  • Ver rangos específicos de líneas en un archivo
  • Reemplazar texto en un archivo
  • Crear nuevos archivos
  • Insertar texto en líneas específicas de un archivo
  • Deshacer ediciones recientes en archivos

Esto expande drásticamente las capacidades de Claude y esencialmente le otorga el poder de actuar como un ingeniero de software desde el primer momento.

Comprendiendo los requisitos de implementación

Aquí es donde las cosas se vuelven un poco confusas: aunque el esquema de la herramienta está integrado en Claude, aún necesitas proporcionar la implementación real. Piénsalo de esta manera: Claude sabe cómo solicitar operaciones de archivos, pero tú necesitas escribir el código que realmente realiza esas operaciones.

Cuando usas otras herramientas, escribes tanto el esquema JSON como la implementación de la función. Con la herramienta de edición de texto, Claude proporciona el conocimiento del esquema, pero tú debes escribir funciones para manejar las solicitudes de Claude de crear archivos, leer directorios, reemplazar texto, y así sucesivamente.

Versiones del esquema

Aunque el esquema principal está integrado en Claude, sí necesitas incluir un pequeño fragmento de esquema al hacer solicitudes. El esquema exacto depende de qué modelo de Claude estés usando:

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 ve este pequeño esquema y automáticamente lo expande a la especificación completa de la herramienta de edición de texto detrás de escena.

Ejemplo práctico

Veamos la herramienta de edición de texto en acción. Cuando le pides a Claude que trabaje con archivos, usará la herramienta para leer, modificar y crear archivos según sea necesario.

Por ejemplo, si le pides a Claude que "Abra el archivo ./main.py y resuma su contenido", Claude hará lo siguiente:

  1. Usar la herramienta de edición de texto para ver el archivo
  2. Leer el contenido
  3. Proporcionarte un resumen

Puedes llevar esto más lejos pidiéndole a Claude que modifique archivos. Por ejemplo: "Abre el archivo ./main.py y escribe una función para calcular pi hasta el 5.º dígito. Luego crea un archivo ./test.py para probar tu implementación."

Claude hará lo siguiente:

  1. Ver el archivo main.py existente
  2. Reemplazar su contenido con una nueva implementación que incluya la función de cálculo de pi
  3. Crear un nuevo archivo test.py con pruebas unitarias apropiadas

¿Por qué usar la herramienta de edición de texto?

Podrías preguntarte por qué existe esta herramienta cuando los editores de código modernos ya tienen asistentes de IA integrados. La herramienta de edición de texto se vuelve valiosa en escenarios donde:

  • Estás construyendo aplicaciones que necesitan editar archivos de forma programática
  • Estás trabajando en entornos sin acceso a editores de código con todas las funciones
  • Quieres integrar capacidades de edición de archivos directamente en tus aplicaciones impulsadas por Claude

Esencialmente, la herramienta de edición de texto te permite replicar gran parte de la funcionalidad de un elegante editor de código impulsado por IA dentro de tus propias aplicaciones, dándote un control detallado sobre cómo Claude interactúa con tu sistema de archivos.