Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Upload and manage a govern graph

Upload a graph package, add and restore versions, rename a graph, edit a node, and attach the graph to an agent.

Load an institution's knowledge graph into Qore, keep it current with new versions, and make it available to agents. Each task below stands on its own.

Before you begin

  • Have a role that can manage govern graphs: Governance Manager, Account Admin or Org Admin. These roles have the Ingest source & extract knowledge graph candidates capability. See Roles.

  • Prepare a graph package: one .json file, up to 80 MB, with a top-level nodes object keyed by category and a top-level edges array. Give every node an id. See Graph package.

  • To attach a graph to an agent, have the Developer, Account Admin or Org Admin role.

Upload a graph

  1. Open Control Center → Govern → Govern Graph.

  2. Select Upload Govern Graph.

  3. Enter a Graph name, for example CCU Govern Graph.

  4. Add the Graph package file.

  5. Select Upload.

The package is validated, then written into the graph. While it builds, the row shows Processing and the current stage: Queued, Validating the package, Writing nodes, then Writing relationships. The row ends as Completed or Failed. If it fails, the Failed badge gives the reason. See Troubleshoot govern graphs.

Build a graph in your own Neo4j

Use this option in a development environment only.

  1. In the upload dialog, select Use your own Neo4j (Dev Only).

  2. Enter the Connection URL, Username and Password. Enter a Database, or leave it empty to use the server's default database.

  3. Select Test connection to check the details before the build.

  4. Select Save.

  5. Select Upload.

The graph is built in your server instead of the platform's. Saving doesn't connect, so a wrong address, password or database appears as an error when the graph is built. Have the user ready with write access and permission to create constraints and indexes. On Neo4j Aura, the address and credentials are in the instance details and the credentials file. For the field details, see Own Neo4j settings.

Retry a failed build

  1. Open the â‹® menu on the graph's row.

  2. Select Retry.

Retry shows only when a retry is possible. The build uses the package already uploaded. A failed build retries on its own first, and the row says when automatic retries are used up.

Upload a new version

  1. Open the â‹® menu on the graph's row.

  2. Select Upload new version.

  3. Drag a .json file onto the dashed area, or select the area to choose one.

  4. Select Upload.

The new package becomes the next version of the same graph. It's validated and built the same way as a first upload. Agents keep reading the current version until the new one finishes building, and then switch. If the build fails, nothing changes for agents.

Restore an earlier version

  1. Open the â‹® menu on the graph's row.

  2. Select Version history.

  3. Find the version to restore. Select View graph to look at it first.

  4. Select Restore.

  5. Confirm in the Restore version N? dialog.

Agents read the restored version right away. Nothing is rebuilt, and the later versions are kept. The restore is recorded as a new version.

Rename a graph

  1. Open the â‹® menu on the graph's row.

  2. Select Edit.

  3. Change the Graph Name.

  4. Select Save.

Renaming changes only the name. It doesn't change the package, the nodes or the versions.

Edit a node

  1. Open the graph, and then open Graph Explorer.

  2. Select the node. Use Search nodes to find it by name.

  3. Select Edit node, the pencil in the panel.

  4. Change the properties. Name is required, Features takes one item per line, and Confidence Score takes a number. The ID can't be changed.

  5. Select Save, or Cancel to discard your changes.

For which values you can edit, see Node editing.

Ask a graph a question

  1. Open the graph, and then open Ask the Agent.

  2. Choose a version in the select.

  3. Type a question, or select one of the starter questions and send it.

The answer is what an agent would give, grounded in the graph. A Graph Query chip appears when the platform ran a graph query to produce it.

Regenerate or edit the graph guides

  1. Open the graph, and then open About Graph.

  2. Select Graph Summary or Traversal Guidelines.

  3. Select Generate when the tab has no text yet. Otherwise change the text in the editor, or select Regenerate to have the platform write a new one.

  4. Select Save to keep your version.

Each save or regeneration is stored as a new version of the guide for that graph version. Agents use the guides when they query the graph.

Attach a graph to an agent

  1. In Agent Builder, select + Add Knowledge on the canvas.

  2. In Use Existing Knowledge, select the graph.

  3. Select Add.

The agent queries the graph with Knowledge Graph Search. You can't create or attach a graph by attaching the package JSON in the Agent Builder chat. Upload it first. See Attaching a govern graph.

What's next

Last updated

Was this helpful?