gtc wizard

Resumen

El comando gtc wizard crea nuevos bundles de Greentic a partir de las respuestas del asistente. Genera la estructura completa del bundle, incluyendo archivos de configuración, configuraciones de providers y plantillas de apps.

Uso

gtc wizard [OPTIONS]

Opciones

Opción	Descripción
`--answers <FILE \| URL>`	Ruta o URL del archivo de respuestas del asistente (JSON o YAML). Admite rutas locales y URLs remotas `http://` / `https://`.
`--dry-run`	Previsualiza los archivos generados sin escribirlos
`--output <DIR>`	Directorio de salida (por defecto: directorio actual)
`--template <NAME>`	Usa una plantilla específica
`-v, --verbose`	Habilita salida detallada

Archivo de respuestas del asistente

Formato JSON

{
  "project": {
    "name": "my-digital-worker",
    "version": "1.0.0",
    "description": "Customer support digital worker"
  },
  "providers": {
    "messaging": ["telegram", "slack"],
    "events": ["webhook", "timer"]
  },
  "apps": [
    {
      "name": "support-bot",
      "template": "customer-service"
    }
  ],
  "tenants": [
    {
      "id": "demo",
      "name": "Demo Tenant",
      "teams": [
        {
          "id": "default",
          "channels": ["telegram", "slack"]
        }
      ]
    }
  ]
}

Formato YAML

project:
  name: my-digital-worker
  version: "1.0.0"
  description: Customer support digital worker

providers:
  messaging:
    - telegram
    - slack
  events:
    - webhook
    - timer

apps:
  - name: support-bot
    template: customer-service

tenants:
  - id: demo
    name: Demo Tenant
    teams:
      - id: default
        channels:
          - telegram
          - slack

Estructura generada

Ejecutar el asistente genera:

my-digital-worker/
├── greentic.demo.yaml          # Main configuration
├── providers/
│   ├── messaging/
│   │   ├── messaging-telegram.gtpack
│   │   └── messaging-slack.gtpack
│   └── events/
│       ├── events-webhook.gtpack
│       └── events-timer.gtpack
├── apps/
│   └── support-bot/
│       ├── app.yaml
│       └── flows/
│           └── on_message.ygtc
├── tenants/
│   └── demo/
│       ├── tenant.gmap
│       └── teams/
│           └── default/
│               └── team.gmap
└── seeds.yaml

Ejemplos

Uso básico

# Interactive mode
gtc wizard

# With answers file
gtc wizard --answers wizard-answers.yaml

Modo de previsualización

# See what would be generated
gtc wizard --answers wizard-answers.yaml --dry-run

Archivo de respuestas remoto

La opción --answers acepta URLs http:// y https://, lo que facilita almacenar documentos de respuestas compartidos en una ubicación central y referenciarlos desde pipelines de CI/CD.

# Fetch answers from a remote URL
gtc wizard --answers https://config.example.com/teams/support/wizard-answers.yaml

# Combine with dry-run to preview before generating
gtc wizard --answers https://config.example.com/teams/support/wizard-answers.yaml --dry-run

Directorio de salida personalizado

gtc wizard --answers wizard-answers.yaml --output ./my-project

Usar plantillas

# List available templates
gtc wizard --list-templates

# Use specific template
gtc wizard --template customer-service --answers answers.yaml

Plantillas disponibles

Plantilla	Descripción
`minimal`	Bundle mínimo con un provider
`customer-service`	Bot de FAQ con escalación
`helpdesk`	Soporte IT con integración de tickets
`multi-channel`	Múltiples canales de mensajería

Flujo de trabajo

Crear el archivo de respuestas

Define la configuración de tu proyecto en JSON o YAML.

Ejecutar el asistente

gtc wizard --answers wizard-answers.yaml

Revisar los archivos generados

Comprueba la estructura del bundle generado.
Configurar providers
Ventana de terminal
```
gtc setup ./my-digital-worker
```
Iniciar el runtime
Ventana de terminal
```
gtc start ./my-digital-worker
```

Personalizar los flows generados

El asistente genera plantillas básicas de flow. Personalízalas después de la generación:

name: on_message
version: "1.0"
description: Handle incoming messages

nodes:
  # Add your custom nodes here
  - id: analyze
    type: llm
    config:
      model: "gpt-4"
      prompt: "Analyze: {{message}}"
    next: respond

  - id: respond
    type: reply
    config:
      message: "{{analysis_result}}"

triggers:
  - type: message
    target: analyze

Solución de problemas

Archivo de respuestas no válido

Error: Failed to parse answers file

Asegúrate de que tu JSON/YAML sea válido. Usa un linter para comprobar la sintaxis.

Faltan campos requeridos

Error: Missing required field: project.name

Comprueba que todos los campos requeridos estén presentes en tu archivo de respuestas.

Plantilla no encontrada

Error: Template 'unknown' not found

Usa gtc wizard --list-templates para ver las plantillas disponibles.

Siguientes pasos

gtc setup - Configurar providers
gtc start - Ejecutar el runtime
Inicio rápido - Flujo de trabajo completo