- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- codificador UIP
- Contextualización de UIP
- UIP Docsai
- Función uip
- barreras de seguridad de UIP
- Configuración de UIP llm
- puerta de enlace llm de uip
- Creación de UIP Maestro
- Registro maestro de UIP
- UIP model-hub
- Actividades Buscar
- actividades get-default-xaml
- Analizar
- lista de reglas del analizador
- Crear
- Limpieza
- instalación de data-fabric-entities
- lista de entidades de data-fabric
- diferencia de archivos
- obtener-repositorio-de-objetos-de-biblioteca
- obtener-objeto-repositorio
- Init
- lista de instancias
- Paquete
- inspeccionar paquetes
- instalación de paquetes
- versiones de paquetes
- Publicar
- Remoto
- restore
- ejecutar, depurar & Ejecución
- Configuración
- Inicio de Studio
- Búsqueda de plantillas
- entidad de adición de datos de prueba
- añadir-cola de datos de prueba
- añadir-variación de los datos de prueba
- TM
- UIA
- Validar
- ejemplos-de-flujo-de-flujo-obtener
- lista de ejemplos de flujo de trabajo
- Tareas de UIP
- Archivo adjunto
- Campo personalizado
- Defects
- Ejecuciones
- exportar-trabajos
- Migración
- EtiquetaDeObjeto
- Paquete
- escenario de rendimiento
- grupos de carga de escenarios de rendimiento
- datos de ejecución de perf-scenario
- informe de escenario de rendimiento
- Proyecto
- permisos del proyecto
- Solicitudes
- Informar
- Requisitos
- Resultado
- Iniciar
- Programaciones
- Registro de casos de prueba
- Casos de prueba
- Conjuntos de prueba
- registro de pasos de prueba
- Usuario
- Esperar
- Seguimientos de UIP
- Comentarios de seguimientos de UIP
- Migración
- Referencia y soporte
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
| Marca | Predeterminado | Obligatorio | Propósito |
|---|---|---|---|
--memory-space <name> | — | Sí | Nombre del espacio de memoria que se va a adjuntar. |
--folder-path <path> | solution_folder dentro de una solución | fuera de una solución | Ruta 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> | 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. |
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:
| Estado | Significado |
|---|---|
NotInSolution | Ninguna solución encierra el proyecto. No se declara ni vincula nada. |
Linked | La solución ya declara este espacio de memoria. La característica lleva su clave. |
Created | El 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. |
NotDeclared | El 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. |
Provided | La 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
| Marca | Predeterminado | Propó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
| 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
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-type | Origen | Opciones 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
| Marca | Obligatorio | Propósito |
|---|---|---|
--memory-type <type> | Sí | episodic (0) o escalation (1). |
--feedback-id <id> | para episodic | Comentarios para promocionar. |
--trace-id <id> | para escalation | Seguimiento del intervalo de escalada. |
--span-id <id> | para escalation | Intervalo 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_folder | 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. |
--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
| Marca | Propó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"
}
]
}
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
- Sinopsis
- adición de memoria de agente de uip
- Argumentos
- Opciones
- Recurso de solución
- Ejemplos
- Forma de datos (--json de salida)
- lista de memoria de agente de uip
- Opciones
- Ejemplo
- Forma de datos (--json de salida)
- eliminación de memoria de agente de uip
- Argumentos
- Opciones
- Ejemplo
- Forma de datos (--json de salida)
- adición de elemento de memoria de agente uip
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- lista de elementos de memoria del agente de uip
- Argumentos
- Opciones
- Ejemplo
- Forma de datos (--json de salida)
- Relacionado
- Ver también