- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
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
| Markieren | Standard | Erforderlich | Zweck |
|---|---|---|---|
--memory-space <name> | – | ja | Gedächtnisbereichsname, der angehängt werden soll. |
--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> | – | Gedächtnisbereichsbeschreibung. | |
--threshold <n> | 0 | Schwellenwert für die Abrufpunktzahl. | |
--result-count <n> | 3 | Anzahl der abzurufenden Ergebnisse (positiver Integer). | |
--search-mode <mode> | hybrid | hybrid oder semantic. | |
--field <name=weight> | – | Gewichtung des Eingabefelds. Wiederholbar. | |
--disable-dynamic-few-shot | aus | Hä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:
| Status | Bedeutung |
|---|---|
NotInSolution | No solution encloses the project. Nothing is declared or linked. |
Linked | The solution already declares this memory space. The feature carries its key. |
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.
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
| Markieren | Standard | Zweck |
|---|---|---|
--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
| Markieren | Zweck |
|---|---|
--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-type | Quelle | Required 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
| Markieren | Erforderlich | Zweck |
|---|---|---|
--memory-type <type> | ja | episodic (0) or escalation (1). |
--feedback-id <id> | for episodic | Feedback to promote. |
--trace-id <id> | for escalation | Trace of the escalation span. |
--span-id <id> | for 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> | 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
| Markieren | Zweck |
|---|---|
--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"
}
]
}
Zugehörig
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
- Zusammenfassung
- Hinzufügen zum UIP-Agentengedächtnis
- Argumente
- Optionen
- Solution resource
- Beispiele
- Datenform (--output json)
- Gedächtnisliste des Agents
- Optionen
- Beispiel
- Datenform (--output json)
- UIP-Agentengedächtnis entfernen
- Argumente
- Optionen
- Beispiel
- Datenform (--output json)
- Hinzufügen eines UIP-Agent-Speicherelements
- Argumente
- Optionen
- Beispiele
- Datenform (--output json)
- Liste der Gedächtniselemente des UIP-Agents
- Argumente
- Optionen
- Beispiel
- Datenform (--output json)
- Zugehörig
- Siehe auch