Requisitos para el éxito de la formación de agentes
Last updated
Last updated
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.
Hay dos maneras de formar a un Agente:
Haga clic en el botón Entrenar situado en la esquina superior derecha de BotBuilder, en la pestaña Diseñador de agentes.
Haga clic en el botón de la tarjeta de Agente.
Al pulsar el botón de entrenar:
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á.
Para que la Validación de Script tenga éxito, el Script debe satisfacer las siguientes reglas:
El Guión no debe tener una Rama de Guión sin una Ranura de Bloqueo;
Los Script Branches después del Timer y Incoming Request Slots deben estar cerrados;
El conjunto de datos de formación de Intent debe contener al menos dos líneas;
Cada frase de formación debe contener al menos una letra;
El nombre de las Variables de Contexto de Usuario debe cumplir los requisitos para el nombre de las Variables de Contexto de Usuario.
El contenido de la subranura de resultado de una ranura de expresión regular debe ajustarse a su sintaxis.
La expresión de la subranura de condición de la ranura de regla de transición debe coincidir con su sintaxis.
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
La ranura de notificación utiliza el canal de agente existente.
No hay bucles anidados en la ranura de repetición.
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:
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.
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.
Las siguientes ranuras no pueden situarse al final de una rama de script:
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 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.
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.
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.
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:
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.
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:
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 .
Las siguientes Variables de Contexto del Sistema y Variables de Canal no son sobrescribibles:
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
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
Deshabilitado
incoming_request_id
Identificador único de la plataforma (token) de la solicitud entrante
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
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
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.
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:
Ejemplo:
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.
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
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:
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.
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.
Si hay otras ranuras de repetición en la rama de guión Repetir siguiente subranura, se mostrará un 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.
occurs. The process can take some time, up to 10 minutes on large s.
;
;
;
.
;
.
Identificación de chat en
al pasar por el Script después de / /
utilizado para inicializar el paso del
Cuando intente sobrescribirlos en la , , , s durante la Formación de Agentes, aparecerá el siguiente error:
Si , , , , o contiene Variables de Contexto de Usuario cuyo nombre no cumple los requisitos, aparecerá el siguiente error durante el Entrenamiento del Agente:
