memoria de agente de uip

Adjuntar, enumerar y eliminar espacios de memoria y elementos de memoria en un agente de código bajo con `memoria de agente de uip`.

uip agent memory gestiona las características de espacio de memoria asociadas a un agente: un espacio de memoria es una fuente de recuperación aumentada por recuperación (memoria episódica o de escalada) en la que el agente puede buscar en runtime. uip agent memory item gestiona los elementos clave/valor individuales sembrados en un espacio de memoria configurado.

Solo local: no es necesario iniciar sesión.

Sinopsis

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

Todas las invocaciones respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

adición de memoria de agente de uip

Adjunta un espacio de memoria al agente.

Argumentos

• <name> obligatorio) : nombre de la característica que se utilizará en el agente.

Opciones

Marca	Predeterminado	Obligatorio	Propósito
--memory-space <name>	—	Sí	Nombre del espacio de memoria que se va a adjuntar.
--folder-path <path>	—	Sí	Ruta de la carpeta donde existe el espacio de memoria.
--reference-key <key>	—		Clave de recurso de la solución de espacio de memoria.
--description <desc>	—		Descripción del espacio de memoria.
--threshold <n>	0		Umbral de puntuación de recuperación.
--result-count <n>	3		Número de resultados a recuperar (entero positivo).
--search-mode <mode>	hybrid		hybrid o semantic.
--field <name=weight>	—		Peso del campo de entrada. Repetible.
--disable-dynamic-few-shot	Desactivado		Adjunta el espacio de memoria sin habilitar la recuperación dinámica en pocos intentos (habilitada de forma predeterminada).
--path <path>	.		Ruta al directorio del proyecto del agente.

Ejemplo

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

Forma de datos (--json de salida)

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

lista de memoria de agente de uip

Opciones

Marca	Predeterminado	Propósito
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplo

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

Forma de datos (--json de salida)

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

eliminación de memoria de agente de uip

Argumentos

• <name> obligatorio) : nombre de la característica, nombre del espacio de memoria o ID a eliminar.

Opciones

Marca	Propósito
--folder-path <path>	Ruta de la carpeta, al eliminar por nombre de espacio de memoria.
--path <path>	Ruta al directorio del proyecto del agente (predeterminado .).

Ejemplo

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

Forma de datos (--json de salida)

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

Un espacio de memoria no encontrado por nombre/ID falla el comando con un código de salida distinto de cero.

adición de elemento de memoria de agente uip

Añade un elemento de memoria a un espacio de memoria configurado.

Argumentos

Nombre	Obligatorio	Propósito
<name>	Sí	Nombre de la característica, nombre del espacio de memoria o ID.
<key>	Sí	Clave de elemento de memoria.
<value>	Sí	Valor del elemento de memoria.

Opciones

Marca	Obligatorio	Propósito
--folder-path <path>		Ruta de la carpeta, al seleccionar por nombre de espacio de memoria.
--memory-type <type>	Sí	episodic (0) o escalation (1) — 01 también se aceptan valores numéricos /.
--description <desc>		Descripción del elemento de memoria.
--metadata <json>		Metadatos del elemento de memoria como un objeto JSON.
--path <path>		Ruta al directorio del proyecto del agente (predeterminado .).

Ejemplos

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

Forma de datos (--json de salida)

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

lista de elementos de memoria del agente de uip

Argumentos

• <name> obligatorio) : nombre de la característica, nombre del espacio de memoria o ID.

Opciones

Marca	Propósito
--folder-path <path>	Ruta de la carpeta, al seleccionar por nombre de espacio de memoria.
--path <path>	Ruta al directorio del proyecto del agente (predeterminado .).

Ejemplo

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

Forma de datos (--json de salida)

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

eliminación de elemento de memoria de agente uip

Argumentos

Nombre	Obligatorio	Propósito
<name>	Sí	Nombre de la característica, nombre del espacio de memoria o ID.
<key>	Sí	Clave o ID del elemento de memoria que se eliminará.

Opciones

Marca	Propósito
--folder-path <path>	Ruta de la carpeta, al seleccionar por nombre de espacio de memoria.
--path <path>	Ruta al directorio del proyecto del agente (predeterminado .).

Ejemplo

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

Forma de datos (--json de salida)

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

Relacionado

• uip agent validate : volver a ejecutar después de editar la configuración de la memoria.
• uip agent refresh : regenera los archivos derivados después de añadir un espacio de memoria.

Ver también

• Opciones globales, códigos de salida.