Mejoras¶

Artific puede leer a horas fijas las conversaciones recientes de tu organización y sugerir mejoras concretas a tus asistentes y habilidades: un añadido a las instrucciones de un asistente, una habilidad que a menudo no ayuda, un asistente aparte para algo que la gente pregunta una y otra vez al equivocado. Cada propuesta así es una sugerencia; un análisis es una vez en que Artific lee las conversaciones y escribe sugerencias. Un análisis no cambia nada por sí mismo, salvo que tu organización elija que Artific aplique ciertos tipos por sí mismo: el resto espera a una persona que revisa la sugerencia y la acepta.

Esta página es para el administrador que activa y configura los análisis, y para quien puede cambiar un asistente o una habilidad y gestiona las sugerencias sobre él.

Qué significa activarlos¶

Los análisis están desactivados hasta que un administrador los activa. Activarlos es un consentimiento de la organización, y el diálogo ¿Activar los análisis de mejora? dice para qué:

• El modelo de análisis lee las conversaciones de tu organización, con los datos personales sustituidos por marcadores, como <PERSON_1> en lugar de un nombre.
• Cada análisis cuesta llamadas al modelo, hasta un máximo cada vez, y cuentan para el límite mensual de tu organización. Si se alcanza el límite, un análisis omite el resto.
• Si El feedback sobre respuestas cuenta está activado, los pulgares de tus miembros, con sus motivos y comentarios, van incluidos sin nombre (Feedback sobre respuestas).

Artific no muestra en ningún sitio lo que cuesta un análisis en euros. El número de análisis y de llamadas al modelo lo ves solo si tu organización te deja ver los costes (Costes).

Lo que nadie ve¶

Una sugerencia dice en cuántas conversaciones se basa, nunca en cuáles ni de quién. Ninguna pantalla nombra ni enlaza una conversación, una persona o un registro de memoria, y el historial de una sugerencia no dice quién la aceptó o la descartó. Un administrador tampoco lo ve, ni siquiera por la API. En un dato compartido, una sugerencia ni siquiera dice en cuántas personas o registros de memoria se basa.

Quién puede hacer qué¶

Un cambio en un asistente o una habilidad solo lo hace quien puede cambiar ese asistente o esa habilidad: write sobre el tipo no basta por sí solo. Quien tiene write pero no puede cambiar el asistente sí puede descartar la sugerencia. También puedes dar el tipo improvement en un rol propio (Tipos y acciones).

Un administrador de la organización por encima de la tuya ve los ajustes y los análisis, pero no los cambia ni inicia un análisis: activarlos es el consentimiento de tu propia organización, y un análisis le cuesta dinero. Las sugerencias solo las ve en una sesión de soporte que tu organización permita, y en ella solo mira.

Dónde encontrarlo¶

• La lista está en Asistentes de IA › Mejoras, después de Control de calidad, con las pestañas Sugerencias y Análisis. La entrada del menú solo aparece para quien tiene see.
• Los ajustes están en Gestión de la organización › Ajustes, en la sección Mejoras, con el botón Configurar.
• El bloque Sugerencias de mejora está en los ajustes de un asistente, encima del formulario, y en la página de una habilidad, encima de las instrucciones (El bloque).

Si el entorno de tu organización no ofrece mejoras, no ves la entrada del menú ni la sección en los ajustes, y un enlace directo dice Las mejoras no están disponibles aquí. Si las esperas, pregunta a los administradores de la organización por encima de la tuya, o a Artific si no la hay.

Activar y configurar los análisis¶

1. Ve a Gestión de la organización › Ajustes y elige Configurar en la sección Mejoras.
2. Activa Análisis activados y confirma en el diálogo con Activar.
3. Elige cuándo y sobre qué, el modelo de análisis y si el feedback sobre respuestas cuenta (ver abajo).
4. Guarda la página. Todo lo de la página se guarda de una vez.

La sección Mejoras de los ajustes de la organización resume después en una línea cómo está, por ejemplo Activado · Cada noche a las 03:00 · 5 comprobaciones activadas · Artific aún no aplica nada por sí mismo.

