UIP エージェント パッケージ

uip agent pack ローカル エージェント プロジェクトを .uis ファイルにバンドルします。.uisは、プロジェクトツリーのプレーンなZIPアーカイブです。これは Studio Web (uip agent push) で受け入れられる転送形式であり、Orchestrator のパブリッシュ フロー (uip agent publish) への入力です。

梱包する前に、次のコマンドを実行します。

1. プロジェクト構造を検証します (agent.json、 entry-points.json、 project.uiproj、リソース ツリー)。
2. Studio Web のスキーマ検証パスを実行します ( --skip-schema-validation が設定されていない場合)。致命的ではない警告が表示されます。致命的な問題が発生すると、 Schema validation failed エラーが発生してパックが中止されます。

生成されたアーカイブには、 .agent-builder/ (Studio Web がインポート時に再生成するローカル開発のスキャフォールディング) は含まれません。

概要

uip agent pack [path] [-d <dir>] [-n <name>] [--skip-schema-validation]

すべての uip agent pack 呼び出しでは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) が優先されます。終了コードは 標準コントラクトに従います。

引数

• [path] (任意、デフォルト .) — エージェントのプロジェクトディレクトリへのパスです。

オプション

フラグ	既定 (Default)	目的
-d, --destination <dir>	.	.uis ファイルの保存先ディレクトリです。存在しない場合は作成されます。
-n, --name <name>	エージェント metadata.name → プロジェクト ディレクトリのベース名	パッケージ名。出力ファイルは <name>.uisです。
--skip-schema-validation	無効	Studio Web のスキーマの検証パスをスキップします。ライブ API によって拒否される進行中のプロジェクトの検査に役立ちます。リリース パイプラインでは使用しないでください。

例

# Pack the current directory into ./my-agent.uis
uip agent pack

# Pack a specific project into ./dist/my-agent.uis
uip agent pack ./my-agent -d ./dist

# Override the archive name
uip agent pack ./my-agent -d ./dist --name invoice-agent-v1

# Skip schema validation to pack a work-in-progress project
uip agent pack ./my-agent --skip-schema-validation

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

{
  "Code": "AgentPack",
  "Data": {
    "Status": "Agent packed successfully",
    "Name": "my-agent",
    "Output": "/abs/path/dist/my-agent.uis"
  }
}

スキーマの検証中に発生した警告は個別に (エントリWarning ) 記録され、成功 Dataには表示されません。致命的なスキーマエラーは、アーカイブが書き込まれる前にコマンドを失敗します。

パブリッシュする関係

uip agent publish は、独自のパック/移行/再パック パイプラインを内部で実行します。次のステップが publishであれば、最初にpackを実行する必要はありません。必要に応じて pack を使用します。

• 手作業で検査 (名前を .zip に変更して解凍) できる.uisです。
• uip agent push <file.uis>経由で Studio Web にプッシュする予定の.uisです。
• CI ジョブの成果物としての決定論的なローカル アーカイブ。

関連

• uip agent validate — 梱包する前に移行パイプラインを実行します。
• uip agent publish — パッケージを 1 つの手順でパッケージ化して Orchestrator にプッシュします。
• uip agent push — パッケージ化されたプロジェクトを Studio Web にインポートします。

参照

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