Saltearse al contenido

Cassandra Chat Memory

Cassandra Chat Memory guarda el historial de mensajes de una conversación en una tabla de una base de datos Apache Cassandra de tu empresa y lo recupera cuando hace falta. Así, los componentes que responden preguntas tienen en cuenta lo que se dijo antes y el historial queda en tu base de datos.

Cada historial se identifica por un Session ID: los mensajes con el mismo identificador forman una misma conversación.

Cuándo usarlo

  • Tu empresa ya trabaja con Cassandra y quiere guardar allí el historial de sus asistentes.
  • Esperas un gran volumen de conversaciones y tu equipo de sistemas prefiere Cassandra para ello.
  • Tu política de datos exige que el historial quede en una base de datos propia.

Configuración

Antes de empezar necesitas una base de datos Cassandra accesible desde NappAI y una credencial del servicio Cassandra DB con el identificador de la base de datos (o las direcciones de los nodos del clúster), el usuario y la contraseña o token. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial del servicio Cassandra DB. Elige una con Seleccionar una credencial o crea una nueva con Crear nueva credencial.
Keyspace (obligatorio)El keyspace de Cassandra (el espacio que agrupa las tablas) donde está la tabla del historial.
Table Name (obligatorio)El nombre de la tabla donde se guardan los mensajes.

Opciones avanzadas

CampoQué hace
Session IDEl identificador del historial. Escríbelo o conéctalo, por ejemplo al número de cliente. Las conversaciones con el mismo Session ID comparten historial.
Cluster argumentsOpcional. Ajustes adicionales de conexión al clúster, como pares de nombre y valor. Rellénalo solo si tu equipo de sistemas te lo indica.

Resultado

Memory es el historial de la conversación. Conéctalo a la entrada External Memory de Retrieval QA History, que lee el historial antes de responder y guarda en él cada pregunta y su respuesta, o de Chat Memory, que lee los mensajes guardados para usarlos en otro punto del flujo. Si lo conectas a Chat Memory, se usa el Session ID de Chat Memory.

No se conecta a la entrada Memory de los agentes. Para que un agente recuerde la conversación, activa Use memory en el agente.

Ejemplo

Telecom Rivera atiende con un asistente las dudas de sus clientes sobre tarifas:

  1. Crea una credencial Cassandra DB con los datos de conexión que te facilite el equipo de sistemas.
  2. Añade Cassandra Chat Memory, elige esa credencial y escribe atencion en Keyspace y historial_chat en Table Name.
  3. En Session ID, conecta el número de línea del cliente.
  4. Conecta Memory a la entrada External Memory de Retrieval QA History.

Cada pregunta y respuesta queda en la base de datos de Telecom Rivera, y el asistente sigue el hilo cuando el cliente pregunta “¿y con fibra incluida?”.

Buenas prácticas

  • Usa un Session ID distinto por cliente o por caso para que los historiales no se mezclen.

Componentes relacionados