UIP エージェント メモリ

「uip agent memory」を使用して、ローコード エージェント上のメモリ空間とメモリ項目をアタッチ、一覧表示、削除します。

uip agent memory は、エージェントにアタッチされたメモリ空間機能を管理します。メモリ空間は、エージェントが実行時に検索できる、検索拡張された再現ソース (エピソード メモリまたはエスカレーション メモリ) です。uip agent memory item は、構成されたメモリ空間にシードされた個々のキー/値項目を管理します。

ローカル専用 — ログインは不要です。

概要

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> <key> <value> --memory-type <episodic|escalation> [--folder-path <path>] [--description <desc>] [--metadata <json>] [--path <dir>]
uip agent memory item list   <name> [--folder-path <path>]                                                                                                                                                                                        [--path <dir>]
uip agent memory item remove <name> <key> [--folder-path <path>]                                                                                                                                                                                  [--path <dir>]

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

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

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

引数

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

オプション

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

例

uip agent memory add SupportRecall --memory-space customer-support-recall --folder-path Shared --path ./my-agent

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

{
  "Code": "AgentMemoryAdd",
  "Data": {
    "Status": "Memory space added",
    "Name": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "FolderPath": "Shared",
    "DynamicFewShotEnabled": true,
    "Id": "a1b2c3d4-0000-0000-0000-000000000070"
  }
}

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

オプション

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

例

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

UIP エージェントのメモリの削除

引数

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

オプション

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

例

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

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

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

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

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

構成済みのメモリ空間にメモリ項目を追加します。

引数

名前	Required	目的
<name>	○	フィーチャー名、メモリ空間名、または ID。
<key>	○	メモリー項目のキー。
<value>	○	メモリー項目の値。

オプション

フラグ	Required	目的
--folder-path <path>		フォルダー パス (メモリ空間名で選択する場合)。
--memory-type <type>	○	episodic (0) または escalation (1) — 0/1 の数値も使用できます。
--description <desc>		メモリーアイテムの説明。
--metadata <json>		JSON オブジェクトとしてのメモリ項目のメタデータ。
--path <path>		エージェントのプロジェクト ディレクトリへのパスです (既定 .)。

例

uip agent memory item add SupportRecall customer-tier gold --memory-type episodic --metadata '{"source":"seed"}' --path ./my-agent

uip agent memory item add SupportRecall escalation-case pending --memory-type escalation --path ./my-agent

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

{
  "Code": "AgentMemoryItemAdd",
  "Data": { "Status": "Memory item added", "Memory": "SupportRecall", "Key": "customer-tier", "MemoryType": 0, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
}

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

引数

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

オプション

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

例

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

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

{
  "Code": "AgentMemoryItemList",
  "Data": [
    { "Key": "customer-tier", "Value": "gold", "MemoryType": 0, "Description": null, "Metadata": { "source": "seed" }, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
  ]
}

UIP エージェント メモリ アイテムの削除

引数

名前	Required	目的
<name>	○	フィーチャー名、メモリ空間名、または ID。
<key>	○	削除するメモリ アイテムのキーまたは ID。

オプション

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

例

uip agent memory item remove SupportRecall customer-tier --path ./my-agent

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

{ "Code": "AgentMemoryItemRemove", "Data": { "Status": "Memory item removed", "Memory": "SupportRecall", "Key": "customer-tier" } }

関連

• uip agent validate — メモリ構成を編集した後に再実行します。
• uip agent refresh — メモリ空間が追加された後に派生ファイルを再生成します。

参照

• グローバル オプション、 終了コード。