Gedächtnis des UIP-Agents

Anhängen, Auflisten und Entfernen von Gedächtnisbereichen und Gedächtniselementen auf einem Low-Code-Agent mit „UIP Agent Memory“.

uip agent memory verwaltet die Gedächtnisbereichsfunktionen, die an einen Agent angehängt sind: Ein Gedächtnisbereich ist eine abrufbare erweiterte Rückrufquelle (Episodisches oder Eskalationsgedächtnis), nach der der Agent zur Runtime suchen kann. uip agent memory item verwaltet einzelne Schlüssel-/Wertelemente, die in einen konfigurierten Gedächtnisbereich eingefügt werden.

Nur lokal – keine Anmeldung erforderlich.

Zusammenfassung

uip agent memory add    <name> --memory-space <name> --folder-path <path> [--reference-key <key>] [--description <desc>] [--threshold <n>] [--result-count <n>] [--search-mode <hybrid|semantic>] [--field <name=weight>]... [--disable-dynamic-few-shot] [--path <dir>]
uip agent memory list                                                                                                                                                                                                                            [--path <dir>]
uip agent memory remove <name> [--folder-path <path>]                                                                                                                                                                                             [--path <dir>]

uip agent memory item add    <name> <key> <value> --memory-type <episodic|escalation> [--folder-path <path>] [--description <desc>] [--metadata <json>] [--path <dir>]
uip agent memory item list   <name> [--folder-path <path>]                                                                                                                                                                                        [--path <dir>]
uip agent memory item remove <name> <key> [--folder-path <path>]                                                                                                                                                                                  [--path <dir>]

Alle Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Hinzufügen zum UIP-Agentengedächtnis

Hängen Sie einen Gedächtnisbereich an den Agent an.

Argumente

• <name> (erforderlich) – Funktionsname, der im Agent verwendet werden soll.

Optionen

Markieren	Standard	Erforderlich	Zweck
--memory-space <name>	–	ja	Gedächtnisbereichsname, der angehängt werden soll.
--folder-path <path>	–	ja	Ordnerpfad, in dem sich der Gedächtnisbereich befindet.
--reference-key <key>	–		Ressourcenschlüssel der Lösung für den Gedächtnisbereich.
--description <desc>	–		Gedächtnisbereichsbeschreibung.
--threshold <n>	0		Schwellenwert für die Abrufpunktzahl.
--result-count <n>	3		Anzahl der abzurufenden Ergebnisse (positiver Integer).
--search-mode <mode>	hybrid		hybrid oder semantic.
--field <name=weight>	–		Gewichtung des Eingabefelds. Wiederholbar.
--disable-dynamic-few-shot	aus		Hängen Sie den Gedächtnisbereich an, ohne den dynamischen Few-Shot-Abruf zu aktivieren (standardmäßig aktiviert).
--path <path>	.		Pfad zum Agent-Projektverzeichnis.

Beispiel

uip agent memory add SupportRecall --memory-space customer-support-recall --folder-path Shared --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentMemoryAdd",
  "Data": {
    "Status": "Memory space added",
    "Name": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "FolderPath": "Shared",
    "DynamicFewShotEnabled": true,
    "Id": "a1b2c3d4-0000-0000-0000-000000000070"
  }
}

Gedächtnisliste des Agents

Optionen

Markieren	Standard	Zweck
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiel

uip agent memory list --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentMemoryList",
  "Data": [
    { "Name": "SupportRecall", "MemorySpace": "customer-support-recall", "FolderPath": "Shared", "DynamicFewShotEnabled": true, "Id": "a1b2c3d4-0000-0000-0000-000000000070" }
  ]
}

UIP-Agentengedächtnis entfernen

Argumente

• <name> (erforderlich) – Funktionsname, Gedächtnisbereichsname oder zu entfernende ID.

Optionen

Markieren	Zweck
--folder-path <path>	Ordnerpfad beim Entfernen nach Gedächtnisbereichsnamen.
--path <path>	Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiel

uip agent memory remove SupportRecall --path ./my-agent

Datenform (--output json)

{ "Code": "AgentMemoryRemove", "Data": { "Status": "Memory space removed", "Name": "SupportRecall" } }

Ein Gedächtnisbereich, der nicht anhand von Name/ID gefunden wurde, schlägt den Befehl mit einem Exitcode ungleich Null fehl.

Hinzufügen eines UIP-Agent-Speicherelements

Fügen Sie ein Gedächtniselement zu einem konfigurierten Gedächtnisbereich hinzu.

Argumente

Name	Erforderlich	Zweck
<name>	ja	Funktionsname, Gedächtnisbereichsname oder ID.
<key>	ja	Speicherelementschlüssel.
<value>	ja	Gedächtniselementwert.

Optionen

Markieren	Erforderlich	Zweck
--folder-path <path>		Ordnerpfad, wenn nach Gedächtnisbereichsname ausgewählt wird.
--memory-type <type>	ja	episodic (0) oder escalation (1) – numerische Werte 0/1 werden ebenfalls akzeptiert.
--description <desc>		Beschreibung des Gedächtniselements.
--metadata <json>		Metadaten des Gedächtniselements als JSON-Objekt.
--path <path>		Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiele

uip agent memory item add SupportRecall customer-tier gold --memory-type episodic --metadata '{"source":"seed"}' --path ./my-agent

uip agent memory item add SupportRecall escalation-case pending --memory-type escalation --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentMemoryItemAdd",
  "Data": { "Status": "Memory item added", "Memory": "SupportRecall", "Key": "customer-tier", "MemoryType": 0, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
}

Liste der Gedächtniselemente des UIP-Agents

Argumente

• <name> (erforderlich) – Funktionsname, Gedächtnisbereichsname oder ID.

Optionen

Markieren	Zweck
--folder-path <path>	Ordnerpfad, wenn nach Gedächtnisbereichsname ausgewählt wird.
--path <path>	Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiel

uip agent memory item list SupportRecall --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentMemoryItemList",
  "Data": [
    { "Key": "customer-tier", "Value": "gold", "MemoryType": 0, "Description": null, "Metadata": { "source": "seed" }, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
  ]
}

Entfernen des Gedächtniselements von UIP-Agents

Argumente

Name	Erforderlich	Zweck
<name>	ja	Funktionsname, Gedächtnisbereichsname oder ID.
<key>	ja	Zu entfernender Gedächtniselementschlüssel oder -ID.

Optionen

Markieren	Zweck
--folder-path <path>	Ordnerpfad, wenn nach Gedächtnisbereichsname ausgewählt wird.
--path <path>	Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiel

uip agent memory item remove SupportRecall customer-tier --path ./my-agent

Datenform (--output json)

{ "Code": "AgentMemoryItemRemove", "Data": { "Status": "Memory item removed", "Memory": "SupportRecall", "Key": "customer-tier" } }

Zugehörig

• uip agent validate – Nach der Bearbeitung der Speicherkonfiguration erneut ausführen.
• uip agent refresh – Generiert abgeleitete Dateien neu, nachdem ein Gedächtnisbereich hinzugefügt wurde.

Siehe auch

• Globale Optionen, Exitcodes.