Tronca testo accorcia una stringa a una lunghezza massima e aggiunge i puntini di sospensione quando si rimuove contenuto. Gli agent lo usano per anteprime di card, teaser di log e per far entrare snippet in finestre di contesto strette prima di inviare documenti interi a tool di chunking o riassunto.
Come funziona
Se la lunghezza dell’input è entro il limite, viene restituita invariata. Altrimenti lo strumento mantiene le prime maxLength unità di codice della stringa, poi sostituisce gli ultimi tre caratteri con ... quando c’è spazio—così il risultato visibile non supera mai il massimo configurato. I puntini contano nel limite, come nei pattern comuni di anteprima UI.
Quando usarlo
- Far entrare l’output di un tool nei limiti di caratteri di UI o notifiche
- Anteprima di risposte agent lunghe in dashboard o sidebar di chat
- Creare testo teaser prima di chiamare chunk-text sul corpo completo
- Accorciare messaggi di errore o stack trace per log compatti
Esempio
Con lunghezza massima 8, la frase hello world diventa hello... (tre punti contano nel limite). Input più corti come hi passano senza puntini.
Limiti
Conta unità di codice UTF-16, non cluster di grafemi—alcuni emoji o segni combinati possono spezzarsi in modo inatteso. La lunghezza massima deve essere maggiore della lunghezza dei puntini (3). Lo strumento non spezza ai confini di parola; usa chunk-text per la suddivisione consapevole delle frasi.