Neo4j CypherQAChain

Neo4j CypherQAChain responde preguntas sobre la información guardada en una base de datos de grafos Neo4j, donde los datos se organizan como elementos y relaciones entre ellos (clientes que compran productos, empleados que pertenecen a equipos, piezas que forman parte de una máquina). Escribes la pregunta con palabras normales, un modelo de IA la traduce a una consulta para Neo4j, el componente la ejecuta y te devuelve la respuesta.

Úsalo cuando tu información esté en Neo4j y quieras consultarla sin escribir consultas a mano.

Cuándo usarlo

Preguntar “¿qué proveedores suministran piezas a más de tres fábricas?” sobre el grafo de tu cadena de suministro.
Consultar qué clientes han comprado los mismos productos que un cliente concreto, para preparar recomendaciones.
Averiguar a quién reporta un empleado y qué proyectos comparte con su equipo, a partir del organigrama guardado en Neo4j.

Configuración

Antes de empezar necesitas una base de datos Neo4j accesible desde NappAI y una credencial del servicio Neo4j API con su dirección, su usuario y su contraseña. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial del servicio Neo4j API. Elige una con Seleccionar una credencial o crea una nueva con Crear nueva credencial.
Query (obligatorio)	La pregunta, escrita con palabras normales. Puedes escribirla o conectarla, por ejemplo, a un Chat Input.
Neo4j Database (obligatorio)	El nombre de la base de datos de Neo4j que quieres consultar.
Limit the number of results	El número máximo de resultados que se recuperan de la base de datos. Por defecto: 10.

Conexión	Qué conectar
Model (obligatorio)	Un componente de modelo de IA, por ejemplo OpenAI.

Resultado

Text: la respuesta redactada por el modelo a partir de lo que ha encontrado en la base de datos. Conéctala a un Chat Output o a cualquier entrada de texto.
Data: los resultados de la consulta tal como salen de la base de datos, un elemento por resultado, sin redactar. Conéctalos a componentes que trabajen con datos, por ejemplo para guardarlos o filtrarlos.

Ejemplo

Recambios Fresno guarda en Neo4j qué piezas usa cada modelo de máquina y qué proveedor las sirve:

Crea una credencial Neo4j API con los datos de acceso de su base de datos.
Añade Neo4j CypherQAChain, elige esa credencial y escribe recambios en Neo4j Database.
Conecta un Chat Input a Query, un modelo a Model y Text a un Chat Output.

Cuando el equipo de compras pregunta “¿qué proveedores sirven piezas para la máquina M-40?”, el chat responde con la lista de proveedores sacada del grafo.

Buenas prácticas

Usa nombres claros para los tipos de elementos y relaciones de tu grafo: el modelo los usa para entender qué consultar.
Usa un usuario de Neo4j con permisos solo de lectura.