UIP エージェントの設定

uip agent config は、エージェント プロジェクトの agent.json内の個々のキーを読み取って更新します。これは自動化とスクリプトにとって便利です:それが行うことはすべて、 agent.jsonを手動で編集することでも実現できますが、動詞はファイルの構造(設定、メタデータ、メッセージ)を理解し、フラットなキー名前空間を公開します。

概要

uip agent config get [key] [--path <dir>]
uip agent config set <key> <value> [--path <dir>]

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

uip agent config get

agent.jsonから 1 つのキー (またはキュレーションされた完全な概要) を読み取る

引数

• [key] (任意) — 設定キー。既知のキーには、 model、 name、 systemPrompt、および agent.json がサポートするその他の入れ子になったパス (選定された概要のキーなしで uip agent config get 実行) があります。その要約を印刷するのを省略します。

オプション

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

例

# Read a single key
uip agent config get model --path ./my-agent

# Dump the curated summary for the current directory
uip agent config get

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

シングルキー (Code: "AgentConfigGet"):

{
  "Code": "AgentConfigGet",
  "Data": {
    "Key": "model",
    "Value": "gpt-4o-2024-11-20"
  }
}

概要 (キーなし):

{
  "Code": "AgentConfigGet",
  "Data": {
    "Name": "my-agent",
    "Description": "-",
    "Model": "gpt-4o-2024-11-20",
    "Engine": "advanced",
    "MaxTokens": "-",
    "Temperature": "-",
    "SystemPrompt": "You are…",
    "UserPrompt": "-"
  }
}

SystemPrompt と UserPrompt は、system の content フィールドであり、agent.jsonの messages[] 配列の user エントリを 120 文字に切り捨てたものです。欠落している値は -としてレンダリングされます。

uip エージェント構成セット

agent.jsonでキーを更新します。値は逐語的に記述され、CLI の組み込みの正規化を超える型の強制はありません。

引数

• <key> (必須) — 書き込む構成キー。getと同じ名前空間。
• <value> (必須) — 新しい値。

オプション

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

例

# Swap the model on a scaffolded agent
uip agent config set model gpt-4o-2024-11-20 --path ./my-agent

# Rename the agent (metadata.name)
uip agent config set name "Invoice Triage" --path ./my-agent

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

{
  "Code": "AgentConfigSet",
  "Data": {
    "Key": "model",
    "Value": "gpt-4o-2024-11-20",
    "Status": "Updated"
  }
}

CLI は、set後にagent.jsonを再検証しません。その後 uip agent validate 実行して、プロジェクトが内部的に一貫性を保っていることを確認します (contentTokens、entry-points.json同期など)。

関連

• uip agent validate — config set呼び出しのバッチの後に、静的チェックとスキーマの移行を実行します。
• uip agent init — 新しいプロジェクトの足場を組む。config get公開する値の多くは、初期化時に書き込まれます。
• uip agent input / uip agent output — これらの動詞はエージェントの I/O スキーマを記述しますが、configはこれを管理しません。

参照

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