Text kürzen verkürzt eine Zeichenkette auf eine Maximallänge und hängt eine Ellipse an, wenn Inhalt entfernt wird. Agenten nutzen das für Karten-Vorschauen, Log-Teaser und das Einpassen von Snippets in enge Kontextfenster, bevor vollständige Dokumente an Chunking- oder Zusammenfassungs-Tools gehen.
So funktioniert es
Liegt die Eingabelänge im Limit, wird sie unverändert zurückgegeben. Sonst behält das Tool die ersten maxLength Codeeinheiten der Zeichenkette und ersetzt die letzten drei Zeichen durch ..., wenn Platz ist—so überschreitet das sichtbare Ergebnis nie das konfigurierte Maximum. Die Ellipse zählt zum Limit und entspricht gängigen UI-Vorschau-Mustern.
Wann Sie es nutzen
- Tool-Ausgabe in UI- oder Benachrichtigungs-Zeichenlimits einpassen
- Lange Agent-Antworten in Dashboards oder Chat-Seitenleisten vorzeigen
- Teaser-Text bauen, bevor chunk-text auf den vollen Körper angewendet wird
- Fehlermeldungen oder Stacktraces für kompakte Log-Anzeigen kürzen
Beispiel
Bei Maximallänge 8 wird die Phrase hello world zu hello... (drei Punkte zählen zum Limit). Kürzere Eingaben wie hi bleiben ohne Ellipse.
Einschränkungen
Zählt UTF-16-Codeeinheiten, keine Graphem-Cluster—manche Emoji oder kombinierte Zeichen können unerwartet gespalten werden. Die Maximallänge muss größer als die Ellipsenlänge (3) sein. Das Tool bricht nicht an Wortgrenzen; für satzbewusstes Teilen nutzen Sie chunk-text.