Workspace y manifiesto

Un workspace contiene un agente y sus conversaciones, contactos, conocimiento, secretos y conexiones de canal. Su configuración desplegable vive en un directorio que contiene vatio.yml:

support-agent/
  vatio.yml          # requerido
  tools/*.yml        # herramientas
  identity.pub       # clave pública que verifica tu JWT (ver Autenticación)

Crea solo los archivos que necesites. La CLI busca el vatio.yml más cercano en el directorio actual o por encima de él, y lee workspace para elegir el remoto. Los comandos de despliegue no tienen flag --workspace ni override VATIO_WORKSPACE. Tus credenciales de usuario viven aparte, en ~/.vatio/config.json.

Las guías siguientes muestran fragmentos de configuración. Fúndelos en tu manifiesto existente, dejando una sola copia de cada clave raíz y preservando las instrucciones y asignaciones de herramientas que sigas necesitando.

Claves raíz

Estas son las claves raíz soportadas. Una clave raíz desconocida falla la validación.

Clave	Propósito
workspace	Slug remoto: minúsculas y dígitos separados por guiones
agent	La definición del agente; requiere instructions no vacío
agents	Varios agentes, con clave por slug, en vez de agent
entry	Qué agente toma una conversación; ver Varios agentes
business	Nombre y contexto de la empresa para el agente
widget	Apariencia web, textos, idioma y orígenes permitidos
auth	Clave pública que verifica tu JWT; ver Autenticación

knowledge y links no son claves raíz: cada agente declara las suyas, dentro de su bloque agent: o agents:. identity es auth. Un manifiesto que todavía cargue cualquiera de las tres falla el push indicando la migración a hacer.

Usa agent: false solo para un workspace dedicado a la API de verificación de teléfono. No puede además declarar widget, autenticación, conocimiento, enlaces, herramientas ni helpers compartidos.