Si la organización por encima de la tuya gestiona estos ajustes, arriba aparece Solo lectura y no puedes guardar nada. Pregunta entonces a un administrador de esa organización.

Cuándo y sobre qué¶

• Horario: Cada noche a las 03:00, Cada día laborable a las 03:00, Cada lunes a las 03:00, o Avanzado para tu propio Patrón cron de cinco campos: minuto, hora, día, mes, día de la semana.
• Zona horaria: la zona horaria del horario.
• Periodo: cuántos días atrás lee un análisis, de 1 a 30. Un análisis nunca lee más atrás de lo que tu organización conserva las trazas.

Debajo de los campos se indica cuándo es el próximo análisis.

Modelo de análisis¶

El modelo de análisis lee las conversaciones y escribe las sugerencias. Elige Predeterminado de la instalación para seguir el predeterminado, también cuando cambie, o Elección propia para un modelo de chat del catálogo de tu organización. Arriba se indica qué modelo se usa ahora y por qué.

Artific nunca recurre al modelo de ayuda. Sin modelo de análisis, las comprobaciones dan solo cifras o nada; cada comprobación indica lo que falta entonces.

Feedback sobre respuestas¶

Con El feedback sobre respuestas cuenta en las sugerencias y en la memoria, los pulgares arriba y abajo de tus miembros, con el motivo y el comentario, van sin nombre al modelo de análisis. También activa la comprobación Respuestas valoradas a menudo como negativas, que luego puedes desactivar.

• También vale para la memoria, aunque los análisis estén desactivados: los pulgares ayudan a decidir si una sesión fue bien.
• Vale para toda la organización. No puedes activarlo ni desactivarlo por asistente.
• Si tu organización no recoge feedback sobre respuestas, el interruptor está desactivado y no se puede activar. Activa primero el feedback en Gestión de la organización › Ajustes › Feedback.
• Activar los análisis activa también esto, salvo que lo hayas desactivado tú antes: Artific lo recuerda, también si desactivas los análisis y luego los vuelves a activar.
• Si tu organización fijó ella misma cuándo una respuesta cuenta como buena o mala, Artific deja esas reglas como están y rechaza guardar este interruptor, con el motivo en el mensaje.

Comprobaciones¶

Una comprobación es una cosa que busca un análisis. Cada comprobación tiene un interruptor, dice lo que necesita y lo que hizo la última vez. Lo que necesita se lee tal como está ahora: una etiqueta naranja falta.

Trazas significa que tu organización registra las llamadas al modelo como trazas (Configuración de la organización); sin trazas, un análisis no lee conversaciones y da solo cifras. Un asistente más ligero no prueba nada hasta que haya un límite mensual de pruebas (más abajo).

Un dato que conocen varias personas lee la memoria que cada asistente guarda de las personas que chatean con él. Si la activas, un análisis busca ahí algo sobre tu organización, no sobre una persona: algo que al menos tres personas contaron al mismo asistente, o algo que alguien dijo y que claramente trata de la organización. Un dato con una dirección, un teléfono o un enlace nunca se sugiere. Lo que las personas contaron a asistentes distintos no se suma. Cada lectura es una llamada al modelo que cuenta en el consumo de tu organización. La memoria de un proyecto y la memoria compartida en sí no se leen. Un dato encontrado entra en la memoria compartida cuando alguien lo acepta (más abajo), o por sí solo si lo eliges en Aplicar por sí mismo.

Pruebas de un asistente más ligero¶

Un asistente más ligero prueba un solo cambio a la vez en un asistente: primero menos herramientas, luego un modelo más barato y luego instrucciones más cortas. Lo hace con una prueba: la evaluación propia del asistente se ejecuta dos veces, con la versión actual y con el cambio, con los mismos escenarios y el mismo modelo evaluador. Si la versión más ligera no lo hace peor y es al menos un 10 % más barata o más rápida, recibes una sugerencia.

Debajo de las comprobaciones está el bloque Pruebas de un asistente más ligero. Solo un administrador de la organización lo ajusta; para los demás aparece en gris, con el motivo al lado.

• Límite mensual de pruebas, en euros. Vacío hasta que lo rellenes, y necesario para activar la comprobación. Todas las pruebas juntas nunca cuestan más que esto al mes, dentro del tope mensual de tu organización. Puedes cambiar el límite, pero no quitarlo. Si desactivas la comprobación, el límite se queda.
• Asistentes que se pueden probar. Al principio no hay nada marcado: sin marca no se prueba ningún asistente. Un asistente sin una evaluación de al menos cinco escenarios y un modelo evaluador aparece en gris, con el motivo al lado; crea primero una evaluación así (más abajo).
• Dejar fuera de las pruebas. Bajo cada asistente marcado están sus herramientas, al principio sin marcar. Una herramienta que marcas no se ofrece en ninguna prueba: lo que haría no ocurre. Una herramienta se deja fuera por su nombre: si otro asistente marcado usa una herramienta con el mismo nombre, también queda fuera de sus pruebas. Una herramienta dejada fuera que ya no usa ningún asistente marcado sigue en la lista hasta que la desmarques. Una herramienta que una evaluación ya deja fuera también queda fuera de las pruebas.
• En el último análisis dice con palabras sencillas qué hizo el último análisis con las pruebas: cuántas empezaron y por qué otras no, por ejemplo porque el límite mensual se había agotado.

Una versión simulada suele ser mejor que dejar fuera una herramienta: una herramienta con versión simulada sí se llama en una prueba, pero no ocurre nada real.

Aplicar por sí mismo¶

Para cada tipo de sugerencia eliges hasta dónde llega Artific por sí mismo. Vale para todos los asistentes a la vez.

Puedes elegirlo para Cambiar el asistente, Reescribir la habilidad y Nueva habilidad. Un asistente nuevo siempre es solo una sugerencia: Artific nunca crea un asistente por sí mismo. Para Compartir un dato eliges Solo proponer o Aplicar y publicar: entonces Artific comparte por sí mismo un dato que encuentra, sin que nadie lo lea antes. Ese dato procede de lo que las personas contaron en sus propias conversaciones y llega a todos en la organización; lo cambias o eliminas en Memoria compartida como cualquier nota. Solo un administrador, que puede cambiar los ajustes de la organización, lo activa o lo desactiva. Los demás tipos, como una conexión o retirar una habilidad, siempre esperan a una persona.

Con Aplicar y publicar para un asistente, ten en cuenta dos cosas. Si Artific añade una herramienta que Artific rechazaría al guardar, eso no se puede deshacer después, solo avisar: quita entonces tú la herramienta en los ajustes del asistente. Y una herramienta recién añadida a veces no funciona bien hasta pasada una hora, cuando Artific ha puesto su descripción en las instrucciones.

Si Artific no pudo aplicar una sugerencia por sí mismo, por ejemplo porque aún contiene un marcador o una regla de tu organización no lo permite, sigue abierta y la página de la sugerencia dice por qué. Un borrador que dirige las conversaciones de otra forma que el asistente publicado solo lo publica un administrador, en la página del asistente en la consola de Artific.

Quién se entera cuando Artific cambia algo por sí mismo¶

Elige quién recibe un aviso cuando Artific publica algo por sí mismo: Quien puede editarlo (los editores del asistente o la habilidad que cambió, activado por defecto), Administradores y los Grupos que elijas, en cualquier combinación. Si no marcas nada, nadie recibe un aviso; solo queda la marca en la lista. Cuando algo no tiene editores propios, como un dato compartido, se enteran los administradores en lugar de los editores.

Cada persona elige cómo se entera, en Mis avisos. Solo cambias este bloque si puedes cambiar los ajustes de la organización; los demás solo lo ven.

El mes pasado¶

Quien puede ver los costes en tu organización ve cuántos análisis hubo el mes pasado y cuántas llamadas al modelo hicieron. Los demás no ven esta sección.

Las sugerencias¶

