UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Gedächtnis des UIP-Agents

Syntax and options for `uip agent memory`, which attaches, lists, and removes memory spaces on a low-code agent and adds or lists the items a deployed memory space holds.

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, and memory remove edit the local agent project. memory item add and memory item list read and write the deployed runtime memory space, and require login. Run uip login first.

Zusammenfassung​

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

Alle Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Hinzufügen zum UIP-Agentengedächtnis​

Hängen Sie einen Gedächtnisbereich an den Agent an.

Argumente​

  • <name> (erforderlich) – Funktionsname, der im Agent verwendet werden soll.

Optionen​

MarkierenStandardErforderlichZweck
--memory-space <name>–jaGedächtnisbereichsname, der angehängt werden soll.
--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>–Gedächtnisbereichsbeschreibung.
--threshold <n>0Schwellenwert für die Abrufpunktzahl.
--result-count <n>3Anzahl der abzurufenden Ergebnisse (positiver Integer).
--search-mode <mode>hybridhybrid oder semantic.
--field <name=weight>–Gewichtung des Eingabefelds. Wiederholbar.
--disable-dynamic-few-shotausHängen Sie den Gedächtnisbereich an, ohne den dynamischen Few-Shot-Abruf zu aktivieren (standardmäßig aktiviert).
--path <path>.Pfad zum Agent-Projektverzeichnis.

Solution resource​

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:

StatusBedeutung
NotInSolutionNo solution encloses the project. Nothing is declared or linked.
LinkedThe solution already declares this memory space. The feature carries its key.
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.

Beispiele​

# 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

Datenform (--output 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"
    }
  }
}

Gedächtnisliste des Agents​

Optionen​

MarkierenStandardZweck
--path <path>.Pfad zum Agent-Projektverzeichnis.

Beispiel​

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

Datenform (--output 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" }
  ]
}

UIP-Agentengedächtnis entfernen​

Argumente​

  • <name> (erforderlich) – Funktionsname, Gedächtnisbereichsname oder zu entfernende ID.

Optionen​

MarkierenZweck
--folder-path <path>Ordnerpfad beim Entfernen nach Gedächtnisbereichsnamen.
--path <path>Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiel​

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

Datenform (--output json)​

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

Ein Gedächtnisbereich, der nicht anhand von Name/ID gefunden wurde, schlägt den Befehl mit einem Exitcode ungleich Null fehl.

Hinzufügen eines UIP-Agent-Speicherelements​

Promote an agent run into the runtime memory space. The item type decides which run data the item comes from:

--memory-typeQuelleRequired options
episodic (oder 0 )Feedback left on a run's trace. Create it with uip traces feedback create.--feedback-id
escalation (oder 1 )An escalation span the agent raised. Find the trace and span IDs with uip traces spans get.--trace-id, --span-id

Argumente​

  • <name> (erforderlich) – Funktionsname, Gedächtnisbereichsname oder ID.

Optionen​

MarkierenErforderlichZweck
--memory-type <type>jaepisodic (0) or escalation (1).
--feedback-id <id>for episodicFeedback to promote.
--trace-id <id>for escalationTrace of the escalation span.
--span-id <id>for 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>Orchestrator folder key, instead of --folder-path.
--path <path>Pfad zum Agent-Projektverzeichnis (Standard: .).

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.

Beispiele​

# 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

Datenform (--output 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 der Gedächtniselemente des UIP-Agents​

List the items the runtime memory space holds, in the folder the solution is deployed to.

Argumente​

  • <name> (erforderlich) – Funktionsname, Gedächtnisbereichsname oder ID.

Optionen​

MarkierenZweck
--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>Orchestrator folder key, instead of --folder-path.
--path <path>Pfad zum Agent-Projektverzeichnis (Standard: .).

Beispiel​

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

Datenform (--output 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 – Nach der Bearbeitung der Speicherkonfiguration erneut ausführen.
  • uip agent refresh – Generiert abgeleitete Dateien neu, nachdem ein Gedächtnisbereich hinzugefügt wurde.

Siehe auch​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben