UIP エージェント コンテキスト

uip agent context は、エージェント プロジェクトの コンテキスト リソース を管理します。これは、エージェントが実行時に参照するRAG (Retrieval-Augmented Generation) インデックス バインディングです。各コンテキストは、インデックスへの名前付き参照に加えて、取得モードとスコアリング パラメーターです。このコマンドは、ディスク上のエージェントプロジェクトに直接書き込みます(純粋にローカルで、ログインは必要ありません)。

概要

uip agent context add    <name> --index <indexName>
                                [--retrieval-mode <mode>] [--threshold <n>] [--result-count <n>]
                                [--path <dir>]
uip agent context list                                    [--path <dir>]
uip agent context remove <name>                           [--path <dir>]

uip agent contextすべてのサブコマンドは、グローバルオプション (--output、 --output-filter、 --log-level、 --log-file) を優先します。終了コードは 標準コントラクトに従います。

uip エージェント コンテキスト追加

RAG コンテキスト リソースをエージェントに追加します。

引数

• <name> (必須) — コンテキスト リソース名。後で削除するために使用されます (context remove <name>)。

オプション

フラグ	既定 (Default)	Required	目的
--index <indexName>	—	○	取得元のインデックス名です。
--retrieval-mode <mode>	semantic		取得モード。semantic、structured、deeprag、batchtransformのいずれか。
--threshold <n>	0		取得スコアのしきい値 (数値)。このカットオフを下回る値は破棄されます。
--result-count <n>	3		クエリごとに取得する結果の数 (整数)。
--path <path>	.		エージェント プロジェクト ディレクトリへのパスです。

--threshold または --result-count の無効な数値入力は検証エラーで失敗します。

例

# Semantic RAG with defaults (threshold 0, 3 results)
uip agent context add KnowledgeBase --index docs-index --path ./my-agent

# Tighter recall: higher threshold, more results
uip agent context add KnowledgeBase \
  --index docs-index \
  --retrieval-mode semantic \
  --threshold 0.7 \
  --result-count 5

# Structured retrieval over a different index
uip agent context add Tickets \
  --index ticket-index \
  --retrieval-mode structured

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

{
  "Code": "AgentContextAdd",
  "Data": {
    "Status": "Context added",
    "Name": "KnowledgeBase",
    "Index": "docs-index",
    "Mode": "semantic",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010"
  }
}

Id 、リソースにスタンプされた生成されたUUIDです。Name または Id を context removeで使用します。

uip エージェント コンテキスト リスト

エージェントに設定されているコンテキスト リソースを列挙します。

オプション

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

例

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

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

{
  "Code": "AgentContextList",
  "Data": [
    {
      "Name": "KnowledgeBase",
      "Index": "docs-index",
      "Mode": "semantic",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

空のプロジェクトは [ Data: { "Message": "No contexts configured" }を返します。

uip エージェント コンテキストの削除

コンテキスト リソースを削除します。

引数

• <name> (必須) — コンテキスト名 または ID。

オプション

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

例

uip agent context remove KnowledgeBase --path ./my-agent

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

{
  "Code": "AgentContextRemove",
  "Data": {
    "Status": "Context removed",
    "Name": "KnowledgeBase"
  }
}

コンテキストが見つからない場合、 Context "<name>" not found および終了コードの 1により失敗します。

関連

• uip agent tool — 他のリソースの種類(IS統合、プロセスなど)を追加します。
• uip agent escalation — HITL/エスカレーション リソース。
• uip agent validate — バッチ編集後に再実行して、リソースの整合性を確認します。

参照

• 概念: スキル — リソースがスキル モデルにどのように接続されるか。
• グローバル オプション、 終了コード。