La pestaña Sugerencias muestra las sugerencias de la organización, por defecto las que tienen el estado Abierta. Filtra por Estado, Comprobación y Sobre (un tipo, como Asistente o Habilidad, o un asistente o una habilidad por su nombre). Cada fila muestra el tipo de sugerencia, el título que escribió el modelo de análisis, sobre qué es, la comprobación, el estado y cuándo se vio por última vez. Cargar más abajo carga las siguientes sugerencias.

Una sugerencia marcada Solo cifras, sin cambio propuesto señala algo que el modelo no pudo desarrollar, por ejemplo porque no había modelo de análisis. Puedes leerla y gestionarla, pero no hay nada que aplicar.

Si los análisis están desactivados, la lista dice Los análisis de mejora están desactivados, con Ir a los ajustes para quien puede activarlos. Mientras se ejecuta un análisis, la parte superior de la lista lo indica, y las nuevas sugerencias aparecen solas en cuanto termina.

Ver una sugerencia¶

Una sugerencia muestra:

• Hallazgo: el título, el resumen y la Explicación, tal como los escribió el modelo de análisis. Este texto no se traduce; está en el idioma en que escribió el modelo.
• Antes y después: lo que cambia al aceptar, con la versión actual junto a la nueva. El texto añadido aparece en verde, el texto quitado en rojo y tachado, y las herramientas y habilidades como etiquetas. La sección que una herramienta pone por sí misma en las instrucciones aparece con línea discontinua, como Sección de la herramienta … · gestionada por Artific.
• Sobre, Comprobación, Basado en (el número de conversaciones), Visto por última vez, las Cifras que encontró la comprobación, el Historial (cada paso solo con una fecha) y la Nota, si alguien escribió una.

Las llamadas y los tokens que una sugerencia ahorraría al mes solo se muestran si tu organización te deja ver los costes.

Gestionar una sugerencia¶

Lo que hace Aceptar depende del tipo de sugerencia; la propia sugerencia lo dice.

• Descartar abre Descartar sugerencia, con una Nota opcional de como mucho 1.000 caracteres. La sugerencia no vuelve durante un tiempo, salvo que el problema se duplique en ese tiempo.
• Reabrir vuelve a abrir una sugerencia descartada. Si un análisis posterior volvió a encontrar lo mismo, no es posible, y Hay una sugerencia más reciente te dice que reabras esa.
• Si puedes leer la sugerencia pero no cambiar el asistente o la habilidad, la parte superior de la sugerencia lo indica y no puedes aceptar. Pregunta a un editor del asistente o a un administrador.

Cambiar un asistente¶

Encima del cambio aparece Aceptar guarda la versión … de …, a tu nombre. Después de aceptar, todos los que chatean con el asistente chatean al instante con la nueva versión. La versión anterior sigue en Versiones; siempre puedes volver.

Ajustar abre el texto que añade la sugerencia, o con instrucciones (sustituidas) todo el texto nuevo, para que puedas cambiarlo primero. Lo que cambies entra en la nueva versión; la propia sugerencia guarda el texto original. Volver a la sugerencia deshace tu cambio.

Aceptar no es posible en estos casos, y la sugerencia dice por qué:

• Marcadores. El modelo de análisis leyó las conversaciones con los datos personales sustituidos, así que el texto propuesto puede contener un marcador como <PERSON_1>. Sustituye cada marcador con Ajustar; Siguiente marcador te lleva al siguiente. Después puedes aceptar.
• El asistente tiene ya una versión más reciente. La sugerencia trata de una versión anterior. El próximo análisis actualiza la sugerencia; también puedes cambiar el asistente tú mismo.
• Otra persona acaba de guardar el asistente. Vuelve a leer el antes y después y acepta. Tus ajustes se conservan.
• Se rechaza la nueva versión, por ejemplo porque una herramienta propuesta no se puede dar al asistente. El motivo aparece encima de la sugerencia y tus ajustes se conservan.

Si el texto propuesto repite la sección de una herramienta, el párrafo aparece en naranja con un aviso: Artific vuelve a poner esa sección al guardar, así que el texto aparecería dos veces. Quítalo con Ajustar, o déjalo si es intencionado.

