UIP-Agent-Init

uip agent init erstellt ein Gerüst für ein neues Low-Code-Agent-Projekt auf der Festplatte. Es werden nur die Agent-Projektdateien erstellt – es wird keine Lösung erstellt oder verknüpft. Verwenden Sie uip solution new gefolgt von uip solution project add , um den Gerüst-Agent innerhalb einer Lösung zu platzieren.

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. Der Inline-Agent-Knoten des Flows muss auf die generierte projectId verweisen.

Zusammenfassung

uip agent init <path> [--model <model>] [--system-prompt <prompt>] [--force] [--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
--model <model>	gpt-4o-2024-11-20	Das LLM-Modell, das der Agent verwenden wird. 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.
--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 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

Datenform (--output json)

Eigenständig (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…"
  }
}

Inline (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 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 validate – Führen Sie statische Prüfungen und die Schemamigration nach der Bearbeitung des Gerüsts agent.json aus.
• uip agent config – Aktualisieren Sie einzelne Schlüssel in agent.json , ohne die Datei manuell zu bearbeiten.
• uip agent input / uip agent output – Verwalten Sie das Eingabe- und Ausgabeschema des Agents nach dem Gerüst.
• uip agent push – Pushen Sie das Projekt mit Gerüst in Studio Web.

Siehe auch

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