icon_search – Verfügbare Icons nach Namen suchen (ALBERT | AI Tool)

Anzeigename: Icon search

Interner Name: agorum_ai_dev_icon_search

Was macht das Tool?

Das Tool listet die in agorum core verfügbaren Icons auf und durchsucht sie nach ihrem Namen. Die Namen stammen aus der Icon-Bibliothek von agorum core (Plugin agorum.icons), es werden also genau die Icons geliefert, die auf dem System tatsächlich registriert sind.

• Ohne Suchbegriff liefert das Tool alle Icon-Namen, begrenzt durch die angegebene Höchstzahl.
• Mit Suchbegriff liefert das Tool nur die Icons, deren Name den Suchbegriff enthält. Groß- und Kleinschreibung spielt dabei keine Rolle.

Das Tool liest nur und verändert nichts im System.

Empfohlener Einsatzzweck

Verwenden Sie das Tool immer dann, wenn die KI in einer Konfiguration ein Icon angeben muss, etwa in einem aguila-Widget, einem Decorator, einem Menüeintrag oder einer NORA | 360° Deklaration. Die KI prüft damit, ob ein Icon-Name existiert, statt ihn zu raten. Ein falscher Icon-Name fällt sonst erst in der Oberfläche auf.

Das Tool ist Bestandteil der Toolgruppe agorum_ai_dev_external_development_tools für externe Coding Agents und steht damit auch über MCP zur Verfügung.

Funktionsbeschreibung

Parameter	Beschreibung
query (optional)	Suchbegriff, nach dem die Icon-Namen gefiltert werden. Gefunden werden alle Icons, deren Name den Begriff enthält; Groß- und Kleinschreibung wird nicht beachtet. Ohne Angabe werden alle Icons geliefert.
limit (optional)	Höchstzahl der gelieferten Icon-Namen. Erlaubt sind Werte von 1 bis 10000. Standard: 100

Rückgabe

Das Tool liefert ein JSON-Objekt mit folgenden Angaben:

Feld	Beschreibung
total	Anzahl aller Icons, die auf den Suchbegriff passen - unabhängig von limit.
returned	Anzahl der tatsächlich gelieferten Icon-Namen.
icons	Liste der Icon-Namen.

{
  "total": 12,
  "returned": 12,
  "icons": ["...", "..."]
}

Beispiel-Prompt

Ich brauche für den Menüeintrag "Rechnung prüfen" ein passendes Icon.
Suche mit dem Tool icon_search nach Icons, deren Name "receipt" oder "document" enthält,
und schlage mir drei passende Icons vor.

Tipps und Tricks