✅Requisitos para el éxito de la formación de agentes

Validación del guión del agente

La Validación de Script es una comprobación durante el Entrenamiento del Agente de que se cumplen todos los requisitos del sistema para el Agente.

Formación de agentes

Hay dos maneras de formar a un Agente:

1. Haga clic en el botón Entrenar situado en la esquina superior derecha de BotBuilder, en la pestaña Diseñador de agentes.

1. Haga clic en el botón de la tarjeta de Agente.

Al pulsar el botón de entrenar:

1. Script Validation occurs. The process can take some time, up to 10 minutes on large Agents.

2. Una vez completada con éxito la Validación del Script, se crea un Modelo de Agente Entrenado basado en el Script válido.

Durante este tiempo, el botón Tren estará inactivo. Si el Script no cumple los requisitos, la Validación del Script fallará y aparecerá un texto de error en la esquina inferior derecha.

Importante: Si este Script ya ha sido entrenado, y después de hacer cambios la Validación del Script falla, entonces el antiguo Modelo de Agente entrenado funcionará.

Requisitos del agente para una validación satisfactoria

Para que la Validación de Script tenga éxito, el Script debe satisfacer las siguientes reglas:

1. El Guión no debe tener una Rama de Guión sin una Ranura de Bloqueo;

2. Los Script Branches después del Timer y Incoming Request Slots deben estar cerrados;

3. El conjunto de datos de formación de Intent debe contener al menos dos líneas;

4. Cada frase de formación debe contener al menos una letra;

5. El nombre de las Variables de Contexto de Usuario debe cumplir los requisitos para el nombre de las Variables de Contexto de Usuario.

6. El contenido de la subranura de resultado de una ranura de expresión regular debe ajustarse a su sintaxis.

7. La expresión de la subranura de condición de la ranura de regla de transición debe coincidir con su sintaxis.

8. En las ranuras de solicitud entrante, llenado de ranura, memoria y solicitud externa, no se intenta sobrescribir las variables de contexto del sistema cuya sobrescritura está prohibida

9. La ranura de notificación utiliza el canal de agente existente.

10. No hay bucles anidados en la ranura de repetición.

Errores de validación y su designación en el Árbol

1. Falta de ranuras de bloqueo en las ramas de script

Ranura de Bloqueo - Ranura en la que el Agente espera un mensaje entrante del Canal de Proyectos.

• Mensaje del usuario del bot

• Pulsando un botón.

Cada Rama de Script debe contener al menos una Ranura de Bloqueo, de lo contrario, si hay una Rama de Script sin Ranura de Bloqueo, el Agente puede entrar en ciclo permanente (pasará por todas las Ranuras de la Rama de Script un número infinito de veces).Lista de Ranuras de Bloqueo:

• Wait For Reaction;

• Button Menu;

• Change Chat Mode;

• Incoming Request Slot.

Si no hay ninguna Ranura de Bloqueo de la lista en la Rama de Guión, aparecerá el siguiente error durante el Entrenamiento de Agentes, donde Identificación de Ranura -> Identificación de Ranura es la ruta desde la Ranura de Inicio a la Ranura que finaliza la Rama de Guión no válida:

Importante: La Ranura de Bloqueo no tiene por qué estar al final de la Rama de Guión. Puede estar presente en cualquier parte de la Rama de Guión.

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Destacado de la rama	No hay ranuras de bloqueo en las ramas de script.	Se resalta toda la rama del escenario que carece de ranura de bloqueo. Al añadir una ranura a una rama problemática, la nueva ranura en el árbol se oscurece y no se resalta en ningún color.	Los tipos de ranura de bloqueo (Menú de botones, Cambiar modo de chat, Petición entrante, Esperar reacción) no se encontraron en la rama: Identificación de ranura -> Identificación de ranura" Qué hacer: añadir ranuras de bloqueo a la rama.

⁠2. Ramas de script no cerradas

