Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen


agorum_ai_agents_library_basic_update_address

Anzeigename: Updates an address in agorum core

Was macht das Tool?

Dieses Tool dient dazu, Adressdaten in agorum core gezielt zu ändern und zu aktualisieren. Es unterstützt verschiedene Adresstypen wie Adressbuch, Organisation, Abteilung, Person, E-Mail, Telefonnummer, Adressdaten (Straße, Stadt etc.), Link und Info. Für jeden Typ können spezifische Metadaten aktualisiert werden. Die Änderung erfolgt immer auf Basis der eindeutigen Objekt-ID (id/UUID) des zu ändernden Adressobjekts.

Empfohlener Einsatzzweck

Das Tool eignet sich, um Adressdaten zentral und automatisiert zu pflegen oder zu aktualisieren – etwa im Rahmen von Integrationen oder Massenänderungen, bei denen Adressinformationen in agorum core aktuell gehalten werden müssen.

Funktionsbeschreibung

Parameter Beschreibung
type
(Pflicht)
Gibt an, welcher Adresstyp geändert werden soll. Mögliche Werte: book, organisation, department, person, mail, phone, data, link, info.
id
(Pflicht)
Die ID oder UUID des zu ändernden Objekts. Akzeptiert werden agorum core IDs, UUIDs oder Pfade.
book
(Optional)
Objekt mit Feldern für Adressbuch: name (Name des Adressbuchs), description (Beschreibung).
organisation
(Optional)
Objekt mit Feldern für Organisation: name, additionalName1, additionalName2, customerNumber, taxNumber, description, salesTaxIdentificationNumber.
department
(Optional)
Objekt mit Feldern für Abteilung: name, additionalName1, additionalName2, customerNumber, taxNumber, description, salesTaxIdentificationNumber.
person
(Optional)
Objekt mit Feldern für Person: salutation (mr, mrs, mrmrs, family), title, givenName, familyName, familyStatus (unmarried, married, unknown), dateOfBirth (ISO), description, sex (male, female, unknown), placeOfBirth, maidenName, welcomeMessage.
mail
(Optional)
Objekt mit Feldern für E-Mail: mailAddress, defaultMailAddress (boolean).
phone
(Optional)
Optional. Objekt mit Feldern für Telefonnummer: type (telephone, mobile, fax), defaultNumber (boolean), phoneNumber (Format: +Land Vorwahl Nummer[-Durchwahl]).
data
(Optional)
Objekt mit Feldern für Adressdaten: street1, zip, city, state, country (ISO-Code), postBox, zipPostBox, cityPostBox, houseNumber1.
link
(Optional)
Objekt mit Feldern für Link: link (URL), defaultLink (boolean), subject (Beschreibung).
info
(Optional)
Objekt mit Feldern für Info: jobTitle (Pflicht), activityRate (Prozentsatz).
 

Beispiel-Prompt

Aktualisiere die Telefonnummer für die Adresse mit der UUID 8d5b55f0-2ca3-11f0-9c15-02420a0a0005:

{
  "type": "phone",
  "id": "8d5b55f0-2ca3-11f0-9c15-02420a0a0005",
  "phone": {
    "phoneNumber": "+49 711 123456",
    "defaultNumber": false,
    "type": "telephone"
  }
}

Tipps und Tricks

Tipp: Das Tool gibt nach erfolgreicher Änderung die UUID und einen Direktlink zum geänderten Objekt zurück.