- 概要
- はじめに
- 概念
- UiPath CLI を使用する
- 使用ガイド
- CI/CD レシピ
- コマンド リファレンス
- 概要
- 終了コード
- グローバル オプション
- uip codedagent
- UIP コーダー
- UIP のコンテキスト グラウンディング
- uip docsai
- uip 関数
- UIP ガードレール
- uip llm - 構成
- uip llm-gateway
- UIP Maestro のオーサリング
- UIP Maestro レジストリ
- uip model-hub
- アクティビティ検索
- アクティビティ get-default-xaml
- 分析
- アナライザー - ルールのリスト
- 開発
- クリーンアップ
- data-fabric-entities をインストールする
- data-fabric-entities リスト
- ファイル差分
- get-library-object-repository
- オブジェクト リポジトリを取得
- Init
- インスタンス リスト
- パッケージ化
- パッケージ検査
- パッケージのインストール
- パッケージ バージョン
- パブリッシュ
- リモート
- 元に戻す
- 実行、デバッグ、実行
- 設定
- Studio での起動
- テンプレートの検索
- test-data add-entity
- test-data add-queue
- test-data add-variation
- TM
- UIA
- 検証
- workflow-examples get
- ワークフロー - 例のリスト
- UIP タスク
- uip traces
- UIP トレースのフィードバック
- 移行
- 参照とサポート
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> | hybrid | hybrid または 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_folder | Orchestrator フォルダー: 実行時にメモリ空間が存在するフォルダーです。既定値は、エージェント機能のフォルダーです。 |
--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— メモリ空間が追加された後に派生ファイルを再生成します。