Tronquer le texte raccourcit une chaîne à une longueur maximale et ajoute des points de suspension lorsque du contenu est retiré. Les agents s’en servent pour des aperçus de cartes, des teasers de journal et pour faire tenir des extraits dans des fenêtres de contexte étroites avant d’envoyer des documents complets à des outils de découpage ou de résumé.
Fonctionnement
Si la longueur d’entrée est dans la limite, elle est renvoyée inchangée. Sinon l’outil conserve les premières maxLength unités de code de la chaîne, puis remplace les trois derniers caractères par ... s’il y a de la place—ainsi le résultat visible ne dépasse jamais le maximum configuré. Les points comptent dans la limite, comme dans les aperçus d’UI courants.
Quand l’utiliser
- Faire tenir la sortie d’un outil dans des limites de caractères d’UI ou de notifications
- Prévisualiser de longues réponses d’agents dans des tableaux de bord ou barres latérales de chat
- Construire un texte teaser avant d’appeler chunk-text sur le corps complet
- Raccourcir messages d’erreur ou traces de pile pour des affichages de journal compacts
Exemple
Avec une longueur max 8, la phrase hello world devient hello... (trois points comptent dans la limite). Des entrées plus courtes comme hi passent sans points de suspension.
Limites
Compte les unités de code UTF-16, pas les clusters de graphèmes—certains emoji ou marques combinées peuvent se scinder de façon inattendue. La longueur max doit être supérieure à celle des points (3). L’outil ne coupe pas aux frontières de mots ; utilisez chunk-text pour un découpage conscient des phrases.