Init. d’agent UIP

uip agent init élabore un nouveau projet d'agent low-code sur le disque. Elle crée uniquement les fichiers de projet d'agent — elle ne crée pas ni ne lie de solution. Utilisez uip solution new suivi de uip solution project add pour placer l'agent élaboration dans une solution.

Deux modes d’élaboration sont disponibles:

• Autonome (par défaut): une arborescence de projet d'agent complète avec agent.json, entry-points.json, project.uiproj, flow-layout.json, une arborescence evals/ (avec un ensemble d'évaluation par défaut, un évaluateur sémantique et un évaluateur de trajectoire), plus vide features/ et resources/ .
• Inline-in-flow (--inline-in-flow) — un sous-répertoire nommé UUID à l'intérieur d'un projet de flux existant contenant agent.json et un flow-layout.json vide, avec des dossiers evals/eval-sets/, features/ et resources/ vides. Pas entry-points.json ou project.uiproj. Le nœud d'agent en ligne du flux doit référencer le fichier projectId généré.

Synthèse

uip agent init <path> [--model <model>] [--system-prompt <prompt>] [--force] [--inline-in-flow]

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

Arguments

• <path> (obligatoire) : le répertoire cible du projet d’agent ( relatif ou absolu). Le nom du répertoire devient le nom de l’agent en mode autonome; il doit correspondre [a-zA-Z0-9_ -]+. Lorsque --inline-in-flow est utilisé, <path> est à la place le répertoire du projet de flux, et un sous-répertoire nommé par UUID est créé à l'intérieur.

Options

Drapeau	Default	Objectif
--model <model>	gpt-4o-2024-11-20	Le modèle LLM utilisé par l’agent. Écrit dans settings.model dans agent.json.
--system-prompt <prompt>	—	Invite système initiale écrite dans messages[0] sur agent.json. Uniquement significatif en mode autonome.
--force	désactivé	Écrasez le répertoire cible même s’il n’est pas vide. Mode autonome uniquement - le mode en ligne écrit toujours dans un nouveau dossier UUID.
--inline-in-flow	désactivé	Élaborer un agent intégré dans un projet de flux. L'argument <path> doit pointer vers un répertoire de projet de flux existant (erreur dans le cas contraire).

Le mode autonome refuse de continuer si le répertoire cible existe et contient des fichiers, sauf si --force est défini.

Exemples

# Simplest: scaffold with defaults into ./my-agent
uip agent init ./my-agent

# Override the model and seed a system prompt
uip agent init ./invoice-agent \
  --model gpt-4o-2024-11-20 \
  --system-prompt "You are an invoice triage agent."

# Overwrite an existing non-empty directory
uip agent init ./my-agent --force

# Scaffold an inline agent inside an existing flow project
uip agent init ./my-flow --inline-in-flow

Format des données (--sortie json)

Autonome (Code: "AgentInit"):

{
  "Code": "AgentInit",
  "Data": {
    "Status": "Agent project created",
    "Path": "./my-agent",
    "Name": "my-agent",
    "Model": "gpt-4o-2024-11-20",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000301",
    "NextSteps": "# Edit agent.json to configure prompts and resources\n…"
  }
}

En ligne (Code: "AgentInitInline"):

{
  "Code": "AgentInitInline",
  "Data": {
    "Status": "Inline agent created inside flow project",
    "Path": "/abs/path/my-flow/<uuid>",
    "ProjectId": "<uuid>",
    "Model": "gpt-4o-2024-11-20",
    "NextSteps": "# Edit agent.json to configure prompts and settings\n…"
  }
}

ProjectId est un nouvel UUID estampé dans agent.json et - en mode en ligne - est également le nom du dossier. En mode autonome, des UUID supplémentaires sont générés pour le point d’entrée, l’évaluateur sémantique, l’évaluateur de trajectoire et l’ensemble d’évaluation par défaut.

Fichiers générés

Créations autonomes :

<path>/
  agent.json
  project.uiproj
  entry-points.json
  flow-layout.json
  evals/
    evaluators/
      <semantic-evaluator>.json
      <trajectory-evaluator>.json
    eval-sets/
      evaluation-set-default.json
  features/
  resources/

L'intégration dans le flux crée, à l'intérieur du projet de flux:

<flow-path>/<new-uuid>/
  agent.json
  flow-layout.json           # empty ({})
  evals/eval-sets/
  features/
  resources/

Associé

• uip agent validate — exécuter des vérifications statiques et la migration du schéma après avoir modifié l'élaboration agent.json.
• uip agent config — mettez à jour les clés individuelles dans agent.json sans modifier le fichier manuellement.
• uip agent input / uip agent output — gérez le schéma d'entrée et de sortie de l'agent après l'élaboration.
• uip agent push — transmettez le projet structuré vers Studio Web.

Voir également

• Concepts: compétences - comment les points d'entrée d'un agent apparaissent sous forme de compétences.
• Options globales, codes de sortie.