publicação do agente uip

uip agent publish um projeto de agente e envia o pacote resultante para o Orchestrator como uma nova versão do pacote da solução. O PackageVersionKey retornado é a entrada para uip agent deploy.

Internamente, publish executa um pipeline de vários estágios:

1. Se a entrada for um diretório, ela valida a estrutura do projeto e a empacota em um .uis temporário.
2. Ele extrai o .uis, migra qualquer agent.json / resource.json para baixo para o storageVersion esperado (atualmente 44.0.0) e reempacota.
3. Ele empacota para uip solution pack para produzir uma solução .zip (contendo um ou mais arquivos .nupkg ).
4. Ele carrega a solução — seja por meio da API de Soluções padrão (padrão) ou diretamente no feed de pacote do Orchestrator quando --direct estiver definido.

Requer uma sessão de CLI ativa (uip login).

Resumo

uip agent publish [path] [-t <tenant>] [-l <locationKey>] [-n <name>]
                  [--package-version <version>]
                  [--folder-id <id>] [--direct]
                  [--login-validity <minutes>]

Todas as invocações uip agent publish 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 de projeto do agente ou um arquivo .uis já empacotado. Uma entrada .uis pula a etapa de empacotamento; tudo subsequente (migrar, reempacotar, empacotar soluções, carregar) ainda é executado.

Opções

Bandeira	Padrão	Finalidade
-t, --tenant <tenant>	Tenant de logon	Tenant de destino. Obrigatório se a sessão de logon não tiver um tenant padrão.
-l, --location-key <guid>	—	GUID opcional encaminhado para a chamada packagesUpload da API de Soluções (usado apenas pelo caminho de upload padrão).
-n, --name <name>	agente metadata.name → nome base do caminho	Nome do pacote. Torna-se o nome do arquivo .uis / .zip e o nome do pacote no Orchestrator.
--package-version <version>	1.0.0	String da versão do pacote carregado.
--folder-id <id>	ID da unidade organizacional da pasta de login	ID da unidade do org da pasta do Orchestrator. Consultado apenas quando --direct está definido; o caminho de upload padrão de Soluções o ignora.
--direct	desativada	Carregue cada .nupkg diretamente no feed de pacote do Orchestrator e crie um Release por pacote, ignorando a API de soluções. Use isso quando o caminho de implantação de Soluções falhar ou você quiser lançamentos criados imediatamente em uma pasta específica.
--login-validity <minutes>	10	Mínimo de minutos de validade do token necessários. Consulte Autenticação.

Exemplos

# Publish the current project to the login tenant
uip agent publish --package-version 1.0.0

# Publish a specific project folder
uip agent publish ./my-agent --package-version 1.0.0

# Publish a pre-packed .uis
uip agent publish ./dist/my-agent.uis --package-version 1.0.0

# Direct upload into a specific folder (creates releases in that folder)
uip agent publish ./my-agent \
  --package-version 1.1.0 \
  --direct --folder-id 42

# Override tenant and name
uip agent publish ./my-agent \
  -t production \
  -n invoice-agent \
  --package-version 2.0.0

Formato dos dados (--output json)

Caminho de upload padrão (Code: "AgentPublish"):

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published successfully",
    "Name": "my-agent",
    "Version": "1.0.0",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000050"
  }
}

O PackageVersionKey é o que você passa para uip agent deploy.

--direct Path

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published to Orchestrator (direct)",
    "Name": "my-agent",
    "Version": "1.0.0",
    "Releases": [
      {
        "Name": "InvoiceAgent",
        "Key": "a1b2c3d4-0000-0000-0000-000000000055",
        "ProcessKey": "com.uipath.agent.InvoiceAgent"
      }
    ]
  }
}

No modo --direct , cada .nupkg dentro da solução .zip é carregado separadamente, e uma versão é criada por pacote. Não há PackageVersionKey; o conceito correspondente é o por versão Key — utilizável diretamente com uip agent run start.

Comportamento da migração

publish espera um storageVersion não maior que 44.0.0, enquanto novos projetos do Studio Web podem ser 47.0.0. Ele regrava silenciosamente agent.json e arquivos de ferramenta resource.json dentro do diretório de extração temporário para o esquema esperado antes do reempacotamento. Seu projeto no disco nunca é modificado.

Cada arquivo migrado produz uma entrada de log Message (por exemplo, Migrated /tmp/…/agent.json: storageVersion 47.0.0 → 44.0.0).

Relacionado

• uip agent pack — a etapa de empacotamento local (incluída internamente).
• uip agent deploy — instale e ative a versão do pacote carregado.
• uip agent validate — execute verificações estáticas e migração em seu projeto no disco antes de publicar.

Veja também

• Autenticação — sessões, tenants e --login-validity.
• Orchestrator: trabalhos — onde os processos de agentes lançados são executados.
• Opções globais, Códigos de saída.