El asistente de new

Responde unas preguntas y bxAgents new construye el agente: tools, servidores MCP, canales, acceso y destino de despliegue.

El asistente de new

Ejecuta bxAgents new en una terminal sin --model y te pregunta qué debe hacer el agente; después escribe el proyecto a la medida. Nada de esto es magia: cada respuesta termina en un archivo que puedes leer, y la última pantalla imprime el comando de una línea que construiría el mismo proyecto sin preguntas.

bxAgents new my-agent

Es una interfaz de pantalla completa en el verde azulado del logo de BxAgents. Las flechas (o j/k) se mueven, Espacio marca, Enter confirma, Esc vuelve una pregunta atrás y Ctrl+C cancela sin crear nada. Las respuestas ya dadas se colapsan en una línea cada una sobre la pregunta actual.

Qué pregunta

Una etapa cuya respuesta ya diste como opción se omite y se muestra como respondida. Una etapa que no aplica (el buscador cuando la búsqueda está desactivada) se omite sin avisar.

Las tools de archivos nunca reciben todo el disco

bx-ai incluye 19 tools de archivos pero no registra ninguna. El asistente las ofrece y siempre pregunta qué carpetas pueden usar: la carpeta temporal (tmp), la carpeta desde la que ejecutas el agente (cwd) o una ruta que escribas. No continúa sin ninguna. No hay forma de pedir acceso sin restricciones desde el asistente ni desde las opciones; una lista vacía se rechaza porque bx-ai la interpreta como "en todas partes".

tools:
  - readFile@bxai
  - listDirectory@bxai
toolOptions:
  bxai:
    allowedPaths:
      - tmp
      - cwd

Secretos

El asistente nunca te pide escribir un secreto que luego guarde.

• Claves de API y tokens van en .env como marcadores vacíos, cada uno bajo un comentario que dice dónde obtenerlo. Los archivos que los usan contienen solo el nombre de la variable.
• Una clave de acceso web se genera por ti (un valor aleatorio de 64 caracteres) y se escribe en .env, porque protege algo que estás por ejecutar.
• Una contraseña del chat web se convierte en hash con el mismo PBKDF2 que bxAgents hash-password; solo el hash llega a gateways/webui.bx y es seguro versionarlo.

.env está en el .gitignore con el que se crea el proyecto.

Servidores MCP

Todos los servidores del selector son remotos (HTTP) y el bx-ai incluido puede conectarse a ellos; se listan con su nivel de riesgo. Cada uno lee su credencial del entorno cuando arranca la app:

mcpServers:
  - name: github
    url: "https://api.githubcopilot.com/mcp/"
    token: "${env.GITHUB_PERSONAL_ACCESS_TOKEN}"

Elegir un servidor de riesgo alto muestra lo que puede hacer antes de continuar. Git está en el catálogo pero aún no se ofrece: se ejecuta como programa local y el bx-ai incluido en esta versión solo habla con servidores MCP web.

Después de crearlo

new ejecuta box install (omítelo con --skipInstall) y luego imprime lo que falta: las claves por completar, cómo chatear, probar, servir y desplegar, y, por cada canal elegido, la configuración que ocurre fuera del proyecto. Para WhatsApp son la app de Meta, el token de verificación y una dirección pública; para Slack, Socket Mode y dos tokens; para Signal, un signal-cli en ejecución. Los mismos pasos están en cada página de gateway.

Sin el asistente

El asistente no escribe nada que una opción no pueda. La última pantalla imprime el comando; este salió de una ejecución real:

bxAgents new support-bot --name=support-bot --model=claude --with=time,fetch,search --search=brave \
  --mcp=github --channels=web,telegram --web-auth=key --guard=flag --deploy=docker --registry=ghcr:me/support-bot

Una opción con un valor incorrecto detiene el comando y dice qué acepta. El asistente se activa así:

Define NO_COLOR para una salida sin color. Las opciones de Agent.yaml que escribe el asistente necesitan el Agent.yaml predeterminado, así que no se pueden combinar con --class.