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.