NORA - Search objects

Technischer Name: agorum_smartorga_ai_nora_search_objects

Was macht das Tool?

Dieses Tool sucht NORA l 360° Objekte über eine Solr-Suche in agorum core. Die Suche kombiniert alle angegebenen Kriterien per AND. Als Ergebnis liefert das Tool ein Objekt mit total und (optional) rows. Pro Treffer kann, abhängig von den Parametern, zusätzlich ein objectLink und/oder der reine Textinhalt (contentonly) zurückgegeben werden.

Empfohlener Einsatzzweck

Verwenden Sie das Tool, wenn Sie NORA l 360° Objekte (z. B. Aufgaben, Kontakte, Vorgänge usw.) anhand von Typ, Name, Nummer und/oder Metadaten gezielt finden und anschließend mit den gefundenen Objekten weiterarbeiten möchten (z. B. Details anzeigen, verknüpfen, Status prüfen). Besonders geeignet ist es für strukturierte Abfragen, bei denen die Metadatenfelder des jeweiligen NORA l 360° Typs bekannt sind.

Funktionsbeschreibung

Parameter	Beschreibung
aiContextToolPrompt (optional)	Ein Freitext-Prompt, der beim Laden des Tools automatisch in den System-Kontext des Chats eingefügt wird. Über diesen Parameter können Sie dem Tool feste Arbeitsanweisungen, Regeln oder zusätzlichen Kontext mitgeben, ohne dass die KI den Parameter selbst sieht oder setzen kann. Der Wert wird nicht an die KI als Tool-Parameter übertragen. Stattdessen wird der Text vor jedem KI-Aufruf gesammelt und dem System-Prompt vorangestellt. Typische Anwendungsfälle: Feste Regeln vorgeben, zusätzlichen Kontext liefern oder das Verhalten der KI bei der Nutzung des Tools steuern. Standard: – (kein Prompt)
identifier (optional)	NORA-Typ-Identifier, auf den eingeschränkt werden soll (exakter Match). Beispiele: agorum.smartorga.task
parent (optional)	Parent-NORA-Objekt (Objekt-ID). Wenn gesetzt, werden nur Objekte unterhalb dieses Parents gesucht.
name (optional)	Sucht im NORA-Namen (Feld: acso2_name).
number (optional)	Sucht in der NORA-Nummer (Feld: acso2_number).
metadata (optional)	Key/Value-Map für zusätzliche Metadatenkriterien. Die Metadatennamen müssen der Solr-Syntax entsprechen und komplett kleingeschrieben werden. Beispiel: { "agorum_smartorga_status": "agorum.smartorga.status.todo" }
query (optional)	Zusätzlicher roher Solr-Query-Fragment-String, der per AND zur Suche hinzugefügt wird.
limit (optional)	Maximale Anzahl Treffer, die zurückgegeben werden. Wertebereich: 0 bis 10000 Standard: 10
withObjectLink (optional)	Steuert, ob pro Treffer ein objectLink zurückgegeben wird. true: pro Treffer wird zusätzlich objectLink ergänzt false: kein objectLink in den Trefferzeilen Standard: true
sort (optional)	Sortierreihenfolge(n) als Array. Beispiele: ["lastmodifydate desc"] ["acso2_name asc"] Standard: "lastmodifydate desc" (wenn nichts übergeben wird)
properties (optional)	Liste der Properties/Spalten, die pro Treffer in rows zurückgegeben werden sollen. Die Namen müssen komplett kleingeschrieben werden. Wichtige Hinweise: uuid wird immer zurückgegeben (auch wenn nicht angegeben, wird es automatisch ergänzt). Wenn contentonly enthalten ist, wird zusätzlich row.contentonly mit dem Textinhalt des Objekts gefüllt. Beispiel: ["uuid", "acso2_name", "acso2_number", "identifier", "contentonly"] Standard: ["uuid"]
total (optional)	Wenn true, wird ausschließlich die Anzahl der Treffer (total) zurückgegeben. Es werden dann keine rows geliefert. true: nur { total, query } false: { total, query, rows: [...] } Standard: false

Beispiel-Prompt

Bitte suche NORA-Aufgaben, deren Name "Angebot" enthält.
Gib mir maximal 20 Treffer zurück und liefere pro Treffer Name, Nummer und die Beschreibung.

Tipps und Tricks