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] （可选，默认为. ） — 智能体项目目录的路径。

选项

标记	默认	用途
-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

数据形状（--输出 json）

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

架构验证期间发出的警告将单独记录（ Warning条目），并且不会显示在成功信息Data中。在写入存档之前，严重架构错误会使命令失败。

要发布的关系

uip agent publish在内部运行自己的 pack/migrate/repack 管道；如果下一步是publish ，则无需先运行pack 。当您希望执行以下操作时，请使用pack ：

• 您可以手动检查的.uis （重命名为.zip后解压缩）。
• 您计划通过.uis推送到 Studio Web 的uip agent push <file.uis> 。
• 在 CI 作业中作为工件的确定性本地存档。

相关内容

• uip agent validate — 打包前运行迁移管道。
• uip agent publish — 打包并一步步将包推送到 Orchestrator。
• uip agent push — 将打包项目导入 Studio Web。

另请参阅

• 全局选项，退出代码。