Los agentes de Dialogflow CX ahora se pueden exportar en formato JSON

Ya es posible exportar agentes de Dialogflow CX en formato JSON, ideal para revisar y comparar fácilmente las versiones de los agentes

JSON son las siglas de JavaScript Object Notation, un formato ligero de datos con una estructura específica que es compatible de forma nativa con JavaScript. El archivo JSON package se encuentra en la carpeta raíz del proyecto y es siempre un fichero de texto con información muy diversa.

Recientemente se ha integrado el formato JSON en Dialogflow CX para exportar y restaurar los agentes, lo que es ideal para revisar y comparar fácilmente las versiones de agentes.

Pero ojo, porque no se recomienda editar directamente los archivos de texto JSON, ya que los errores de formato o valor pueden alterar el estado del agente. Además, solo está disponible para la exportación y restauración de un agente, no de flujos individuales.

Estructura de directorios

Una exportación de agente es un archivo zip que contiene una jerarquía de directorios y archivos JSON. Esta es la estructura del directorio:

• entityTypes: contiene sus tipos de entidades.
  • <entity type name>: los nombres de estos directorios corresponden a los de visualización del tipo de entidad.
    • entities: contiene archivos de entrada de entidad.
      • <language tag>.json: existen uno o más de estos archivos y sus nombres corresponden a etiquetas de idioma.
    • <excludedPhrases>: contiene archivos de frases excluidos.
      • <language tag>.json: los nombres de archivo corresponden a etiquetas de idioma. Cada archivo contiene exclusiones de frases específicas del idioma.
    • <entity type name>.json: este nombre de archivo corresponde a un nombre de visualización de tipo de entidad. Contiene datos específicos que no se encuentran en otros archivos.
• flows: contiene sus datos de flujo.
  • <flow name>: los nombres de estos directorios corresponden a los de de visualización de los flujos.
    • pages: contiene los datos de la página para el flujo.
      • <page name>.json: los nombres de estos archivos corresponden a los de visualización de las páginas. Cada uno contiene datos específicos de la página.
    • transitionRouteGroups: contiene los datos de su grupo de rutas para el flujo.
      • <route group name>: los nombres de los archivos corresponden a los nombres de visualización del grupo de rutas. Cada uno contiene datos específicos del grupo de rutas.
    • <flow name>.json: corresponde a un nombre de visualización de flujo. Contiene datos específicos del flujo que no se encuentran en otros archivos.
• intents: contiene sus datos de intención.
  • <intent name>: los nombres de los directorios corresponden a los nombres para mostrar de la intención.
    • trainingPhrases: contiene datos de frases de entrenamiento.
      • <language tag>.json: los nombres de archivo corresponden a etiquetas de idioma. Cada uno contiene frases de entrenamiento específicas del idioma para la intención.
    • <intent name>.json: este nombre de archivo corresponde a un nombre para mostrar de intenciones. Contiene datos específicos de la intención que no se encuentran en otros archivos.
• testCases: contiene los datos de su caso de prueba.
  • <test case name>.json: los nombres de archivo corresponden a los nombres de visualización de casos de prueba. Cada uno contiene datos específicos del caso de prueba.
• webhooks: contiene los datos de su webhook.
  • <webhook name>.json: los nombres de archivo corresponden a los nombres para mostrar de webhook. Cada uno contiene datos específicos del webhook.
• agent.json: contiene datos específicos del agente que no se encuentran en otros archivos.

Nombres de los recursos

Algunos nombres de carpetas y archivos JSON corresponden a nombres de visualización de recursos. Si un nombre para mostrar contiene caracteres que no están permitidos en los nombres de archivo ( $, <, >, etc.), estos se codifican como URL para el directorio o nombre de archivo.

Además, cualquier campo JSON que contenga una referencia a un recurso, se establece con el nombre de visualización del mismo, en lugar de su nombre completo con el ID. Ten en cuenta que antes de editar un archivo en formato JSON en Dialogflox CX, para cambiar el nombre de visualización de un recurso debes asegurarte de actualizar también todas las referencias a ese recurso.