Usted está aquí:
Guía de referencia de datos de bots
Una lista de objetos, eventos y campos de bots que puede utilizar cuando solucione problemas, desarrolle o construya bots de Einstein.
Ediciones necesarias
| Ver ediciones admitidas. |
Referencia de entidad de bot
Un registro de unión entre sesiones de bot y eventos de bot.
| Etiqueta de evento de bot | Definición |
|---|---|
| BotDefinition | El nombre del bot. |
| BotVersion | La versión del bot. |
| ConversationDefinitionDialog | Un diálogo dentro de una versión de bot. |
| ConversationDefinitionSession | Una sesión de bot. |
| ConversationDefinitionSessionEngagement | Un objeto de unión entre una Sesión de definición de plática y las participaciones de pláticas correspondientes para la sesión. |
| ConversationDefinitionEventLog | Almacena acciones realizadas por el tiempo de ejecución de plática automatizada para el análisis y la solución de problemas del usuario. |
Sesión de definición de plática
Un registro generado con cada sesión de bot. Estos datos se eliminan transcurridos siete días.
| Campo | Definición |
|---|---|
| Tipo de canal | El tipo de canal en la sesión. Ejemplos: Chat, personalizado |
| Definición de plática | El Id. de 15 dígitos de la versión de bot asociada con la sesión. |
| Id. de Sesión de definición de plática | El Id. de 15 dígitos de la sesión. |
| Tiene registros de errores | Identifica si la sesión incluye un evento de error. |
| Hour | La hora relacionada con el registro (0-23). |
| Nombre de integración | El nombre de la conexión externa al bot. |
| Tipo de integración | El tipo de conexión externa al bot. Ejemplo: API |
| Duración de sesión | La hora de la sesión en milisegundos. |
| Tipo de finalización de sesión | La forma con la que finalizó la sesión. Ejemplos: Finalizada por usuario final, Transferida, Tiempo de espera de sesión agotado, Error, Acción, Otra |
| Hora de inicio de sesión | La hora y fecha de inicio de inicio de la sesión. |
| Estado de sesión | El estado de la sesión. Ejemplo: Finalizada |
| Resultado de transferencia de sesión | Si se inició una transferencia, el estado de la transferencia. Ejemplos: Transferencia correcta, Transferencia con fallo, No se solicitó ninguna transferencia, No hay agentes disponibles |
| Tipo de destino de transferencia de sesión | El destino de la transferencia: Bot o representante de servicio |
| Tipo de transferencia de sesión | El origen de la solicitud para transferir. Ejemplos: Solicitud de bot, Error de implementación, Tiempo de espera de invocación, Privilegios insuficientes |
| Sesión implicada | Indica si se implica una sesión de bot (verdadero) o no (falso). El valor predeterminado es false. Una sesión implicada es una sesión en la que un usuario envía al menos un mensaje o hace clic en al menos una opción o elección de menú. En una transferencia de bot a bot, una sesión se considera implicada cuando un usuario interactúa con al menos uno de los bots. |
Registro de eventos de definición de plática
Un registro de los eventos que se producen en una sesión de bot, incluyendo acciones que el bot toma para interactuar con el usuario y pasos más detallados de procesamiento. Estos datos se eliminan transcurridos siete días.
| ChannelType | El tipo de canal en la sesión. Ejemplo: Sesión de chat |
| ConversationDefinition | El Id. de la versión del bot asociada con este registro de eventos. |
| ConversationTurn | El UUID de la turno de plática. |
| DialogDefinition | El Id. del diálogo asociado con este registro de eventos. |
| EventDetails | Contiene detalles acerca de eventos NLP/ELU. |
| EventLabel | Descripción del registro de eventos que se muestra en la ficha Desempeño. |
| EventTarget | La enumeración o el Id. del destino del evento. Ejemplo: Id. de diálogo |
| EventTargetType | El tipo de destino del registro de eventos. Ejemplo: Apex, Flujo |
| EventTimestamp | La marca de tiempo del registro de eventos. |
| EventUuid | El UUID de 32 caracteres asociado con este registro de eventos. |
| Idioma | El idioma seleccionado para el bot. Un bot con un solo idioma muestra el idioma establecido en la página Descripción general de bot, y un bot con múltiples idiomas comienza con el idioma principal y luego actualiza al idioma secundario seleccionado. |
| LogLevel | El nivel del registro de eventos. Ejemplo: Depuración, Información |
| LogType | El tipo del registro de eventos. Ejemplo: Sesión de inicio PlannerInvalidAction: Se registra cuando el planificador intenta ejecutar una acción no válida o no compatible durante un paso de definición de plática o un paso de tiempo de ejecución. ResponseEvaluationMetric: Se registra cuando se registra una medición de evaluación de respuesta para un resultado de modelo, como el puntuaje basado en hechos o rúbricas. |
| Parent | El Id. de la sesión asociada con este registro de eventos. |
| PreviousEventLog | El Id. del registro de eventos anterior. |
| PreviousEventLogUuid | El EventUuid del registro de eventos anterior. |
| StepDefinition | El Id. del paso de diálogo asociado con este registro de eventos. |
| StepType | El tipo del paso de diálogo. Ejemplo: Transferir |
Mediciones diarias de diálogo de definición de plática
Un registro de mediciones de bot por día para la creación de reportes a lo largo del tiempo.
| Campo | Definición |
|---|---|
| Artículo | El Id. del artículo de conocimiento seleccionado. |
| ArticleName | El título del artículo de conocimiento seleccionado. |
| BotDefinitionName | El nombre del bot. |
| BotVersionID | El número de versión del bot. |
| ChannelType | El tipo de canal en la sesión. Ejemplo: Sesión de chat |
| ConversationDefinitionId | |
| DialogDefinition | El Id. de 15 dígitos del diálogo. |
| DialogDefinitionName | El nombre del diálogo. |
| DialogEntryPoint | El número de puntos de entrada para un diálogo determinado. Los puntos de entrada son el modo mediante el cual un usuario llegó a un diálogo concreto, incluyendo Navegación de usuario, Acción de regla, Siguiente paso de diálogo y Detección de intención. |
| GoalName | El nombre de un objetivo definido por el administrador que alcanzó un usuario. |
| IntegrationName | El nombre de la conexión externa al bot. |
| IntegrationType | El tipo de conexión externa al bot. Ejemplo: API, Slack |
| Etiqueta de intención | El nombre de la intención. |
| IsSuccessful | Un campo booleano que identifica el éxito o el fallo de una acción si el tipo de medición hace referencia a una acción que podría fallar. |
| Idioma | El idioma seleccionado para el bot. Un bot con un solo idioma muestra el idioma establecido en la página Descripción general de bot, y un bot con múltiples idiomas comienza con el idioma principal y luego actualiza al idioma secundario seleccionado. |
| MetricDateTime | La fecha en que se registró la medición. |
| MetricType | El tipo de medición registrada. Ejemplos: Distribución, Excepción, Diálogo de cancelación, Diálogo abierto, Diálogo completado, Confusión, Opción seleccionada, Sesiones iniciadas, Acción ejecutada, Sesiones finalizadas, Intención de NLP llamada, Transferido, Objetivo completado, Sesiones implicadas |
| SessionEndType | Categoriza el modo en que finalizó la sesión de plática. Ejemplos: Acción, Finalizada por usuario final, Error, Otro, Tiempo de espera de sesión agotado o Transferido. |
| SessionTransferType | El origen de la solicitud para transferir. Ejemplos: Solicitud de bot, Error de implementación, Tiempo de espera de invocación, Privilegios insuficientes |
| StaticChoiceValue | El texto de la selección de opción estática por el usuario. |
| Value | Valor de la medición. Ejemplo: Si 20 sesiones de bot se iniciaron en el último mes, el Tipo de medición sería Sesiones iniciadas y el Valor sería 20. |
Mediciones por hora de diálogo de definición de plática
Un registro de mediciones de bot por hora para la creación de reportes a lo largo del tiempo.
| Campo | Definición |
|---|---|
| Artículo | El Id. del artículo de conocimiento seleccionado. |
| ArticleName | El título del artículo de conocimiento seleccionado. |
| BotDefinitionName | El nombre del bot. |
| BotVersionID | El número de versión del bot. |
| ChannelType | El tipo de canal en la sesión. Ejemplo: Sesión de chat |
| DialogDefinition | El Id. de 15 dígitos del diálogo. |
| DialogDefinitionName | El nombre del diálogo. |
| DialogEntryPoint | El número de puntos de entrada para un diálogo determinado. Los puntos de entrada son el modo mediante el cual un usuario llegó a un diálogo concreto, incluyendo Navegación de usuario, Acción de regla, Siguiente paso de diálogo y Detección de intención. |
| Nombre de objetivo | El nombre de un objetivo definido por el administrador que alcanzó un usuario. |
| Hour | La hora relacionada con el registro (0-23). |
| IntegrationName | El nombre de la conexión externa al bot. |
| IntegrationType | El tipo de conexión externa al bot. Ejemplo: API, Slack |
| IntentLabel | El nombre de la intención. |
| IsSuccessful | Un campo booleano que identifica el éxito o el fallo de una acción si el tipo de medición hace referencia a una acción que podría fallar. |
| Idioma | El idioma seleccionado para el bot. Un bot con un solo idioma muestra el idioma establecido en la página Descripción general de bot, y un bot con múltiples idiomas comienza con el idioma principal y luego actualiza al idioma secundario seleccionado. |
| MetricDateTime | La fecha y la hora en que se registró la medición. |
| MetricType | El tipo de medición registrada. Ejemplos: Acción ejecutada, Distribución, Excepción, Diálogo de cancelación, Diálogo abierto, Diálogo completado, Confusión, Opción seleccionada, Objetivo completado, Sesiones iniciadas, Sesiones implicadas, Sesiones finalizadas, Intención de NLP llamada, Transferido. |
| SessionEndType | Categoriza el modo en que finalizó la sesión de plática. Ejemplos: Acción, Finalizada por usuario final, Error, Otro, Tiempo de espera de sesión agotado o Transferido. |
| SessionTransferType | El origen de la solicitud para transferir. Ejemplos: Solicitud de bot, Error de implementación, Tiempo de espera de invocación, Privilegios insuficientes |
| StaticChoiceValue | El texto de la selección de opción estática por el usuario. |
| Value | Valor de la medición. Ejemplo: Si 20 sesiones de bot se iniciaron en el último mes, el Tipo de medición sería Sesiones iniciadas y el Valor sería 20. |
Medición de sesión de definición de plática
Un registro de mediciones de bot por sesión. Estos datos se eliminan después de 180 días.
| Campo | Definición |
|---|---|
| ArticleChosenCount | El número de artículos que el usuario final seleccionó en una sesión. |
| ChoiceSelectionCount | El número total de opciones que el usuario final seleccionó en una sesión, incluyendo opciones estáticas en preguntas y opciones desde el menú principal. |
| GlobalChoiceSelectionCount | El número de opciones que el usuario final seleccionó en una sesión desde el menú Opciones. |
| InputMessageCount | El número de mensajes enviados por el usuario final al bot. |
| InterruptedDialogCount | El número de diálogos donde el usuario final eligió salir del diálogo. Los métodos incluyen la selección en el menú Opciones o el ingreso de texto que coincide con una intención. |
| LastDialog | El Id. de 15 dígitos del último diálogo visitado cuando finalizó la sesión del bot. |
| LastDialogName | El nombre del último diálogo visitado cuando finalizó la sesión del bot. |
| NlpIntentRequestCount | El número de entradas de texto enviadas para coincidencia de intención. |
| NlpIntentRequestHitCount | El número de entradas de texto con una coincidencia de intención correcta. |
| OutputMessageCount | El número de mensajes enviados por el bot al usuario final. |
| StartedDialogCount | El número de diálogos iniciados dentro de una sesión. |
| TransferWaitTime | Duración en segundos entre el usuario que solicita una transferencia y un representante de servicio que acepta la transferencia. |
| WasSessionDropped | Identifica si la sesión se descartó. |
Registro de eventos: Lista de eventos
Un registro creado cada vez que se produce un evento en una sesión de bot. Estos datos se eliminan transcurridos siete días.
| Nivel | Evento | Descripción |
|---|---|---|
| Depuración | Variable de contexto de inicialización: | El bot está accediendo a una variable de contexto. |
| Error | Error: | Se produjo un error. |
| Error | Fallo de invocación - errores: | El bot invocó un flujo o Apex pero se produjeron errores. |
| Error | Falló la transferencia: | La transferencia falló. |
| Información | Diálogo de llamada: | El bot llamó a un diálogo. |
| Información | Borrar variable: | El bot utilizó el diálogo Borrar valor de variable. Nombre de variable se incluye en el registro de evento. |
| Información | Proceso de desambiguación completado | Se completó el proceso de desambiguación. |
| Información | Falló la llamada ELU | La llamada ELU falló. |
| Información | Llamada ELU correcta | La llamada ELU se realizó correctamente. |
| Información | Finalizar chat solicitado | El bot finalizó el chat. |
| Información | Fin de diálogo: | El fin de un diálogo. |
| Información | Entidad extraída | El bot fue capaz de extraer correctamente una entidad. |
| Información | Aumento de categoría solicitado | Se solicitó una distribución a un representante de servicio. |
| Información | Entidades externas extraídas | El bot fue capaz de extraer correctamente una entidad de un origen externo. |
| Información | Se detectaron intenciones externas | El bot detectó intenciones desde un origen externo. |
| Información | Comentarios: | El usuario proporcionó comentarios indicando si el artículo de Knowledge que se presentó fue útil. |
| Información | GoalAchieved: | El usuario alcanzó un objetivo definido por el administrador. |
| Información | Intención detectada correctamente: | El bot fue capaz de identificar una intención. |
| Información | Falló la detección de la intención | El bot no fue capaz de identificar una intención. |
| Información | Fallo de invocación - errores: | El bot no pudo invocar un flujo o Apex. |
| Información | Invocación correcta: | El bot pudo invocar un flujo o Apex. |
| Información | Idioma | El idioma seleccionado para el bot. Un bot con un solo idioma muestra el idioma establecido en la página Descripción general de bot, y un bot con múltiples idiomas comienza con el idioma principal y luego actualiza al idioma secundario seleccionado. |
| Información | Idioma cambiado de {0} a {1} | El idioma seleccionado para el bot se cambió del idioma original a un idioma diferente. |
| Información | Coincidencia encontrada: | El bot pudo coincidir con una intención, entidad o extracción booleana ELU. |
| Información | Componente de mensaje enviado: | Se envió un componente de mensajería mejorada a un usuario. |
| Información | Mensaje enviado: | Se envió un mensaje a un usuario. |
| Información | No se encontró ninguna coincidencia: | El bot no pudo coincidir con una intención, entidad o extracción booleana ELU. |
| Información | Fuera del dominio | El bot no pudo coincidir con una intención. |
| Información | Solicitud enviada: | Se envió una pregunta a un usuario. |
| Información | Redirigir a diálogo: | El bot redirigió a un diálogo. |
| Información | Evaluación de condición de regla | El bot está evaluando el ingreso del usuario basándose en las condiciones de la regla. |
| Información | Resultado de elemento de condición de regla: Falso | El bot evaluó el ingreso del usuario basándose en las condiciones de la regla y encontró que no cumplía esas condiciones. |
| Información | Resultado de elemento de condición de regla: Verdadero | El bot evaluó el ingreso del usuario basándose en las condiciones de la regla y en que lo encontró para cumplir esas condiciones. |
| Información | Fallo de búsqueda - errores: | El bot realizó una búsqueda y encontró un error. |
| Información | Búsqueda correcta | El bot realizó una búsqueda y se realizó correctamente. |
| Información | Datos confidenciales no disponibles | Este evento se muestra cuándo “Almacenar datos de plática de bots de Einstein” no está seleccionado. |
| Información | Sesión finalizada | Finalizó la sesión del bot. |
| Información | Establecer variable | El bot utilizó el diálogo Establecer variable. Nombre de variable se incluye en el registro de evento. |
| Información | Inicio de diálogo: | El comienzo de un nuevo diálogo. |
| Información | Iniciar proceso de desambiguación | El comienzo del diálogo de desambiguación. |
| Información | Inicio de una nueva sesión | El bot está iniciando una nueva sesión. |
| Información | Opción estática seleccionada | El usuario seleccionó una opción estática presentada por el bot. |
| Información | Transferencia correcta: | La transferencia se realizó correctamente. |
| Información | Transferida desde bot: | La plática se inició con una transferencia de bot. |
| Información | Respuesta de usuario: | La respuesta del usuario. |
| Información | El usuario envió un archivo | El usuario envió un archivo. |
| Información | Variable ya rellenada: | El bot intentó ingresar datos en una variable pero ya estaba rellena. |
Mediciones agregadas
Los siguientes campos son cálculos utilizados para generar mediciones agregadas. Agregar datos de origen de campos a partir de acciones de eventos en la sesión, que se muestran como eventos en los registros de eventos. Para obtener más información acerca de un agregado por un valor específico, como por bot o por canal, utilice agrupaciones de agregados.
| Agregación | Evento | Acción |
|---|---|---|
| AllELUCalled | Llamada ELU | Se realizó una llamada ELU. |
| ArticleChosen | Artículo elegido | Se seleccionó un artículo. |
| ArticleFeedbackCount | Conteo de comentarios de artículos | El conteo total de puntuajes de comentarios de artículos. |
| ArticleFeedbackSum | Suma de comentarios de artículo | El valor de suma de puntuajes de comentarios de artículos. |
| CancelDialog | Diálogo cancelado | Un diálogo lo canceló el usuario. |
| ChoiceSelected | Respuesta de usuario | La opción estática seleccionada por el usuario final. |
| CompletedGoalSession | Sesión de objetivos completada | El usuario completa al menos un objetivo definido por el administrador en la sesión. |
| Confusión | Falló la detección de la intención | El bot no puede identificar una intención desde la entrada de usuario final. |
| DialogCompleted | Fin de diálogo | Un diálogo completado que ha ejecutado todos los pasos de diálogo. |
| DialogOpened | Diálogo de llamada, Redirigir a diálogo, Iniciar diálogo | Un diálogo abierto en una sesión, incluyendo llamadas y redireccionamientos. |
| ELUBooleanExtracted | Booleano ELU extraído | El bot detectó un booleano ELU. |
| ELUEntityCalled | Entidad ELU llamada | El bot detectó una entidad ELU. |
| ELUIntentCalled | Intención ELU llamada | El bot detectó una intención ELU. |
| Distribución | Aumento de categoría solicitado | Un usuario solicita una transferencia o un bot encuentra un error en una sesión. |
| Excepción | Error, Fallo de invocación - errores | Un error en medio de la sesión. |
| FalledTransferSession | La transferencia falló | Una intento de transferencia falló. |
| GoalAchieved | Objetivo completado | El usuario completó un objetivo definido por el administrador. |
| NLPIntentCalled | Intención detectada correctamente, Fallo de detección de la intención | Una solicitud al sistema NLP interno o externo. |
| SessionsEnded | Sesión finalizada | Una sesión finalizada, por el usuario y el bot. |
| SessionsStarted | Inicio de una nueva sesión | Se inicia una sesión de bot. |
| Transferido | Falló la transferencia o la transferencia se realizó correctamente | Cualquier solicitud de transferencia. |
