pacote de agente uip

Sintaxe e opções do "pacote de agente uip", que agrupa um projeto de agente local em um arquivo ".uis" para publicação.

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.