Reescribir o crear una habilidad¶

Con Reescribir la habilidad, la sugerencia dice cuántos asistentes reciben la nueva versión al instante, porque siguen la versión más reciente, y cuántos han fijado una versión y la conservan. Una Nueva habilidad no cambia nada hasta que un asistente la carga.

Puedes ajustar el texto primero. Mantén en la cabecera de la habilidad exactamente una línea con su nombre, en letras minúsculas, cifras y guiones; si no, Artific rechaza la versión. Necesitas el derecho de cambiar una habilidad con ese nombre.

Si la publicación falla, la versión sí se ha escrito, pero la sugerencia está Aplicada con Aún no activa, y la versión anterior sigue funcionando. Elige Reintentar o Publicar para intentarlo de nuevo.

Una habilidad que viene de una publicación es Una copia compartida: solo la publicación la cambia. Una sugerencia así solo puedes descartarla.

Crear un nuevo asistente¶

Crear asistente abre el formulario de un nuevo asistente, con el nombre, la descripción y las instrucciones propuestos ya rellenados. El asistente del que vino la sugerencia se queda como está. El nuevo asistente empieza sin herramientas y sin usuarios; tú eliges quién puede usarlo. En cuanto lo guardas, la sugerencia queda Aplicada.

Si este último paso falla, un mensaje dice que el asistente se creó pero la sugerencia no se pudo marcar como aplicada. El asistente se queda.

Un control de calidad a partir de conversaciones¶

Una evaluación a partir de conversaciones reales redacta escenarios a partir de conversaciones que salieron bien, con los detalles inventados. La sugerencia muestra cada escenario tal como se guardará: el título, los pasos y sus comprobaciones. Un escenario que aquí no se puede guardar, por ejemplo con una comprobación que el formulario no conoce, aparece con el motivo y no se incluye. Si no se puede guardar ningún escenario, Aceptar aparece en gris.

• Nueva evaluación: Crear evaluación abre la pestaña Control de calidad del asistente con el formulario de un nuevo control de calidad, con el nombre y el modelo evaluador propuestos ya rellenados. Si el análisis no encontró un modelo evaluador adecuado, un aviso dice que tienes que elegir uno; no se elige ninguno por ti. En cuanto guardas el control de calidad, con sus escenarios, la sugerencia pasa a Aplicada. Si ese último paso falla, el control de calidad se queda y un mensaje lo dice.
• Añadir escenarios: la sugerencia nombra el control de calidad y cuántos escenarios tiene ahora. Aceptar añade los escenarios al final, a tu nombre. Si el control de calidad recibió una nueva versión mientras tanto, ya no se puede aceptar y descartas la sugerencia.

Aceptar requiere el derecho a cambiar controles de calidad y un asistente que puedas ver; no hace falta el derecho a cambiar el propio asistente. No empieza ninguna ejecución: la empiezas tú.

Compartir un dato¶

La sugerencia muestra el dato tal como lo dirá la nota, y si es un Dato o una Regla. De quién viene, o cuántas personas lo dijeron, no aparece. Aceptar abre Compartir dato: ajusta el texto si hace falta y elige en Quién recibe esta nota Todos en la organización, ya elegido, o los miembros de uno o más grupos. Tras Compartir, el dato es una nota en Memoria compartida, donde lo cambias o eliminas como cualquier otra nota, y cada asistente puede consultarlo para quien lo recibe.

Aceptar requiere el mismo derecho que escribir una nota en la memoria compartida: cambiar asistentes para toda la organización. El derecho sobre las mejoras por sí solo no basta. Sin una persona, un dato solo se comparte si tu organización lo elige en Aplicar por sí mismo.

Publicar un asistente más ligero¶

Una sugerencia Asistente más ligero muestra las dos mediciones de la prueba una al lado de la otra: Ahora y Más ligero, cada una con su puntuación, su puntuación media y su tiempo medio de respuesta, y el coste de cada medición si tu organización muestra los costes (Quién ve el consumo y los costes). Debajo: con cuántos escenarios se midió, en cuántos turnos de conversación al mes se basa el ahorro, el ahorro mensual estimado si tu organización muestra los costes, y qué cambia: el modelo, las herramientas que se quitan o las instrucciones más cortas. Lo que una prueba no muestra aparece en inglés, tal como está escrito: una prueba solo mide los escenarios de esa evaluación, una vez por cada lado.

