UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

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​

DrapeauDefaultRequisObjectif
--memory-space <name>—ouiNom de l’espace de mémoire à associer.
--folder-path <path>solution_folder inside a solutionoutside a solutionFolder 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>0Seuil du score de récupération.
--result-count <n>3Nombre de résultats à récupérer (entier positif).
--search-mode <mode>hybridhybrid ou semantic.
--field <name=weight>—Charger le champ d’entrée. Répétable.
--disable-dynamic-few-shotdé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
NotInSolutionAucune solution ne entoure le projet. Rien n’est déclaré ou lié.
LinkedLa solution déclare déjà cet espace de mémoire. La fonctionnalité porte sa clé.
CreatedThe memory space is in solution_folder and the solution did not declare it. The command declares it in the solution and links the feature.
NotDeclaredThe 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.
ProvidedThe 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​

DrapeauDefaultObjectif
--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​

DrapeauObjectif
--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-typeSourceRequired 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​

DrapeauRequisObjectif
--memory-type <type>ouiepisodic (0) or escalation (1).
--feedback-id <id>Pour episodicFeedback to promote.
--trace-id <id>Pour escalationTrace of the escalation span.
--span-id <id>Pour escalationEscalation span to store.
--answer <text>Answer stored with an escalation item.
--folder-path <path>when the feature folder is solution_folderOrchestrator 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​

DrapeauObjectif
--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"
    }
  ]
}
  • 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​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour