inicialización del agente de uip

Sintaxis y opciones para `uip agent init`, que andamia un nuevo proyecto de agente de código bajo en el disco.

uip agent init aplica andamios a un nuevo proyecto de agente de código bajo en el disco. Cuando se ejecuta dentro de un directorio de soluciones, el proyecto se registra automáticamente en el .uipx de la solución circundante. Cuando se ejecuta fuera de cualquier solución, un <name>Solution principal se andamia automáticamente y el proyecto de agente se anida en su interior. Pasa --skip-solution-registration para excluir ambos comportamientos y obtener un árbol de proyecto vacío y no registrado.

Hay dos modos de andamio disponibles:

• Independiente (predeterminado): un árbol de proyecto de agente completo con agent.json, entry-points.json, project.uiproj, flow-layout.json, un árbol evals/ (con un conjunto de evaluación predeterminado, un evaluador semántico y un evaluador de trayectoria), más features/ vacío y resources/ .
• En línea (--inline-in-flow): un subdirectorio con nombre UUID dentro de un proyecto de flujo existente que contiene agent.json y un flow-layout.json vacío, con las carpetas evals/eval-sets/, features/ y resources/ vacías. Sin entry-points.json o project.uiproj, y sin registro automático de soluciones. El nodo de agente en línea del flujo debe hacer referencia al projectId generado.

Sinopsis

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

Todas las invocaciones uip agent init respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Argumentos

• <path> obligatorio) : directorio de destino para el proyecto de agente (relativo o absoluto). El nombre del directorio se convierte en el nombre del agente en modo independiente; debe coincidir con [a-zA-Z0-9_ -]+. Cuando se utiliza --inline-in-flow , <path> es en su lugar el directorio del proyecto de flujo, y se crea un subdirectorio con nombre UUID en su interior.

Opciones

Marca	Predeterminado	Propósito
--conversational	Desactivado	Andamio un agente conversacional en lugar de uno autónomo.
--model <model>	sin valor predeterminado estático: elige un modelo recomendado para el tipo de agente autónomo/conversacional	Modelo LLM a utilizar. Escrito en settings.model en agent.json.
--system-prompt <prompt>	—	Solicitud inicial del sistema escrita en messages[0] de agent.json. Solo es significativo en modo independiente.
--force	Desactivado	Sobrescribe el directorio de destino incluso si no está vacío. Solo modo independiente: el modo en línea siempre escribe en una carpeta UUID nueva.
--skip-solution-registration	Desactivado	No registres automáticamente el proyecto en una solución circundante y no crees automáticamente un <name>Solution principal.
--inline-in-flow	Desactivado	Andamio de un agente en línea dentro de un proyecto de flujo. El argumento <path> debe apuntar a un directorio de proyecto de flujo existente (de lo contrario, error).

El modo independiente se niega a continuar si el directorio de destino existe y contiene algún archivo, a menos que se establezca --force .

Ejemplos

# 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

Forma de datos (--json de salida)

Independiente (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 siempre está presente: uno de Registered, AlreadyRegistered, NotInSolution (no se encontró ningún .uipx principal y no se creó uno nuevo automáticamente), o OptedOut (se pasó --skip-solution-registration) . AutoCreatedSolution está presente solo cuando se aplicó andamio a un <Name>Solution principal para esta ejecución. ProjectArtifacts está presente solo cuando SolutionRegistration.Status es Registered o AlreadyRegistered: refleja las entradas de recursos de artefactos que uip solution projects add produciría, por lo que uip solution pack no omite el proyecto más tarde.

En línea (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..."
  }
}

El modo en línea nunca registra la solución: SolutionRegistration / AutoCreatedSolution / ProjectArtifacts nunca están presentes en esta forma.

ProjectId es un UUID nuevo marcado en agent.json y, en modo en línea, es también el nombre de la carpeta. En el modo independiente, se generan UUID adicionales para el punto de entrada, el evaluador semántico, el evaluador de trayectoria y el conjunto de evaluación predeterminado.

Archivos generados

Crea de forma independiente :

<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 crea, dentro del proyecto de flujo:

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

Relacionado

• uip agent refresh : se ejecuta después de cada edición para regenerar entry-points.json y bindings_v2.json.
• uip agent validate : comprobación estricta de solo lectura antes del envío.
• uip solution projects add : vincula el agente andamiado a una solución diferente a la que se registró automáticamente.

Ver también

• Conceptos: habilidades : cómo los puntos de entrada de un agente emergen como habilidades.
• Opciones globales, códigos de salida.