UiPath Documentation
uipath-cli
latest
false
UiPath CLI ユーザー ガイド
重要 :
このコンテンツは機械翻訳によって処理されています。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

UIP エージェント メモリ

「uip agent memory」の構文とオプション。ローコード エージェント上のメモリ空間をアタッチ、一覧表示、削除し、デプロイされたメモリ空間が保持している項目を追加または一覧表示します。

uip agent memory は、エージェントにアタッチされたメモリ空間機能を管理します。メモリ空間は、エージェントが実行時に検索できる、検索拡張された再現源です。uip agent memory item は、実行時にメモリ空間が保持する項目を追加して一覧表示します。項目は実際のエージェントの実行から取得されます。つまり、実行のトレースに残されたフィードバック (エピソード的な項目) またはエージェントが起こしたエスカレーションの範囲 (エスカレーション項目) です。

memory add、 memory list、 memory remove ローカル エージェント プロジェクトを編集します。デプロイされたランタイム メモリ空間の読み取りと書き込みをmemory item addおよびmemory item listし、ログインが必要です。最初に uip login を実行します。

概要​

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

すべての呼び出しは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。終了コードは 標準契約に従います。

UIP エージェント メモリの追加​

エージェントにメモリ空間をアタッチします。

引数​

  • <name> (必須) — エージェントで使用する機能名です。

オプション​

フラグ既定 (Default)Required目的
--memory-space <name>—○アタッチするメモリ空間名です。
--folder-path <path>solution_folder ソリューションの内部ソリューションの外部にあるメモリ空間が存在するフォルダー パス。エージェント プロジェクトがソリューション内にない場合に必要です。
--reference-key <key>—メモリ空間ソリューション リソース キー。省略すると、キーは包含するソリューションから解決されます。
--description <desc>—メモリ空間の説明。
--threshold <n>0取得スコアのしきい値。
--result-count <n>3取得する結果の数です (正の整数)。
--search-mode <mode>hybridhybrid または semantic。
--field <name=weight>—入力フィールドの重み付け繰り返し可能。
--disable-dynamic-few-shot無効動的少数ショット取得を有効にせずにメモリ空間をアタッチします (既定で有効化)。
--path <path>.エージェント プロジェクト ディレクトリへのパスです。

ソリューションのリソース​

エージェント プロジェクトがソリューション内にあり、 --reference-key が省略されている場合、 memory add は、ソリューションが宣言したメモリ空間リソースにその機能をリンクします。Data.SolutionResource.Status 結果を報告します。

ステータス意味
NotInSolutionプロジェクトを囲む解決策はありません。何も宣言またはリンクされていません。
Linkedソリューションはすでにこのメモリ空間を宣言しています。この機能には鍵があります。
Createdメモリ空間は solution_folder にあり、ソリューションはそれを宣言していません。コマンドは、ソリューションで宣言し、フィーチャーをリンクします。
NotDeclaredメモリ空間が solution_folder 以外のフォルダーにあり、ソリューションで宣言されていません。Instructions 、実行する uip solution resources add --source remote コマンドを指定します。
Provided鍵は --reference-keyから出た。

コマンドがソリューション内のメモリ空間を宣言した後に機能の書き込みが失敗した場合、コマンドはその宣言を再度削除します。ソリューション リソースを直接管理するには、「 uip ソリューションのリソース 」をご覧ください。

# 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

データシェイプ(--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"
    }
  }
}

UIP エージェント メモリのリスト​

オプション​

フラグ既定 (Default)目的
--path <path>.エージェント プロジェクト ディレクトリへのパスです。
uip agent memory list --path ./my-agent
uip agent memory list --path ./my-agent

データシェイプ(--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 エージェントのメモリの削除​

引数​

  • <name> (必須) — 削除する機能名、メモリ空間名、または ID です。

オプション​

フラグ目的
--folder-path <path>フォルダー パス (メモリ空間名で削除する場合)。
--path <path>エージェントのプロジェクト ディレクトリへのパスです (既定 .)。
uip agent memory remove SupportRecall --path ./my-agent
uip agent memory remove SupportRecall --path ./my-agent

データシェイプ(--output json)​

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

名前/ID で見つからないメモリー・スペースは、ゼロ以外の終了コードでコマンドに失敗します。

UIP エージェント メモリ アイテムの追加​

エージェントの実行をランタイム メモリ空間に昇格させます。項目の種類によって、項目の取得元となる実行データが決まります。

--memory-typeソース必要なオプション
episodic (または 0)実行のトレースに残されたフィードバック。uip traces feedback createを使用して作成します。--feedback-id
escalation (または 1)エージェントが発生したエスカレーションの範囲。でトレース ID とスパン ID を見つけ uip traces spans get。--trace-id, --span-id

引数​

  • <name> (必須) — 機能名、メモリ空間名、または ID です。

オプション​

フラグRequired目的
--memory-type <type>○episodic (0) または escalation (1)。
--feedback-id <id>対象: episodic昇格するフィードバック。
--trace-id <id>対象: escalationエスカレーションの範囲のトレース。
--span-id <id>対象: escalationストアへのエスカレーションの範囲。
--answer <text>回答はエスカレーション アイテムとともに保存されます。
--folder-path <path>機能フォルダーが solution_folderOrchestrator フォルダー: 実行時にメモリ空間が存在するフォルダーです。既定値は、エージェント機能のフォルダーです。
--folder-key <key>Orchestrator のフォルダー キー ( --folder-pathではなく )。
--path <path>エージェントのプロジェクト ディレクトリへのパスです (既定 .)。

両方ではなく、 --folder-path または --folder-keyのいずれかを渡します。機能が solution_folderを指している場合、ソリューションのデプロイ先フォルダーを渡します。uip solution deploy listがそれを示しています。

# 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

データシェイプ(--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"
  }
}

エスカレーション アイテムの場合、 FeedbackId は nullで、 TraceId と SpanId は渡された値を保持します。

UIP エージェント メモリ アイテムのリスト​

ソリューションのデプロイ先フォルダー内の、実行時メモリ空間が保持している項目のリストを作成します。

引数​

  • <name> (必須) — 機能名、メモリ空間名、または ID です。

オプション​

フラグ目的
--memory-type <type>この種類の項目のみ: episodic (0) または escalation (1)。
--folder-path <path>Orchestrator フォルダー: 実行時にメモリ空間が存在するフォルダーです。既定値は、エージェント機能のフォルダーです。そのフォルダーが solution_folderの場合、必須です。
--folder-key <key>Orchestrator のフォルダー キー ( --folder-pathではなく )。
--path <path>エージェントのプロジェクト ディレクトリへのパスです (既定 .)。
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

データシェイプ(--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 — メモリ構成を編集した後に再実行します。
  • uip agent refresh — メモリ空間が追加された後に派生ファイルを再生成します。

参照​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得