Las siguientes ranuras no pueden situarse al final de una rama de script:

• Timer;

• Incoming Request Slot.

Estos Slots determinan el comienzo de uno de los escenarios del Agente, por lo que se deben añadir algunos Slots después de ellos. Si el Escenario al final de la Rama de Script contiene uno de los Slots listados, aparecerá el siguiente error durante el Entrenamiento del Agente:

Donde Slot ID es el ID de la Ranura después de la cual debe continuar el Guión.

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltado de ranura seguido de un botón para añadir una nueva ranura	Ramas de script no cerradas.	Se resaltan la ranura después de la cual debe continuar la secuencia de comandos, el botón para añadir una ranura y la línea de conexión entre ambos.	Una ranura de este tipo no puede ser la última de la sucursal. Qué hacer: añadir la siguiente rama o al menos alguna de estas ranuras: Wait for reaction, Change chat mode, Jump.

⁠3. Número insuficiente de frases en el conjunto de entrenamiento

Para que el reconocimiento tenga éxito, el conjunto de datos de formación debe rellenarse de acuerdo con las reglas descritas en el artículo Reconocimiento del lenguaje natural.Debe haber al menos dos filas en el conjunto de datos de formación Intent.

Si sólo hay una línea en el Conjunto de Datos de Entrenamiento, aparecerá un error al Entrenar al Agente, donde el nombre del Intento problemático se especifica entre comillas.

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Número insuficiente de frases en el conjunto de entrenamiento	Se resalta la subranura de intención problemática con un número insuficiente de frases en el conjunto de entrenamiento.	El número de peticiones de la intent 'nombre de la intent' no es suficiente, debería ser al menos 2. Qué hacer: añadir algunas peticiones a la intención.

⁠4. Número insuficiente de letras en la frase del conjunto de aprendizaje

Una Frase de Entrenamiento de Intención no puede contener menos de una letra.

Si la Frase de Entrenamiento de Intención no contiene al menos un carácter de letra, aparecerá el siguiente error durante el Entrenamiento del Agente:

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Número insuficiente de letras en la frase del conjunto de aprendizaje	Se resalta la subranura de intención problemática con un número insuficiente de letras en la frase de muestra de entrenamiento.	El número de letras en la petición "..." de esta intención no es suficiente, debería ser al menos 1. Qué hacer: edite la solicitud para que contenga al menos 1 letra.

⁠5. Caracteres sin mayúsculas en la subranura de resultado de la ranura de expresión regular

Los caracteres ' y \ en la Subranura de resultado de una Ranura de Expresión Regular deben escaparse: deben ir precedidos de un carácter .

Si no se escapa el carácter \ en la Sub-ranura de resultado de la Ranura de Expresión Regular, aparecerá el siguiente error durante el Entrenamiento del Agente:

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Caracteres sin mayúsculas en la subranura de resultado de la ranura de expresión regular	Se resalta la sub-ranura de resultado problemática con caracteres ' o \ no escapados.	' y los caracteres \ en las subcuadrículas de resultados deben escaparse con un carácter . Qué hacer: escapar los caracteres ' y \ con un carácter .

6. Se ha intentado sobrescribir variables de contexto del sistema cuya sobrescritura no está permitida.

Las siguientes Variables de Contexto del Sistema y Variables de Canal no son sobrescribibles:

