pacote de agente uip

uip agent pack um projeto de agente local em um arquivo .uis . Um .uis é um arquivo ZIP simples da árvore do projeto; é o formato de transporte aceito pelo Studio Web (uip agent push) e a entrada para o fluxo de publicação do Orchestrator (uip agent publish).

Antes do empacotamento, o comando:

1. Valida a estrutura do projeto (agent.json, entry-points.json, project.uiproj, árvore de recursos).
2. Executa o passe de validação de esquema do Studio Web (a menos que --skip-schema-validation esteja definido). Quaisquer avisos não fatais são exibidos; qualquer problema fatal anula o pacote com um erro Schema validation failed .

O arquivo produzido exclui .agent-builder/ (estrutura de desenvolvimento local que o Studio Web regenera na importação).

Resumo

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

Todas as invocações uip agent pack honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Argumentos

• [path] (opcional, padrão .) — Caminho para o diretório do projeto do agente.

Opções

Bandeira	Padrão	Finalidade
-d, --destination <dir>	.	Diretório de destino para o arquivo .uis . Criado se não existir.
-n, --name <name>	agente metadata.name → nome base do diretório do projeto	Nome do pacote. O arquivo de saída é <name>.uis.
--skip-schema-validation	desativada	Ignorar o passe de validação de esquema do Studio Web. Útil para inspecionar projetos de trabalho em andamento que seriam rejeitados pela API ativa; não use em um pipeline de lançamento.

Exemplos

# 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

Formato dos dados (--output json)

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

Os avisos emitidos durante a validação do esquema são registrados separadamente (Warning entradas) e não aparecem no Data bem-sucedido. Erros de esquema fatais falham no comando antes que o arquivo seja gravado.

Relacionamento com a publicação

uip agent publish seu próprio pipeline de empacotar/migrar/reempacotar internamente; você não precisa executar pack primeiro se sua próxima etapa for publish. Use pack quando você quiser:

• Um .uis que você pode inspecionar manualmente (renomear para .zip e descompactar).
• Um .uis que você planeja enviar para o Studio Web por meio de uip agent push <file.uis>.
• Um arquivo local determinístico como um artefato em um trabalho de CI.

Relacionado

• uip agent validate — execute o pipeline de migração antes do empacotamento.
• uip agent publish — empacotar e enviar por push o pacote para o Orchestrator em uma etapa.
• uip agent push — importe um projeto compactado para o Studio Web.

Veja também

• Opções globais, Códigos de saída.