Herramientas y habilidades

Abre un asistente y selecciona Tools & Skills. Esta sección controla las capacidades en tiempo de ejecución y las instrucciones reutilizables.

Herramientas integradas

La herramienta Search knowledge está siempre disponible. Puedes habilitar o deshabilitar las demás herramientas integradas.

Interactive tables organiza los datos que el asistente ha encontrado en esta respuesta. El entorno de ejecución selecciona la tabla a partir de tu solicitud y de los datos disponibles.

• Una tabla sencilla compara datos y puede incluir preguntas de seguimiento por fila.
• Una cuadrícula de registros de CRM muestra empresas, categorías, última interacción, estado de la relación y enlaces a sitios web. Selecciona filas, ordena, cambia el tamaño o ancla columnas.
• Una tabla de tareas muestra las fechas, el estado y los responsables. Selecciona All, To do, In Progress o Completed para filtrar sus filas.

Los recuentos de los filtros proceden de los datos mostrados. Los datos faltantes permanecen vacíos. Los ajustes de la tabla afectan a la vista actual y no modifican los registros del CRM.

Usa New property o Add calculation en la cuadrícula del CRM para preparar una solicitud de propiedad. Revisa su prompt y, a continuación, selecciona Go calculate. Esto envía una solicitud de chat normal. El harness actual, las fuentes conectadas y los permisos siguen aplicándose. La interfaz de usuario no simula los valores generados.

Las mismas tablas aparecen en Preview, en el Widget publicado y en la transcripción de Inbox. Publica el asistente después de habilitar esta herramienta. La bandeja de entrada admite la visualización, la selección, el filtrado y el diseño de columnas. No envía solicitudes de propiedades.

El asistente puede añadir una pregunta de seguimiento a una fila. El Visitor selecciona la fila para hacer esa pregunta. La transcripción de la Inbox muestra estas filas, pero un Member no puede seleccionarlas.

Habilitar el modo de estudio

Study Mode está desactivado de forma predeterminada. Actívalo para que los visitantes puedan practicar el Knowledge del asistente con ejercicios interactivos.

1. Abre Tools & Skills y habilita Study Mode.
2. Habilita al menos un formato de pregunta.
3. Añade Custom instructions para establecer el estilo de enseñanza.
4. Prueba un ejercicio en Preview.
5. Publica el asistente para actualizar el widget.

El editor de mensajes del chat muestra un botón Study exercises. Selecciona un formato, añade un tema y, a continuación, envía la solicitud.

Cuando está habilitado, Study Mode también aparece en Flows. Su botón de ajustes abre esta sección. Desactiva el modo de estudio en Tools & Skills. El Flow no tiene un conmutador independiente. Las solicitudes del menú Study exercises van directamente a este Flow. Aparece un icono de birrete de graduación en Thinking.

Los ejercicios necesitan material relevante en la Knowledge del asistente. Si no se encuentra ningún material, el asistente te pide un tema admitido o material de estudio.

Choose for me selecciona un formato habilitado. Cada ejercicio contiene como máximo cinco preguntas distintas basadas en el Knowledge recuperado.

Selecciona Check para guardar una respuesta. Ciele te muestra si es correcta, la respuesta correcta y una explicación. No puedes modificar una respuesta ya enviada. Las tarjetas de memoria aceptan las variantes ortográficas definidas cuando se creó el ejercicio.

La Inbox muestra las preguntas, las respuestas enviadas, las respuestas correctas y la puntuación. Los ejercicios sin terminar muestran cuántas preguntas quedan sin responder. Los ejercicios se ejecutan dentro del chat. No necesitan un reproductor H5P externo.

Configura una integración de API

Un asistente puede usar una integración de API registrada. La integración contiene una URL base, una credencial protegida y endpoints descritos.

Para cada endpoint, define el método, la ruta, el propósito, los parámetros y la estructura de la respuesta. El entorno de ejecución valida cada ruta solicitada frente a este catálogo.

El agente puede inspeccionar los detalles del endpoint antes de enviar una solicitud. Las respuestas de gran tamaño siguen estando disponibles mediante lecturas por ventanas.

Evita una escritura duplicada

Puedes volver a enviar una solicitud después de un tiempo de espera o de un fallo. Si el endpoint escribe datos, la segunda solicitud puede crear un segundo registro.

Para evitarlo, asigna al endpoint una clave de idempotencia. En el formulario del endpoint, indica dónde lee tu API la clave:

• header:Idempotency-Key envía la clave en un encabezado de solicitud.
• body:request_id envía la clave en el cuerpo JSON.

Usa el nombre que lee tu API. Ciele no adivina este nombre. Diferentes API leen diferentes nombres.

Ciele genera una clave para cada llamada. Al reintentar la misma llamada, se envía la misma clave. Una llamada diferente envía una clave diferente. Tu API puede entonces ver las dos solicitudes como una única operación de escritura.

Tu API también debe hacer su parte. Debe almacenar la clave y devolver el primer resultado cuando vuelva a ver la clave.

Asigna una Skill de organización

Una Skill es una plantilla de instrucciones reutilizable. Una organización puede asociar la misma Skill a varios asistentes.

1. Abre Tools & Skills.
2. Busca la Skill de organización necesaria.
3. Asocia la Skill al Assistant.
4. Prueba el resultado en Preview.
5. Publica el Assistant cuando el resultado sea correcto.

Los cambios en las habilidades están disponibles en Preview de inmediato. El Widget publicado utiliza la última instantánea de la publicación.

Permite que los usuarios inicien una Skill desde la ventana de chat

Una Skill puede tener un Opening line. Escríbelo como la persona que pregunta, no como el asistente.

La ventana de chat muestra un menú / con cada Skill que tiene una frase de apertura. Cuando seleccionas una Skill, la ventana de chat escribe la frase de apertura en el cuadro de mensajes. Puedes editar el texto antes de enviarlo.

Si la frase de apertura está vacía, la Skill no aparece en el menú /. En los conjuntos de Skills cortos (hasta 4000 caracteres en total), introduce las instrucciones para cada respuesta. En el caso de conjuntos más extensos, el modelo ve los nombres y las descripciones y carga los playbooks correspondientes bajo demanda. Proporciona a cada Skill una descripción clara de cuándo se aplica.

Publica el asistente después de escribir una frase inicial. El Widget utiliza la última instantánea de Publication.

Los archivos adjuntos y la Knowledge no son lo mismo

Tanto un archivo adjunto como una Knowledge Source se convierten en texto, y Ciele los lee con el mismo extractor. Lo que ocurre a continuación es diferente.

Una Knowledge Source es permanente. Ciele almacena su texto, lo indexa y el asistente puede citarlo en todas las conversaciones posteriores.

Un archivo adjunto pertenece a su conversación. Ciele lo lee una sola vez, descarta los bytes y nunca lo añade a la Library. Ninguna otra conversación lo ve.

Para que un archivo sea permanente, añádelo en Library en su lugar.

Prueba la configuración

Formula una pregunta que requiera cada una de las herramientas habilitadas. Revisa el panel Thinking y las Sources antes de publicar.

En el caso de los datos estructurados, prueba una búsqueda exacta de atributos y una búsqueda de texto. Prueba el acceso con ámbito de usuario con dos cuentas diferentes que hayan iniciado sesión.