configuração do agente de UIP

uip agent config lê e atualiza chaves individuais em um projeto de agente agent.json. É uma conveniência para automação e scripts: tudo o que ele faz também pode ser realizado editando manualmente agent.json, mas os verbos entendem a estrutura do arquivo (configurações, metadados, mensagens) e expõem um namespace de chave simples.

Resumo

uip agent config get [key] [--path <dir>]
uip agent config set <key> <value> [--path <dir>]

Todos os subcomandos uip agent config respeitam as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Obtenção de configuração do agente do uip

Leia uma única chave (ou o resumo completo selecionado) de agent.json.

Argumentos

• [key] opcional) — Chave de configuração. As chaves conhecidas incluem model, name, systemPrompt e qualquer outro caminho aninhado que agent.json suporta (execute uip agent config get sem uma chave para um resumo selecionado). Omita para imprimir esse resumo.

Opções

Bandeira	Padrão	Finalidade
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplos

# Read a single key
uip agent config get model --path ./my-agent

# Dump the curated summary for the current directory
uip agent config get

Formato dos dados (--output json)

Chave única (Code: "AgentConfigGet"):

{
  "Code": "AgentConfigGet",
  "Data": {
    "Key": "model",
    "Value": "gpt-4o-2024-11-20"
  }
}

Resumo (sem chave):

{
  "Code": "AgentConfigGet",
  "Data": {
    "Name": "my-agent",
    "Description": "-",
    "Model": "gpt-4o-2024-11-20",
    "Engine": "advanced",
    "MaxTokens": "-",
    "Temperature": "-",
    "SystemPrompt": "You are…",
    "UserPrompt": "-"
  }
}

SystemPrompt e UserPrompt são os campos content das entradas system e user na matriz messages[] de agent.json, truncados para 120 caracteres. Qualquer valor ausente é renderizado como -.

conjunto de configurações do agente uip

Atualizar uma chave em agent.json. O valor é escrito textual — sem coerção de tipo além da normalização integrada da CLI.

Argumentos

• <key> necessário) — Chave de configuração a ser gravada. Mesmo namespace que get.
• <value> necessário) — Novo valor.

Opções

Bandeira	Padrão	Finalidade
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplos

# Swap the model on a scaffolded agent
uip agent config set model gpt-4o-2024-11-20 --path ./my-agent

# Rename the agent (metadata.name)
uip agent config set name "Invoice Triage" --path ./my-agent

Formato dos dados (--output json)

{
  "Code": "AgentConfigSet",
  "Data": {
    "Key": "model",
    "Value": "gpt-4o-2024-11-20",
    "Status": "Updated"
  }
}

A CLI não revalida agent.json após um set. Execute uip agent validate depois para confirmar que o projeto ainda está internamente consistente (contentTokens, entry-points.json sincronizar, etc.).

Relacionado

• uip agent validate — execute verificações estáticas e migração de esquema após um lote de chamadas config set .
• uip agent init — estruturar um novo projeto; muitos dos valores que config get expõe são gravados no momento da inicialização.
• uip agent input / uip agent output — esses verbos escrevem os esquemas de I/O do agente, que config não gerencia.

Veja também

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