All versions of this manual
X
 

Plugins: Query AI

What is Query AI?

Query AI is a Linkurious Enterprise plugin that allows analysts to query the graph using natural language.

Example:

User: Show me bank accounts owned by more than one person

Query AI: MATCH (p:PERSON)-[r:HAS_BANK_ACCOUNT]->(b:BANK_ACCOUNT) WITH b, COUNT(p) AS personCount WHERE personCount > 1 RETURN b

The feature is currently available for Neo4j and Memgraph.

Installing Query AI

The Query AI plugin is installed and enabled by default.

To set up the plugin, you must be logged in as an administrator in Linkurious Enterprise and follow the steps below to configure the LLM model and create a custom action for users to access the plugin.

Configure the LLM model

To set up the LLM model:

  • Open your Linkurious Enterprise instance and access this URL /plugins/query-ai/
  • Click "Edit Query AI Configuration" (note: this button is only available for administrators)
  • Select a vendor (e.g., "OpenAI")
  • Select a model (e.g., "gpt-o4")
  • Set your API key (if you don't have one yet, we recommend getting one from OpenAI)
  • Save the changes

screenshot of the settings page

Enable users to open the plugin

To configure a custom actions that allows users to open the plugin:

  • Open a visualization
  • Open the main menu and select "Manage custom actions"
  • Click "New custom action" and use the following input:
    • Name: "Open Query AI"
    • URL template: {{baseUrl}}plugins/query-ai/?sourceKey={{sourceKey}}#linkurious-modal
    • Sharing: "Share with all users"
  • Save the new custom action

screenshot of the custom action creation

Privacy and security considerations

Only administrators can edit the plugin's configuration, which includes seeing and changing the following values: LLM vendor, LLM model, LLM API key, and system prompt.

The plugin never shares your graph data (i.e., the content of individual nodes or edges) with the LLM. The plugin only shares your graph schema (i.e., the list of node-categories, edge-types, and associated property names) with the LLM, in order to generate valid queries for your graph.

When running a graph query in the Query AI plugin, the same security mechanism is used as for running a query in the rest of Linkurious Enterprise, and the access-rights of the current user are applied. There is nothing that can be done using this plugin that cannot be done manually by the current user using the regular query interface:

  • If the current user is not allowed to run graph queries, they cannot run queries in the plugin
  • If the current user cannot access some specific node-categories or edge-types, they cannot see them using the plugin either