Обрезка текста укорачивает строку до максимальной длины и добавляет многоточие, когда содержимое удаляется. Агенты используют это для превью карточек, тизеров логов и подгонки фрагментов в узкие окна контекста перед отправкой полных документов в инструменты чанкинга или суммаризации.
Как это работает
Если длина ввода в пределах лимита, строка возвращается без изменений. Иначе инструмент оставляет первые maxLength кодовых единиц строки, затем заменяет последние три символа на ..., если хватает места — так видимый результат никогда не превышает заданный максимум. Многоточие входит в лимит, как в типичных превью UI.
Когда использовать
- Вписать вывод инструмента в лимиты символов UI или уведомлений
- Предпросмотр длинных ответов агентов в дашбордах или боковых панелях чата
- Собрать тизер перед вызовом chunk-text на полном теле
- Укоротить сообщения об ошибках или стек-трейсы для компактных логов
Пример
При максимальной длине 8 фраза hello world становится hello... (три точки входят в лимит). Более короткие вводы вроде hi проходят без многоточия.
Ограничения
Считает кодовые единицы UTF-16, а не графемные кластеры — некоторые эмодзи или комбинирующие знаки могут неожиданно разорваться. Максимальная длина должна быть больше длины многоточия (3). Инструмент не режет по границам слов; для разбиения с учётом предложений используйте chunk-text.