- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- encodeur UIP
- uip ancrage dans le contexte
- UiPath Docsai
- Fonction UiP
- garde-fous UiP
- configuration llm uip
- uip llm-passerelle
- Création uip maestro
- Registre Maestro uip
- uip model-hub
- Tâches (Jobs)
- Dossiers
- Processus
- ROI du processus
- Paquets
- Machines
- Utilisateurs
- Rôles
- Licences
- Flux
- Pièces jointes (Attachments)
- Sessions
- Calendriers
- magasins d'informations d’identification
- journaux-audit
- paramètres
- Actifs
- Compartiments
- Compartiment-fichiers
- Bibliothèques
- Files d'attente (Queues)
- ROI de la file d'attente
- éléments de la file d'attente
- Déclencheurs (Triggers)
- Webhooks
- Activités - Rechercher
- activités get-Default-xaml
- Analyser
- liste règles-analyseurs
- Construire
- Nettoyage
- Installation de entités data-fabrics
- liste des entités data-fabrics
- Diff de fichiers
- Get-Library-Object-Repository
- Récupérer le référentiel d'objets
- Init
- liste des instances
- Créer un package
- Vérification des paquets
- Installation des paquets
- Versions de paquets
- Publier
- Distant
- restore
- exécuter, déboguer et amp; Exécution
- paramètres
- Début de Studio
- Recherche de modèles
- entité ajoutée aux données de test
- Ajouter une file d'attente de données de test
- variation d'ajout de données de test
- TM
- UIA
- Valider
- exemples de workflow - Obtenir
- liste d'exemples de workflow
- tâches UIP
- pièce jointe
- Champ personnalisé
- Défauts (Defects)
- Exécutions
- exporter-tâches
- Migration
- Libellé Objet
- Créer un package
- scénarios-perf
- groupes-de-charge-scénarios-perf
- données d’exécution de perf-scenario
- rapport de scénarios de performances
- Projet
- autorisations-projet
- Invites
- Rapport
- Prérequis
- Résultat
- Exécuter
- Planifications (Schedules)
- Journaux de cas de test
- Cas de test
- Ensembles de tests
- Journal des étapes de test
- Utilisateur (User)
- Attendre
- Traçages UIP
- Commentaires sur les traces UIP
- Migration
- Référence et assistance
Mémoire d’agent UIP
Syntaxe et options de `uip agent Memory`, qui attache, répertorie et supprime les espaces de mémoire sur un agent low-code et ajoute ou répertorie les éléments contenus dans un espace de mémoire déployé.
uip agent memory manages the memory-space features attached to an agent: a memory space is a retrieval-augmented recall source the agent can search against at runtime. uip agent memory item adds and lists the items a memory space holds at runtime. Items come from real agent runs: feedback left on a run's trace (episodic items) or an escalation span the agent raised (escalation items).
memory add, memory list et memory remove modifient le projet d'agent local. memory item add et memory item list lisent et écrivent l'espace de mémoire du runtime déployé et nécessitent une connexion. Exécutez d'abord uip login .
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> --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>]
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> | solution_folder inside a solution | outside a solution | Folder path where the memory space exists. Required when the agent project is not inside a solution. |
--reference-key <key> | — | Memory space solution resource key. When omitted, the key is resolved from the enclosing solution. | |
--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. |
Ressource de solution
When the agent project is inside a solution and --reference-key is omitted, memory add links the feature to the memory space resource the solution declares. Data.SolutionResource.Status reports the outcome:
| État (Status) | Signification |
|---|---|
NotInSolution | Aucune solution ne entoure le projet. Rien n’est déclaré ou lié. |
Linked | La solution déclare déjà cet espace de mémoire. La fonctionnalité porte sa clé. |
Created | The memory space is in solution_folder and the solution did not declare it. The command declares it in the solution and links the feature. |
NotDeclared | The memory space is in a folder other than solution_folder and the solution does not declare it. Instructions gives the uip solution resources add --source remote command to run. |
Provided | The key came from --reference-key. |
If writing the feature fails after the command declared the memory space in the solution, the command removes that declaration again. Refer to uip solution resources to manage solution resources directly.
Exemples
# 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
Format des données (--sortie json)
{
"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"
}
}
}
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
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" }
]
}
{
"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
uip agent memory remove SupportRecall --path ./my-agent
Format des données (--sortie json)
{ "Code": "AgentMemoryRemove", "Data": { "Status": "Memory space removed", "Name": "SupportRecall" } }
{ "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
Promouvoir l'exécution d'un agent dans l'espace de mémoire de runtime. Le type d'élément décide des données d'exécution provenant de l'élément:
--memory-type | Source | Required options |
|---|---|---|
episodic (ou 0 ) | Feedback left on a run's trace. Create it with uip traces feedback create. | --feedback-id |
escalation (ou 1 ) | An escalation span the agent raised. Find the trace and span IDs with uip traces spans get. | --trace-id, --span-id |
Arguments
<name>(requis) : le nom de la fonctionnalité, le nom de l'espace de mémoire ou l'ID.
Options
| Drapeau | Requis | Objectif |
|---|---|---|
--memory-type <type> | oui | episodic (0) or escalation (1). |
--feedback-id <id> | Pour episodic | Feedback to promote. |
--trace-id <id> | Pour escalation | Trace of the escalation span. |
--span-id <id> | Pour escalation | Escalation span to store. |
--answer <text> | Answer stored with an escalation item. | |
--folder-path <path> | when the feature folder is solution_folder | Orchestrator folder the memory space lives in at runtime. Defaults to the folder of the agent feature. |
--folder-key <key> | Clé de dossier Orchestrator, au lieu de --folder-path. | |
--path <path> | Chemin d'accès au répertoire du projet d'agent (par défaut .). |
Pass either --folder-path or --folder-key, not both. When the feature points at solution_folder, pass the folder the solution is deployed to; uip solution deploy list shows it.
Exemples
# 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
Format des données (--sortie json)
{
"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"
}
}
For an escalation item, FeedbackId is null, and TraceId and SpanId carry the values passed.
Liste des éléments de mémoire d’agent uip
Répertoriez les éléments que contient l’espace de mémoire de runtime, dans le dossier où la solution est déployée.
Arguments
<name>(requis) : le nom de la fonctionnalité, le nom de l'espace de mémoire ou l'ID.
Options
| Drapeau | Objectif |
|---|---|
--memory-type <type> | Only items of this type: episodic (0) or escalation (1). |
--folder-path <path> | Orchestrator folder the memory space lives in at runtime. Defaults to the folder of the agent feature; required when that folder is solution_folder. |
--folder-key <key> | Clé de dossier Orchestrator, au lieu de --folder-path. |
--path <path> | Chemin d'accès au répertoire du projet d'agent (par défaut .). |
Exemple
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
Format des données (--sortie json)
{
"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"
}
]
}
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
- Synthèse
- Ajouter une mémoire d’agent uip
- Arguments
- Options
- Ressource de solution
- Exemples
- Format des données (--sortie json)
- Liste des mémoires d’agent UIP
- Options
- Exemple
- Format des données (--sortie json)
- Suppression de la mémoire d’agent uip
- Arguments
- Options
- Exemple
- Format des données (--sortie json)
- Ajouter un élément de mémoire d’agent uip
- Arguments
- Options
- Exemples
- Format des données (--sortie json)
- Liste des éléments de mémoire d’agent uip
- Arguments
- Options
- Exemple
- Format des données (--sortie json)
- Associé
- Voir également