configuration d’agent uip

uip agent config lit et met à jour les clés individuelles dans le agent.json d'un projet d'agent. C'est une commodité pour l'automatisation et les scripts: tout ce qu'il fait peut également être accompli en modifiant manuellement agent.json, mais les verbes comprennent la structure du fichier (paramètres, métadonnées, messages) et exposent un espace de noms à clé plate.

Synthèse

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

Toutes les sous-commandes uip agent config respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

exécution de la configuration d’agent uip

Lisez une clé unique (ou le résumé complet sélectionné) à partir de agent.json.

Arguments

• [key] (facultatif) : Clé de configuration. Les clés connues incluent model, name, systemPrompt et tout autre chemin imbriqué pris en charge par agent.json (exécutez uip agent config get sans clé pour obtenir un résumé sélectionné). Omettez d’imprimer ce résumé.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemples

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

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

Format des données (--sortie json)

Clé unique (Code: "AgentConfigGet"):

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

Résumé (aucune clé):

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

SystemPrompt et UserPrompt sont les champs content des entrées system et user dans le tableau messages[] de agent.json, tronqués à 120 caractères. Toute valeur manquante se renvoie sous la forme -.

ensemble de configuration d’agent uip

Mettez à jour une clé au format agent.json. La valeur est écrite textuelle — aucune coercition de type au-delà de la normalisation intégrée de la CLI.

Arguments

• <key> (requis) : Clé de configuration à écrire. Même espace de noms que get.
• <value> (obligatoire) : nouvelle valeur.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemples

# 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

Format des données (--sortie json)

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

La CLI ne valide pas agent.json après une set. Exécutez uip agent validate ensuite pour confirmer que le projet est toujours cohérent au niveau interne (contentTokens, input-points.json sync, etc.).

Associé

• uip agent validate — exécuter des vérifications statiques et la migration du schéma après un lot d'appels config set .
• uip agent init — élaboration d'un nouveau projet; plusieurs des valeurs que config get expose sont écrites au moment de l'initialisation.
• uip agent input / uip agent output — ces verbes écrivent les schémas E/S de l'agent, ce que config ne gère pas.

Voir également

• Options globales, codes de sortie.