Mémoire d’agent UIP

Joignez, répertoriez et supprimez les espaces de mémoire et les éléments de mémoire sur un agent low-code avec « uip agent Memory ».

uip agent memory gère les fonctionnalités d'espace de mémoire associées à un agent: un espace de mémoire est une source de rappel augmentée par récupération (mémoire épisodique ou d'escalade) que l'agent peut rechercher au moment de l'exécution. uip agent memory item gère les éléments clé/valeur individuels répartis dans un espace de mémoire configuré.

Local uniquement — aucune connexion requise.

Synthèse

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>]

Toutes les invocations respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

Ajouter une mémoire d’agent uip

Associez un espace de mémoire à l’agent.

Arguments

• <name> (requis) : le nom de la fonctionnalité à utiliser dans l'agent.

Options

Drapeau	Default	Requis	Objectif
--memory-space <name>	—	oui	Nom de l’espace de mémoire à associer.
--folder-path <path>	—	oui	Chemin d’accès au dossier où se trouve l’espace de mémoire.
--reference-key <key>	—		Clé de ressource de solution d’espace de mémoire.
--description <desc>	—		Description de l’espace de mémoire.
--threshold <n>	0		Seuil du score de récupération.
--result-count <n>	3		Nombre de résultats à récupérer (entier positif).
--search-mode <mode>	hybrid		hybrid ou semantic.
--field <name=weight>	—		Charger le champ d’entrée. Répétable.
--disable-dynamic-few-shot	désactivé		Associez l'espace de mémoire sans activer la récupération dynamique en quelques exemples (activé par défaut).
--path <path>	.		Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Liste des mémoires d’agent UIP

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Suppression de la mémoire d’agent uip

Arguments

• <name> (requis) : le nom de la fonctionnalité, le nom de l'espace de mémoire ou l'ID à supprimer.

Options

Drapeau	Objectif
--folder-path <path>	Chemin d’accès au dossier, lors de la suppression par nom d’espace de mémoire.
--path <path>	Chemin d'accès au répertoire du projet d'agent (par défaut .).

Exemple

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

Format des données (--sortie json)

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

Un espace de mémoire introuvable par nom/ID échoue la commande avec un code de sortie non nul.

Ajouter un élément de mémoire d’agent uip

Ajoutez un élément de mémoire à un espace de mémoire configuré.

Arguments

Nom	Requis	Objectif
<name>	oui	Nom de la fonctionnalité, nom de l’espace de mémoire ou ID.
<key>	oui	Clé d’élément de mémoire.
<value>	oui	Valeur de l’élément de mémoire.

Options

Drapeau	Requis	Objectif
--folder-path <path>		Chemin d’accès au dossier, lors de la sélection par nom d’espace de mémoire.
--memory-type <type>	oui	episodic (0) ou escalation (1) — les valeurs numériques 0/1 sont également acceptées.
--description <desc>		Description de l’élément de mémoire.
--metadata <json>		Métadonnées de l’élément de mémoire en tant qu’objet JSON.
--path <path>		Chemin d'accès au répertoire du projet d'agent (par défaut .).

Exemples

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

Format des données (--sortie json)

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

Liste des éléments de mémoire d’agent uip

Arguments

• <name> (requis) : le nom de la fonctionnalité, le nom de l'espace de mémoire ou l'ID.

Options

Drapeau	Objectif
--folder-path <path>	Chemin d’accès au dossier, lors de la sélection par nom d’espace de mémoire.
--path <path>	Chemin d'accès au répertoire du projet d'agent (par défaut .).

Exemple

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

Format des données (--sortie json)

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

Supprimer l’élément de mémoire d’agent uip

Arguments

Nom	Requis	Objectif
<name>	oui	Nom de la fonctionnalité, nom de l’espace de mémoire ou ID.
<key>	oui	Clé ou ID de l’élément de mémoire à supprimer.

Options

Drapeau	Objectif
--folder-path <path>	Chemin d’accès au dossier, lors de la sélection par nom d’espace de mémoire.
--path <path>	Chemin d'accès au répertoire du projet d'agent (par défaut .).

Exemple

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

Format des données (--sortie json)

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

Associé

• uip agent validate — réexécuté après modification de la configuration de la mémoire.
• uip agent refresh — régénère les fichiers dérivés après l'ajout d'un espace de mémoire.

Voir également

• Options globales, codes de sortie.