Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > NORA | 360° > NORA l 360° AI > NORA l 360° AI Überblick

NORA - Manage address building block

Technischer Name: agorum_smartorga_ai_nora_manage_address

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins NORA l 360° AI. Für Informationen zur Verwendung dieses KI-Tools in Ihren Presets siehe NORA l 360° AI einrichten.

Was macht das Tool?

Dieses Tool erstellt oder aktualisiert Adress-Bausteine (Building Blocks) im NORA-/360°-Adresssystem, z. B. Adressdaten, Telefonnummern, E-Mail-Adressen oder Weblinks. Es unterstützt zwei Aktionen: create (Baustein an einem Zielobjekt anlegen) und update (bestehenden Baustein ändern). Als Ergebnis werden uuid, name und ein objectLink zurückgegeben.

Empfohlener Einsatzzweck

Verwenden Sie dieses Tool, wenn Sie Kontaktdaten zu Firmenadressen oder Kontaktpersonen in NORA ergänzen oder pflegen möchten. Typische Szenarien: Telefonnummer hinzufügen, Standard-E-Mail setzen, Website-Link ergänzen oder Anschrift ändern.

Funktionsbeschreibung

Parameter Beschreibung
addressType
(Pflicht)		 Typ des Adress-Bausteins (Enum):
  • data: Adressdaten (z. B. street1, houseNumber1, zip, city, state, country, ...)
  • phone: Telefonnummer (z. B. type, phoneNumber, defaultNumber)
  • mail: E-Mail-Adresse (z. B. mailAddress, defaultMailAddress)
  • link: Website/Link (z. B. link, subject, defaultLink)
action
(Pflicht)		 Aktion (Enum):
  • create: legt einen neuen Baustein am target an
  • update: aktualisiert einen bestehenden Baustein über id
target
(optional)		 Nur für action = create relevant: Business-Objekt, Firmenadresse oder Person, an dem/der der Baustein angelegt wird.
Hinweis: Wenn ein Business-Objekt übergeben wird, wird die Firmenadresse automatisch aufgelöst.
id
(optional)		 Nur für action = update relevant: Der bestehende Baustein (UUID/Pfad), der aktualisiert wird.
data
(Pflicht)		 Key/Value-Map der Felder des jeweiligen Bausteins.
Beispiele:
  • phone: { "type": "telephone", "phoneNumber": "+49 711 1", "defaultNumber": true }
  • mail: { "mailAddress": "info@x.de", "defaultMailAddress": true }
  • link: { "link": "https://x.de", "subject": "Website", "defaultLink": true }
  • data: { "street1": "Musterstr.", "houseNumber1": "1", "zip": "70173", "city": "Stuttgart", "country": "de" }

Beispiel-Prompt

Bitte ergänze bei folgendem Kunden die Telefonnummer als Standardnummer:
Target: <UUID oder Pfad des Business-Objekts oder der Firmenadresse>
addressType: phone
action: create
Daten:
- type: telephone
- phoneNumber: +49 711 123456
- defaultNumber: true

Kennzeichnung KI-erstellter Objekte

Objekte, die über dieses Tool von ALBERT | AI angelegt werden, werden automatisch als Erstellt von ALBERT gekennzeichnet (Metadaten agorum_ai_created_by_ai und agorum_ai_chat_id). So ist auf einen Blick erkennbar, welche Objekte automatisiert entstanden sind. 

Tipps und Tricks

Tipp: Für action=create musst du target setzen, für action=update musst du id setzen. Wenn du unsicher bist, ob du einen bestehenden Baustein aktualisieren oder einen neuen anlegen sollst, lies vorher das Objekt (oder seine Bausteine) aus und entscheide dann.