• Publicar la versión … publica al momento la versión medida como última versión: cada conversación la usa enseguida. Después, Artific completa el asistente como con cualquier versión guardada. Puede hacerlo quien puede editar el asistente.
• Descartar desecha la versión medida; el asistente se queda como está.
• No puedes editar el texto: se publica lo que se midió. Si el asistente recibió entretanto una nueva versión, ya no es posible; un análisis posterior lo vuelve a intentar.

Conectores y retirar habilidades¶

Encargar un conector describe lo que debe hacer un conector. Artific no puede crear ese conector: da la descripción a quien construye vuestros conectores, como conector o en la AI Toolbox. Con Retirar la habilidad, Ir a la habilidad te lleva a la habilidad; si te parece innecesaria, elimínala allí. Después marca la sugerencia con Marcar como hecho.

El bloque en un asistente o una habilidad¶

Quien puede cambiar un asistente o una habilidad ve en el bloque Sugerencias de mejora las sugerencias abiertas sobre él, cada una con Ver. Si no hay ninguna, no hay bloque. Si los análisis están desactivados, hay una línea, con Configurar para quien puede cambiar los ajustes.

Si el formulario tiene cambios sin guardar, Ver en una pestaña nueva abre la sugerencia aparte. Guarda primero antes de aceptar; si no, la sugerencia escribe una versión sin tus cambios. Si alguien acepta una sugerencia mientras tanto, el formulario dice al guardar No se guardó: ahora hay una versión … y que esa versión vino de una sugerencia de mejora. Tu texto se queda en el formulario; mira la nueva versión y vuelve a guardar.

Análisis¶

La pestaña Análisis muestra cada análisis, el más reciente primero: cuándo empezó, Cómo (Según la programación o Manualmente, nunca por quién), el estado, el Periodo leído y cuántas Sugerencias escribió. Las Llamadas al modelo solo las ve quien puede ver los costes en tu organización.

Una fila abre el análisis, con lo que hizo cada comprobación:

Analizar ahora, arriba a la derecha en ambas pestañas, inicia un análisis al momento. Solo puede usarlo quien puede cambiar los ajustes, porque cada análisis cuesta dinero, y no mientras los análisis estén desactivados o ya haya uno en marcha.

Qué se registra¶

El registro de auditoría contiene, a nombre de quien actuó:

Un texto o una nota nunca aparecen. Cambiar un asistente escribe además el habitual assistant.changed; compartir un dato aparece una vez, con quién lo recibe. Un análisis que inicia el horario no aparece en el registro de auditoría; lo encuentras en la pestaña Análisis.

Por la API¶

Las rutas están en /api/v1/organisations/{id}/improvements:

• GET y PATCH …/settings leen y cambian los ajustes. Si el entorno no ofrece mejoras, la lectura dice available: false y cualquier otra ruta responde 409 improvements-not-available.
• POST …/runs inicia un análisis (202), o responde 409 analyses-off o run-in-progress. GET …/runs lista los análisis.
• GET …/suggestions lista las sugerencias, filtrables por status, check, target_kind y target_id. PATCH …/suggestions/{suggestion_id} acepta, descarta, reabre o marca como hecho, con una nota de como mucho 1.000 caracteres.
• POST …/suggestions/{suggestion_id}/apply hace el cambio, opcionalmente con tu texto ajustado, y para un dato compartido toma audience: everyone o los ids de grupos; POST …/publish vuelve a publicar una habilidad o un borrador que Artific escribió por sí mismo, y GET …/draft lee ese borrador. PATCH …/settings también acepta apply_level por tipo, y trials con limit_eur y assistants. Un rechazo dice por qué, entre otros suggestion-placeholders, suggestion-target-moved, suggestion-not-yet y newer-suggestion.