Truncar texto acorta una cadena a una longitud máxima y añade puntos suspensivos cuando se elimina contenido. Los agentes lo usan para vistas previas de tarjetas, teasers de registro y encajar fragmentos en ventanas de contexto estrechas antes de enviar documentos completos a herramientas de troceo o resumen.
Cómo funciona
Si la longitud de entrada está dentro del límite, se devuelve sin cambios. Si no, la herramienta conserva las primeras maxLength unidades de código de la cadena y sustituye los tres últimos caracteres por ... cuando hay espacio—así el resultado visible nunca supera el máximo configurado. Los puntos cuentan para el límite, como en patrones habituales de vista previa de UI.
Cuándo usarlo
- Encajar la salida de una herramienta en límites de caracteres de UI o notificaciones
- Previsualizar respuestas largas de agentes en paneles o barras laterales de chat
- Crear texto teaser antes de llamar a chunk-text sobre el cuerpo completo
- Recortar mensajes de error o trazas de pila para registros compactos
Ejemplo
Con longitud máxima 8, la frase hello world se convierte en hello... (tres puntos cuentan para el límite). Entradas más cortas como hi pasan sin puntos suspensivos.
Limitaciones
Cuenta unidades de código UTF-16, no clústeres de grafemas—algunos emoji o marcas combinadas pueden partirse de forma inesperada. La longitud máxima debe ser mayor que la de los puntos (3). La herramienta no corta en límites de palabra; usa chunk-text para división consciente de oraciones.