UIP-Agent-Init

Syntax und Optionen für „uip agent init“, das ein neues Low-Code-Agent-Projekt auf der Festplatte erstellt.

uip agent init erstellt ein Gerüst für ein neues Low-Code-Agent-Projekt auf der Festplatte. Wenn es in einem Lösungsverzeichnis ausgeführt wird, wird das Projekt automatisch im .uipx der umgebenden Lösung registriert. Wenn Sie außerhalb einer Lösung ausgeführt werden, wird automatisch ein übergeordnetes <name>Solution Gerüst erstellt und das Agent-Projekt darin verschachtelt – übergeben Sie --skip-solution-registration, um beide Verhaltensweisen zu deaktivieren und eine leere, nicht registrierte Projektstruktur zu erhalten.

Es sind zwei Gerüstsmodi verfügbar:

• Eigenständig (Standard) – eine vollständige Agent-Projektstruktur mit agent.json, entry-points.json, project.uiproj, flow-layout.json, einer evals/ -Struktur (mit Standardauswertungssatz, semantischem Evaluierer und Verlaufsauswerter) sowie leerem features/ und resources/ .
• Inline-in-Flow (--inline-in-flow) – Ein UUID-benanntes Unterverzeichnis innerhalb eines vorhandenen Flow-Projekts, das agent.json und ein leeres flow-layout.json mit leeren Ordnern evals/eval-sets/, features/ und resources/ enthält. Kein entry-points.json oder project.uiproj und keine automatische Lösungsregistrierung. Der Inline-Agent-Knoten des Flows muss auf die generierte projectId verweisen.

Zusammenfassung

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

Alle uip agent init -Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Argumente

• <path> (erforderlich) – Zielverzeichnis für das Agent-Projekt (relativ oder absolut). Der Verzeichnisname wird im eigenständigen Modus zum Agentennamen; sie muss mit [a-zA-Z0-9_ -]+ übereinstimmen. Wenn --inline-in-flow verwendet wird, ist <path> stattdessen das Flow-Projektverzeichnis und ein UUID-benanntes Unterverzeichnis wird darin erstellt.

Optionen

Markieren	Standard	Zweck
--conversational	aus	Erstellen Sie ein Gerüst für einen Konversationsagenten anstelle eines autonomen.
--model <model>	Kein statischer Standard – wählt ein empfohlenes Modell für den autonomen/Konversations-Agent-Typ aus	Zu verwendendes LLM-Modell. In settings.model in agent.json geschrieben.
--system-prompt <prompt>	–	Anfänglicher Systemprompt in messages[0] von agent.json geschrieben. Nur im eigenständigen Modus aussagekräftig.
--force	aus	Überschreiben Sie das Zielverzeichnis, auch wenn es nicht leer ist. Nur eigenständiger Modus – Inline-Modus schreibt immer in einen neuen UUID-Ordner.
--skip-solution-registration	aus	Registrieren Sie das Projekt nicht automatisch in einer umgebenden Lösung und erstellen Sie keine automatische übergeordnete Lösung <name>Solution.
--inline-in-flow	aus	Erstellen Sie ein Gerüst für einen Inline-Agent innerhalb eines Flow-Projekts. Das <path> -Argument muss auf ein vorhandenes Flow-Projektverzeichnis verweisen (sonst Fehler).

Der eigenständige Modus kann nicht fortgesetzt werden, wenn das Zielverzeichnis vorhanden ist und Dateien enthält, es sei denn, --force ist festgelegt.

Beispiele

# 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

Datenform (--output json)

Eigenständig (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 ist immer vorhanden – einer von Registered, AlreadyRegistered, NotInSolution (kein übergeordnetes .uipx wurde gefunden und es wurde kein neues automatisch erstellt) oder OptedOut (--skip-solution-registration wurde übergeben) . AutoCreatedSolution ist nur vorhanden, wenn für diese Ausführung ein Gerüst für ein übergeordnetes <Name>Solution erstellt wurde. ProjectArtifacts ist nur vorhanden, wenn SolutionRegistration.Status Registered oder AlreadyRegistered ist – es spiegelt die Artefakt-Ressourceneinträge wider, die uip solution projects add erzeugen würde, sodass uip solution pack das Projekt später nicht auslässt.

Inline (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..."
  }
}

Der Inline-Modus führt nie eine Lösungsregistrierung durch – SolutionRegistration / AutoCreatedSolution / ProjectArtifacts sind in dieser Form nie vorhanden.

ProjectId ist eine neue UUID, die in agent.json eingestempelt wird, und – im Inline-Modus – ist es auch der Ordnername. Im eigenständigen Modus werden zusätzliche UUIDs für den Einstiegspunkt, den semantischen Evaluierer, den Verlaufsauswerter und den Standardevaluierungssatz generiert.

Generierte Dateien

Eigenständig erstellt:

<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/

Inline-in-Flow erstellt innerhalb des Flow-Projekts Folgendes:

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

Zugehörig

• uip agent refresh – Wird nach jeder Bearbeitung ausgeführt, um entry-points.json und bindings_v2.json neu zu generieren.
• uip agent validate – strenge schreibgeschützte Prüfung vor dem Versand.
• uip solution projects add – Verknüpfen Sie den Agent mit einem Gerüst mit einer anderen Lösung als der, in der er automatisch registriert wurde.

Siehe auch

• Konzepte: Fähigkeiten – wie die Einstiegspunkte eines Agents als Fähigkeiten auftreten.
• Globale Optionen, Exitcodes.