Variable	Descripción	Utilización	Modificado por el usuario
agent_id	Identificador único del Agente en la Plataforma	identificación del Agente actual en este Chat	Deshabilitado
chat_id	ID de chat único en la plataforma	Identificación del chat en la plataforma Identificación de chat en Incoming Request Slot	Deshabilitado
channel_chat_id	Bot El identificador de usuario en el canal final es una variable sintética, las reglas para su formación se establecen en la configuración del conector para este canal.	Identificación del usuario de chat y/o bot en el canal final Creación de chat_id	Deshabilitado
channel_id	Identificador único del canal final	Identificador único del Canal del Proyecto en el que tiene lugar la comunicación en este Chat.	Deshabilitado
date	Hora de recepción del último mensaje del Usuario Bot = hora de recepción del último valor de client_message, pero específicamente del Canal de Proyectos (y no en la Ranura de Memoria).	en un Script a discreción del usuario a efectos de ejecución del Script	Deshabilitado
dialog_id	Identificación de la conversación	a efectos del sistema Identificación de un nuevo diálogo	Deshabilitado
modified_at	Hora de la última modificación del Contexto del Chat	en un Script a discreción del usuario	Deshabilitado
slot_id	Identificador único de plataforma de la última ranura "ejecutada" en el script.	en un Script a discreción del usuario	Deshabilitado
strategy_modified_at	Hora de creación Modelo de agente entrenado (hora del último entrenamiento del agente)	en un Script a discreción del usuario, también se utiliza para restablecer el estado del Chat cuando se entrena al Agente.	Deshabilitado
confidence	Porcentaje de confianza del modelo NLU al reconocer la Solicitud	al pasar por el Guión después de la Ranura NLU	Deshabilitado
error	Texto de error recibido como resultado de ejecutar NLU / Expresión regular Ranura / Ranura de memoria	al pasar por el Script después de NLU / Regular Expression Slot / Memory Slot	Deshabilitado
incoming_request_id	Identificador único de la plataforma (token) de la solicitud entrante	utilizado para inicializar el paso del Incoming Request Slot	Deshabilitado
intent	Identificador único de plataforma de la intención reconocida	al pasar por el Guión después de la Ranura NLU	Deshabilitado
IR_url	Dirección del webhook de solicitud entrante activo en este modelo de agente entrenado	Para enviar una solicitud desde sistemas externos al Agente	Deshabilitado
notification_count	Contador de envíos en un Chat específico	en un Script a discreción del usuario	Deshabilitado
notification_task_id	Toma el valor igual al ID de la tarea de envío que el sistema envió en la respuesta a la solicitud de envío del sistema externo.	en un Script a discreción del usuario	Deshabilitado
notification_init_time	Fecha y hora de inicio de la ejecución de la ranura de notificación en UTC	en un Script a discreción del usuario	Deshabilitado
notification_message_id	Cuando se envía un mailing, el canal final devuelve el id del mensaje	Movimiento del agente a través del guión	Deshabilitado
notification_id	mailing id, currently = Notification Slot id	Movimiento del agente a través del guión	Deshabilitado
notification_status	Estado técnico del mailing Valores posibles: 'no_account', 'failed', 'sent', 'delivered', 'read'	Movimiento del agente a través del guión	Deshabilitado
platform_chat_id	"Versión intermedia" del identificador de chat, diseñada para hacer coincidir los antiguos identificadores de chat con los nuevos.	Variable de servicio, aún no utilizada	Deshabilitado
chat_language	La variable almacena la lengua reconocida	en un Script a discreción del usuario	Deshabilitado
repeat_index	la variable se utiliza para reflejar el número de la iteración actual del bucle, la numeración de iteraciones comienza en 0		Deshabilitado

Nombre	Descripción	Edición por un usuario
channel_visitor_id	ID de usuario de bot o chat en un canal final	Deshabilitado
channel_conversation_id	ID de diálogo o chat en un canal final	Deshabilitado
channel_visitor_firstname	Nombre del usuario bot en un canal final	Deshabilitado
channel_visitor_lastname	Apellido de usuario de bot en un canal final	Deshabilitado
channel_visitor_account	Cuenta de usuario de botvin un canal final	Deshabilitado
channel_visitor_phone	Teléfono de usuario de bot en un canal final	Deshabilitado
channel_visitor_email	Correo electrónico del usuario bot en un canal final	Deshabilitado
channel_visitor_source	la fuente desde la que el usuario robot llegó al canal final (por ejemplo, etiquetas utm)	Deshabilitado
channel_visitor_auth	Datos de autorización del Usuario Bot	Deshabilitado
channel_visitor_location	Ubicación del usuario del bot en un canal final	Deshabilitado
channel_message_id	ID de mensaje en Chat2Desk	Deshabilitado
channel_message_recipient	Un Bot en Chat2Desk es un operador; su id se escribe en esta variable	Deshabilitado
channel_webhook_url	URL del webhook del canal final	Deshabilitado
channel_webhook_token	Canal webhook Token de la configuración del canal final	Deshabilitado

