UiPath Documentation
uipath-cli
latest
false
Guía del usuario de UiPath CLI
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

memoria de agente de uip

Sintaxis y opciones para `memoria de agente de uip`, que adjunta, enumera y elimina espacios de memoria en un agente de código bajo y añade o enumera los elementos que contiene un espacio de memoria implementado.

uip agent memory 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 en la que el agente puede buscar en runtime. uip agent memory item añade y enumera los elementos que contiene un espacio de memoria en tiempo de ejecución. Los elementos provienen de ejecuciones de agente reales: comentarios dejados en el seguimiento de una ejecución (elementos episódicos) o un intervalo de escalada que el agente planteó (elementos de escalada).

memory add, memory list y memory remove editan el proyecto del agente local. memory item add y memory item list leen y escriben el espacio de memoria de runtime implementado y requieren inicio de sesión. Ejecuta uip login primero.

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> --memory-type episodic --feedback-id <id> [--folder-path <path> | --folder-key <key>] [--path <dir>]
uip agent memory item add  <name> --memory-type escalation --trace-id <id> --span-id <id> [--answer <text>] [--folder-path <path> | --folder-key <key>] [--path <dir>]
uip agent memory item list <name> [--memory-type <episodic|escalation>] [--folder-path <path> | --folder-key <key>] [--path <dir>]
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> --memory-type episodic --feedback-id <id> [--folder-path <path> | --folder-key <key>] [--path <dir>]
uip agent memory item add  <name> --memory-type escalation --trace-id <id> --span-id <id> [--answer <text>] [--folder-path <path> | --folder-key <key>] [--path <dir>]
uip agent memory item list <name> [--memory-type <episodic|escalation>] [--folder-path <path> | --folder-key <key>] [--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​

MarcaPredeterminadoObligatorioPropósito
--memory-space <name>—SíNombre del espacio de memoria que se va a adjuntar.
--folder-path <path>solution_folder dentro de una soluciónfuera de una soluciónRuta de la carpeta donde existe el espacio de memoria. Obligatorio cuando el proyecto de agente no está dentro de una solución.
--reference-key <key>—Clave de recurso de la solución de espacio de memoria. Cuando se omite, la clave se resuelve desde la solución circundante.
--description <desc>—Descripción del espacio de memoria.
--threshold <n>0Umbral de puntuación de recuperación.
--result-count <n>3Número de resultados a recuperar (entero positivo).
--search-mode <mode>hybridhybrid o semantic.
--field <name=weight>—Peso del campo de entrada. Repetible.
--disable-dynamic-few-shotDesactivadoAdjunta 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.

Recurso de solución​

Cuando el proyecto de agente está dentro de una solución y se omite --reference-key , memory add vincula la característica al recurso de espacio de memoria que declara la solución. Data.SolutionResource.Status informa del resultado:

EstadoSignificado
NotInSolutionNinguna solución encierra el proyecto. No se declara ni vincula nada.
LinkedLa solución ya declara este espacio de memoria. La característica lleva su clave.
CreatedEl espacio de memoria está en solution_folder y la solución no lo declaró. El comando lo declara en la solución y vincula la característica.
NotDeclaredEl espacio de memoria está en una carpeta distinta de solution_folder y la solución no lo declara. Instructions da el comando uip solution resources add --source remote para ejecutar.
ProvidedLa clave procedía de --reference-key.

Si la escritura de la característica falla después de que el comando declarara el espacio de memoria en la solución, el comando elimina esa declaración de nuevo. Consulta los recursos de la solución de uip para gestionar los recursos de la solución directamente.

Ejemplos​

# Standalone agent project: --folder-path is required
uip agent memory add SupportRecall --memory-space customer-support-recall --folder-path Shared --path ./my-agent

# Inside a solution: declare the memory space as a solution resource and link it
uip agent memory add SupportRecall --memory-space customer-support-recall --path ./my-agent
# Standalone agent project: --folder-path is required
uip agent memory add SupportRecall --memory-space customer-support-recall --folder-path Shared --path ./my-agent

# Inside a solution: declare the memory space as a solution resource and link it
uip agent memory add SupportRecall --memory-space customer-support-recall --path ./my-agent

Forma de datos (--json de salida)​

{
  "Code": "AgentMemoryAdd",
  "Data": {
    "Status": "Memory space added",
    "Name": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "FolderPath": "solution_folder",
    "DynamicFewShotEnabled": true,
    "Id": "a1b2c3d4-0000-0000-0000-000000000070",
    "ReferenceKey": "a1b2c3d4-0000-0000-0000-000000000071",
    "SolutionResource": {
      "Status": "Created",
      "Key": "a1b2c3d4-0000-0000-0000-000000000071",
      "Solution": "./MySolution/MySolution.uipx"
    }
  }
}
{
  "Code": "AgentMemoryAdd",
  "Data": {
    "Status": "Memory space added",
    "Name": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "FolderPath": "solution_folder",
    "DynamicFewShotEnabled": true,
    "Id": "a1b2c3d4-0000-0000-0000-000000000070",
    "ReferenceKey": "a1b2c3d4-0000-0000-0000-000000000071",
    "SolutionResource": {
      "Status": "Created",
      "Key": "a1b2c3d4-0000-0000-0000-000000000071",
      "Solution": "./MySolution/MySolution.uipx"
    }
  }
}

lista de memoria de agente de uip​

Opciones​

MarcaPredeterminadoPropósito
--path <path>.Ruta al directorio del proyecto del agente.

Ejemplo​

uip agent memory list --path ./my-agent
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" }
  ]
}
{
  "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​

MarcaPropó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
uip agent memory remove SupportRecall --path ./my-agent

Forma de datos (--json de salida)​

{ "Code": "AgentMemoryRemove", "Data": { "Status": "Memory space removed", "Name": "SupportRecall" } }
{ "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​

Promocionar una ejecución de agente en el espacio de memoria de runtime. El tipo de elemento decide de qué datos de ejecución proviene el elemento:

--memory-typeOrigenOpciones requeridas
episodic (o 0)Comentarios dejados en el seguimiento de una ejecución. Créalo con uip traces feedback create.--feedback-id
escalation (o 1)Un intervalo de escalada que el agente planteó. Busca los ID de seguimiento y de intervalo con uip traces spans get.--trace-id, --span-id

Argumentos​

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

Opciones​

MarcaObligatorioPropósito
--memory-type <type>Síepisodic (0) o escalation (1).
--feedback-id <id>para episodicComentarios para promocionar.
--trace-id <id>para escalationSeguimiento del intervalo de escalada.
--span-id <id>para escalationIntervalo de escalada al almacén.
--answer <text>Respuesta almacenada con un elemento de escalada.
--folder-path <path>cuando la carpeta de características está solution_folderCarpeta de Orchestrator en la que se encuentra el espacio de memoria en runtime. El valor predeterminado es la carpeta de la característica del agente.
--folder-key <key>Clave de carpeta de Orchestrator, en lugar de --folder-path
--path <path>Ruta al directorio del proyecto del agente (predeterminado .).

Aprueba --folder-path o --folder-key, no ambos. Cuando la característica apunte a solution_folder, pasa la carpeta en la que se implementa la solución; uip solution deploy list lo muestra.

Ejemplos​

# Promote feedback on a run as an episodic item
uip agent memory item add SupportRecall --memory-type episodic --feedback-id 2f1e0c3a-0000-0000-0000-000000000010 --folder-path Shared/MySolution --path ./my-agent

# Store an escalation, with its answer, as an escalation item
uip agent memory item add SupportRecall --memory-type escalation --trace-id 3c4d5e6f-0000-0000-0000-000000000020 --span-id 4d5e6f70-0000-0000-0000-000000000021 --answer "Refund within 14 days" --folder-key 5c1eab29-0000-0000-0000-000000000030 --path ./my-agent
# Promote feedback on a run as an episodic item
uip agent memory item add SupportRecall --memory-type episodic --feedback-id 2f1e0c3a-0000-0000-0000-000000000010 --folder-path Shared/MySolution --path ./my-agent

# Store an escalation, with its answer, as an escalation item
uip agent memory item add SupportRecall --memory-type escalation --trace-id 3c4d5e6f-0000-0000-0000-000000000020 --span-id 4d5e6f70-0000-0000-0000-000000000021 --answer "Refund within 14 days" --folder-key 5c1eab29-0000-0000-0000-000000000030 --path ./my-agent

Forma de datos (--json de salida)​

{
  "Code": "AgentMemoryItemAdd",
  "Data": {
    "Status": "Memory item added",
    "Memory": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "MemorySpaceId": "a1b2c3d4-0000-0000-0000-000000000090",
    "FolderPath": "Shared/MySolution",
    "FolderKey": "5c1eab29-0000-0000-0000-000000000030",
    "MemoryType": 0,
    "FeedbackId": "2f1e0c3a-0000-0000-0000-000000000010",
    "TraceId": null,
    "SpanId": null,
    "Id": "a1b2c3d4-0000-0000-0000-000000000080"
  }
}
{
  "Code": "AgentMemoryItemAdd",
  "Data": {
    "Status": "Memory item added",
    "Memory": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "MemorySpaceId": "a1b2c3d4-0000-0000-0000-000000000090",
    "FolderPath": "Shared/MySolution",
    "FolderKey": "5c1eab29-0000-0000-0000-000000000030",
    "MemoryType": 0,
    "FeedbackId": "2f1e0c3a-0000-0000-0000-000000000010",
    "TraceId": null,
    "SpanId": null,
    "Id": "a1b2c3d4-0000-0000-0000-000000000080"
  }
}

Para un elemento de escalada, FeedbackId es null, y TraceId y SpanId llevan los valores pasados.

lista de elementos de memoria del agente de uip​

Enumera los elementos que contiene el espacio de memoria de runtime, en la carpeta en la que se implementa la solución.

Argumentos​

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

Opciones​

MarcaPropósito
--memory-type <type>Solo elementos de este tipo: episodic (0) o escalation (1).
--folder-path <path>Carpeta de Orchestrator en la que se encuentra el espacio de memoria en runtime. El valor predeterminado es la carpeta de la característica del agente; requerido cuando esa carpeta es solution_folder.
--folder-key <key>Clave de carpeta de Orchestrator, en lugar de --folder-path
--path <path>Ruta al directorio del proyecto del agente (predeterminado .).

Ejemplo​

uip agent memory item list SupportRecall --folder-path Shared/MySolution --path ./my-agent
uip agent memory item list SupportRecall --folder-path Shared/MySolution --path ./my-agent

Forma de datos (--json de salida)​

{
  "Code": "AgentMemoryItemList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000080",
      "MemoryType": 0,
      "Status": 0,
      "FeedbackId": "2f1e0c3a-0000-0000-0000-000000000010",
      "TraceId": null,
      "SpanId": null,
      "AgentId": "a1b2c3d4-0000-0000-0000-000000000001",
      "UserEmail": "jane.doe@example.com",
      "UpdateTime": "2026-09-29T14:00:00.000Z"
    }
  ]
}
{
  "Code": "AgentMemoryItemList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000080",
      "MemoryType": 0,
      "Status": 0,
      "FeedbackId": "2f1e0c3a-0000-0000-0000-000000000010",
      "TraceId": null,
      "SpanId": null,
      "AgentId": "a1b2c3d4-0000-0000-0000-000000000001",
      "UserEmail": "jane.doe@example.com",
      "UpdateTime": "2026-09-29T14:00:00.000Z"
    }
  ]
}
  • 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​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado