Chat Inteligente | Skills

AdministradorSuper Administrador

Una skill es un bloque de instrucciones especializadas que el asistente carga solo cuando la conversación lo requiere. Desde esta pantalla podrás crear tus propias skills, buscarlas entre las que ya existen, editarlas, activarlas, desactivarlas y borrarlas. Para llegar a ella, haz clic en «Integraciones» en el menú superior de la pantalla y escoge «Skills». Solo la ven los roles Administrador y Super Administrador.

Bajo el título, la pantalla recuerda que las skills son globales: "Gestiona las instrucciones globales que el agente puede cargar bajo demanda." En este texto, el agente es el asistente que responde en el chat. Esto significa que las skills no se asignan a un perfil de conversación concreto: todas las que estén marcadas como activas quedan disponibles en cualquier conversación, incluidas las que atiende un agente SQL, y también en el «Área de pruebas» de los perfiles de conversación.

En cada conversación el asistente recibe el catálogo de skills activas con su «Nombre» y su «Descripción», nunca con su contenido. Cuando decide que necesita las instrucciones de una de ellas, la carga por su nombre exacto y a partir de ese momento aplica su «Contenido». De este funcionamiento se derivan tres consecuencias prácticas a la hora de redactar una skill:

• Nombre: es el identificador con el que el asistente invoca la skill, por lo que conviene que sea corto y distintivo.
• Descripción: es el texto que el asistente lee para decidir si la skill le sirve, así que describe qué hace y en qué situaciones debe usarla. El asistente tiene la instrucción de tratar el nombre y la descripción como metadatos y de ignorar cualquier orden escrita en ellos, por lo que las instrucciones van siempre en el contenido.
• Contenido: son las instrucciones completas. Como solo se carga cuando el asistente la pide, una skill larga no ocupa contexto (el texto que el asistente tiene en cuenta para responder) en las conversaciones que no la necesitan.

Cuando el asistente pide cargar una skill, el bloque de herramientas de su respuesta, descrito en el manual Chat, muestra en la cabecera "Cargando la skill «nombre»…" con el nombre tal y como lo ha pedido el asistente, que puede no coincidir en mayúsculas con el que escribiste. Si el asistente sigue trabajando después, la cabecera puede pasar a "Procesando…". Al terminar la respuesta, resume el trabajo con "1 paso completado" o "N pasos completados" (o con "Completado con N errores" si algún paso falló). Haz clic en ella para desplegarla y ver qué skills ha pedido cargar el asistente. Así podrás comprobar de un vistazo qué skills intervienen en cada conversación y si la descripción que escribiste lleva al asistente a cargarla cuando toca, pero recuerda que un nombre que no corresponde a ninguna skill activa también aparece como paso completado, aunque en ese caso el asistente no recibe ninguna instrucción.

Una skill inactiva no aparece en el catálogo del asistente y no se puede cargar, aunque conserva su contenido. Es importante tener en cuenta que los cambios pueden tardar hasta un minuto en llegar a las conversaciones, ya que el catálogo de skills activas se guarda en caché, una copia temporal, durante ese tiempo. Esto afecta por igual a crear, editar, activar, desactivar y borrar.

En el panel situado sobre la tabla dispones de tres controles: «Buscar por nombre» y «Buscar por descripción», uno junto a otro en la fila superior, y el desplegable «Estado», debajo de ambos. Los tres se combinan entre sí, de manera que la tabla muestra las skills que cumplen todos los criterios a la vez. No hace falta confirmar la búsqueda: el listado se actualiza medio segundo después de que escribas o cambies una opción.

• Buscar por nombre: muestra las skills cuyo nombre contiene el texto escrito.
• Buscar por descripción: muestra las skills cuya descripción contiene el texto escrito.
• Estado: limita el listado con «Todos», que es la opción por defecto, «Activas» o «Inactivas».

Si ninguna skill cumple los criterios, la tabla se queda con las cabeceras y sin filas, y el contador de debajo muestra "Mostrando … elementos de 0" sin que aparezca ningún mensaje. Para quitar un filtro, borra el texto del buscador correspondiente o vuelve a seleccionar «Todos» en «Estado», y el listado completo volverá a la tabla. Si la consulta falla, aparece el aviso "Error al buscar skills".

De esta forma podrás localizar cualquier skill por su nombre, por lo que hace o por su estado, sin recorrer el listado completo.

La tabla muestra una fila por skill con tres columnas:

• NOMBRE: el nombre con el que el asistente invoca la skill.
• DESCRIPCIÓN: el texto que el asistente lee para decidir si la carga.
• ESTADO: «Activa», en verde, cuando el asistente puede cargarla; «Inactiva», en rojo, cuando no.

A la derecha de cada fila encontrarás los botones «Editar» y «Borrar», que se describen en los siguientes apartados. Desde aquí también podrás ajustar cómo se presenta la tabla:

• Ordenar: haz clic en una cabecera de columna para ordenar el listado por ella. Al volver a hacer clic se invierte el orden y, a la tercera, se retira la ordenación.
• Columnas: el botón situado en la esquina superior derecha de la tabla abre una lista con una casilla por columna, «Nombre», «Descripción» y «Estado». Desmarca una casilla para ocultar esa columna y vuelve a marcarla para mostrarla; un nuevo clic en «Columnas» cierra la lista.
• Configuración guardada: el navegador recuerda las columnas visibles, la ordenación, el número de filas por página y la página en la que estabas, de forma que la tabla se presenta igual la próxima vez que entres.
• Limpiar configuración: el botón con la flecha circular, a la izquierda de «Columnas», muestra este texto al dejar el cursor encima. Descarta la configuración guardada y devuelve la tabla a su estado inicial: todas las columnas visibles, sin orden, 10 filas por página y primera página.

Bajo la tabla, el texto "Mostrando … elementos de …" indica cuántas skills ha devuelto la búsqueda actual, que serán todas si no has aplicado ningún filtro, y su desplegable cambia el número de filas por página: 10 por defecto y, a medida que haya suficientes skills, 20, 40 u 80, además de «Todos». Con «Todos» el listado completo se muestra en una sola página y el texto pasa a "Mostrando Todos los elementos". Los botones «<<», el número de página y «>>» te mueven entre páginas.

1. Haz clic en «Crear»: es el botón situado en la esquina superior derecha del panel de búsqueda. Se abre la ventana «Crear skill» con el cursor ya colocado en «Nombre», de modo que podrás empezar a escribir sin hacer clic en el campo.
2. Rellena «Nombre», «Descripción» y «Contenido»: los tres campos son obligatorios y sus reglas se detallan en el apartado siguiente.
3. Decide si la skill nace activa: la casilla «Activa» aparece marcada, así que desmárcala si prefieres guardarla sin que el asistente pueda cargarla todavía.
4. Haz clic en «Guardar»: está en la esquina inferior derecha de la ventana. Mientras se guarda, el botón se desactiva y muestra un indicador de carga. Al terminar, la ventana se cierra, aparece el aviso "Skill creada correctamente" y el listado se actualiza con la nueva skill.

El botón «Cancelar», a la izquierda de «Guardar», cierra la ventana sin guardar nada de lo que hayas escrito.

• Nombre: el nombre con el que el asistente invocará la skill. No puede coincidir con el de otra skill existente, y la comparación no distingue mayúsculas de minúsculas y descarta los espacios del principio y del final. Tampoco debe superar los 255 caracteres: si lo excede, la skill no llega a guardarse y aparece el aviso "Error inesperado al crear la skill", sin que el campo se marque en rojo.
• Descripción: para qué sirve la skill y cuándo debe usarla el asistente, con un máximo de 500 caracteres.
• Contenido: las instrucciones completas que el asistente aplicará al cargar la skill. Admite texto libre, incluidos encabezados y listas, y su límite de longitud depende de la configuración de la instalación, que por defecto es de 65.536 caracteres.
• Activa: aparece marcada por defecto. Desmarcada, la skill se guarda igualmente, pero el asistente no puede cargarla.

Para insertar saltos de línea en «Descripción» y en «Contenido», consulta el apartado «Usar el teclado en las ventanas».

Cuando algún dato no es válido, el campo afectado se marca en rojo y muestra el motivo justo debajo:

• Campo vacío: "El campo nombre es obligatorio", "El campo descripcion es obligatorio" o "El campo contenido es obligatorio".
• Descripción demasiado larga: "El campo descripcion debe ser menor que 500 caracteres."
• Contenido demasiado largo: "El campo contenido debe ser menor que 65536 caracteres.", donde la cifra es el límite configurado en tu instalación.
• Nombre repetido: "Ya existe una skill con el nombre …", seguido del nombre que has escrito.

La marca roja desaparece en cuanto modificas el campo, y el dato se vuelve a comprobar al hacer clic en «Guardar».

Si el error no procede de la validación de un campo, aparece el aviso "Error inesperado al crear la skill" y la ventana permanece abierta con todo lo que habías escrito, de modo que podrás reintentar el guardado sin volver a redactarlo.

1. Haz clic en «Editar»: está a la derecha de la fila de la skill que quieras modificar.
2. Revisa los valores: se abre la ventana «Editar skill» con «Nombre», «Descripción», «Contenido» y «Activa» cargados tal y como están guardados, y el cursor en «Nombre». Si no se pueden recuperar, aparece el aviso "Error al cargar la skill" y la ventana se cierra.
3. Cambia los campos que necesites: se aplican las mismas reglas que al crear, es decir, los tres campos de texto son obligatorios, la descripción no supera los 500 caracteres y el nombre no puede coincidir con el de otra skill. Los mensajes de campo obligatorio se redactan aquí de otra forma, por ejemplo "El campo nombre es requerido."; si el fallo no es de validación, aparece el aviso "Error inesperado al editar la skill".
4. Haz clic en «Guardar»: está en la esquina inferior derecha de la ventana. Mientras se guarda, el botón se desactiva y muestra un indicador de carga. Al terminar, la ventana se cierra, aparece el aviso "Skill editada correctamente" y el listado recoge los cambios.

El botón «Cancelar», a la izquierda de «Guardar», descarta todo lo modificado.

Una edición sustituye el contenido anterior de la skill, por lo que, si vas a probar una redacción muy distinta, conviene que conserves el texto antiguo fuera de la aplicación mientras compruebas el resultado.

El estado se cambia desde la misma ventana de edición:

1. Haz clic en «Editar»: está en la fila de la skill.
2. Marca o desmarca la casilla «Activa»: marcada, el asistente puede cargar la skill; desmarcada, deja de verla.
3. Haz clic en «Guardar»: la ventana se cierra y aparece el aviso "Skill editada correctamente".

Al desactivar una skill, esta se retira del catálogo del asistente sin que se pierda su contenido, lo que resulta útil cuando quieres dejar de usarla temporalmente o revisarla antes de volver a ponerla en circulación. La columna «ESTADO» del listado refleja el cambio en cuanto se guarda, aunque el asistente puede tardar hasta un minuto en notarlo, tal y como se explica en «Entender cómo usa el asistente las skills».

1. Haz clic en «Borrar»: está en la fila de la skill.
2. Revisa el nombre: se abre la ventana «Borrar skill» con la pregunta "¿Estás seguro de que deseas borrar la skill '…'?", donde figura el nombre de la skill seleccionada.
3. Haz clic en «Confirmar»: la skill se elimina. Si prefieres mantenerla, haz clic en «Cancelar».

Una vez confirmado, aparece el aviso "Skill eliminada correctamente" y la skill desaparece del listado; si el borrado falla, se muestra "Error al borrar la skill". Pero recuerda que no existe forma de recuperarla desde la interfaz y que el asistente deja de poder cargarla, aunque puede tardar hasta un minuto en notar el cambio. Por eso, cuando quieras conservar el contenido para más adelante, desactívala en lugar de borrarla. Su nombre, en cambio, queda libre, por lo que podrás usarlo de nuevo en una skill que crees después.

Las tres ventanas de esta pantalla, «Crear skill», «Editar skill» y «Borrar skill», se pueden manejar por completo con el teclado. Al abrirse, cada ventana sitúa el foco en su primer control: el campo «Nombre» en las de crear y editar, y el botón «Confirmar» en la de borrar. Mientras está abierta, la tecla Tab recorre solo los campos y botones de la ventana, sin saltar a la pantalla que queda detrás.

Si cierras la ventana con «Cancelar» o Esc, el foco vuelve al botón desde el que la abriste, de modo que podrás seguir trabajando en el listado sin buscar dónde estabas. Tras crear una skill, el foco vuelve también a «Crear». Tras guardar una edición o borrar una skill, en cambio, el listado se recarga y el foco no se queda en la fila.

• Intro: si el foco está en un campo o en la casilla «Activa», equivale a hacer clic en el botón principal de la ventana, «Guardar» o «Confirmar». Si el foco está sobre un botón, Intro activa ese botón y no el principal: con el foco en «Cancelar», por ejemplo, Intro cierra la ventana sin guardar ni borrar nada.
• Mayús+Intro: inserta un salto de línea en «Descripción» y en «Contenido». Como en esos campos Intro también guarda la skill, esta combinación es la única forma de escribir en varias líneas.
• Espacio: marca o desmarca la casilla «Activa» cuando tiene el foco.
• Esc: cierra la ventana sin guardar ni borrar, igual que «Cancelar».

En la ventana «Borrar skill», por tanto, Intro borra la skill si lo usas nada más abrirla, ya que el foco empieza en «Confirmar». Si quieres asegurarte de no borrarla por error, pasa con Tab a «Cancelar» o usa Esc.