Cuando intente sobrescribirlos en la Incoming Request Slot, Slot Filling, Memory, External Request Slots durante la Formación de Agentes, aparecerá el siguiente error:

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Se ha intentado sobrescribir variables de contexto del sistema cuya sobrescritura no está permitida.	Se resalta la ranura problemática Solicitud entrante, Llenado de ranura, Memoria, Solicitud externa, Sinónimo.	"var" es una variable del sistema que no puede sobrescribirse en los siguientes tipos de ranura: Incoming Request, Slot Filling, Memory, External Request, Synonym. Qué hacer: eliminar la variable "var" de la ranura.

7. Escritura incorrecta de plantillas en la nueva sintaxis

Las reglas para escribir Plantillas se describen en el artículo Sintaxis. Si la Plantilla se ha introducido incorrectamente en la nueva sintaxis, aparecerá el siguiente error durante el Entrenamiento de Agentes:

Formato de texto de advertencia:

Invalid template syntax:
Slot <id of problem slot>. Error “<error description>” in expression “<problem expression>”

Ejemplo:

Invalid template syntax:
Slot 8848840. Error “unexpected char '@' at 3” in expression “{{ @foo }}”

Explicación del error: se ha detectado un error en la ranura 8848840 - un símbolo '@' extra con el número de secuencia 3 en la expresión {{ @foo }}.

Importante: el recuento de los números de serie de los caracteres de la expresión del problema empieza por 0.

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Escritura incorrecta de plantillas en la nueva sintaxis	Se resalta una ranura con una expresión o estructura de control mal compuesta	Error "<descripción del error>" en la expresión "<expresión mal compuesta>"Qué hacer: editar la expresión. Nueva documentación de sintaxis: enlace de documentación

8. La ranura de notificación utiliza un canal remoto

Si previamente se seleccionó un Canal de Proyecto en la Ranura de Notificación y luego se borró, aparecerá el siguiente error al Entrenar al Agente:

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Error text
Resaltar ranuras	La ranura de notificación utiliza un canal remoto	Se resalta el problema Ranura de notificación	Se establece un canal inexistente en el campo de destino (el canal podría estar borrado). Qué hacer: elegir un canal existente.

9. Invalid user variable name

Si Memory, Slot Filling, Notification, Incoming Request Slot, Synonym Slot o External Request contiene Variables de Contexto de Usuario cuyo nombre no cumple los requisitos, aparecerá el siguiente error durante el Entrenamiento del Agente:

Resaltado de errores e información sobre herramientas

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Nombre de variable de usuario no válido	Se resalta la ranura problemática que contiene la variable	Nombre equivocado. El nombre no debe tener más de 128 caracteres y sólo puede contener letras latinas, números y _ .Qué hacer: editar el nombre.

10. Ranura de repetición bucles anidados

Si hay otras ranuras de repetición en la rama de guión Repetir siguiente subranura, se mostrará un error:

Resaltado de errores e información sobre herramientas

⁠

Tipo de resalte	Error de validación	Destacando	Texto de error
Resaltar ranuras	Ranura de repetición bucles anidados	La ranura de repetición problemática aparece resaltada	Las repeticiones anidadas no están permitidas . Qué hacer: eliminar ranura anidada Repetir.

⁠