Init. d’agent UIP

Syntaxe et options de `uip agent init`, qui va créer un nouveau projet d'agent low-code sur le disque.

uip agent init élabore un nouveau projet d'agent low-code sur le disque. Lorsqu'il est exécuté dans un répertoire de solution, le projet est automatiquement enregistré dans le fichier .uipx de la solution voisine. Lorsqu'il est exécuté en dehors de toute solution, un parent <name>Solution est automatiquement élaboré et le projet d'agent est imbriqué à l'intérieur; transmettez --skip-solution-registration pour refuser les deux comportements et obtenir une arborescence de projet barrée et non enregistrée.

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 de entry-points.json ou project.uiproj et pas d’enregistrement automatique de solution. Le nœud d'agent en ligne du flux doit référencer le projectId généré.

Synthèse

uip agent init <path> [--conversational] [--model <model>] [--system-prompt <prompt>] [--force] [--skip-solution-registration] [--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
--conversational	désactivé	Élaborez un agent conversationnel au lieu d’un agent autonome.
--model <model>	aucun statique par défaut — choisit un modèle recommandé pour le type d’agent autonome/conversationnel	Modèle LLM à utiliser. É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.
--skip-solution-registration	désactivé	N’enregistrez pas automatiquement le projet dans une solution voisine et ne créez pas automatiquement un parent <name>Solution.
--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 an autonomous agent with the recommended default model
uip agent init ./my-agent --model gpt-5.4

# Scaffold a conversational agent
uip agent init ./my-agent --conversational --model anthropic.claude-sonnet-4-5-20250929-v1:0

# Scaffold outside any solution — a parent MyAgentSolution is auto-created
uip agent init ./my-agent

# Skip solution auto-registration entirely
uip agent init ./my-agent --skip-solution-registration

# 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": "/abs/path/MyAgentSolution/my-agent",
    "Name": "my-agent",
    "Model": "gpt-5.4",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000301",
    "NextSteps": "# Edit agent.json to configure prompts and resources\n...",
    "SolutionRegistration": {
      "Status": "Registered"
    },
    "AutoCreatedSolution": {
      "...": "present only when a parent solution was scaffolded automatically"
    },
    "ProjectArtifacts": {
      "...": "present only when the project was registered into a parent solution"
    }
  }
}

SolutionRegistration.Status est toujours présent — l'un des Registered, AlreadyRegistered, NotInSolution (aucun parent .uipx trouvé et un nouveau n'a pas été créé automatiquement), ou OptedOut (--skip-solution-registration a été transmis) . AutoCreatedSolution est présent uniquement lorsqu'un parent <Name>Solution a été élaboré pour cette exécution. ProjectArtifacts est présent uniquement lorsque SolutionRegistration.Status est Registered ou AlreadyRegistered — il reflète les entrées d'artefact-ressource que uip solution projects add produit, de sorte que uip solution pack n'omet pas le projet ultérieurement.

En ligne (Code: "AgentInitInline"):

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

Le mode en ligne n'effectue jamais l'enregistrement de la solution - SolutionRegistration / AutoCreatedSolution / ProjectArtifacts ne sont jamais présents sur cette forme.

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 refresh — exécuté après chaque modification pour régénérer entry-points.json et bindings_v2.json.
• uip agent validate — contrôle strict en lecture seule avant l'expédition.
• uip solution projects add — liez l'agent élaboré dans une solution différente de celle dans laquelle il a été enregistré automatiquement.

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.