inicialización del agente de uip

aplica uip agent init a un nuevo proyecto de agente de código bajo en el disco. Solo crea los archivos de proyecto del agente; no crea ni vincula una solución. Usa uip solution new seguido de uip solution project add para colocar el agente andamiado dentro de una solución.

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. No entry-points.json o project.uiproj. El nodo agente en línea del flujo debe hacer referencia al projectId generado.

Sinopsis

uip agent init <path> [--model <model>] [--system-prompt <prompt>] [--force] [--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
--model <model>	gpt-4o-2024-11-20	Modelo LLM que utilizará el agente. 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.
--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 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

Forma de datos (--json de salida)

Independiente (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 línea (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 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 validate : ejecuta comprobaciones estáticas y migración de esquemas después de editar el agent.json andamiado.
• uip agent config : actualiza las claves individuales en agent.json sin editar manualmente el archivo.
• uip agent input / uip agent output : gestiona el esquema de entrada y salida del agente después del scaffolding.
• uip agent push : envía el proyecto andamiado a Studio Web.

Ver también

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