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
.jsonfile, up to 80 MB, with a top-levelnodesobject keyed by category and a top-leveledgesarray. Give every node anid. See Graph package.To attach a graph to an agent, have the Developer, Account Admin or Org Admin role.
Upload a graph
Open Control Center → Govern → Govern Graph.
Select Upload Govern Graph.
Enter a Graph name, for example
CCU Govern Graph.Add the Graph package file.
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.
In the upload dialog, select Use your own Neo4j (Dev Only).
Enter the Connection URL, Username and Password. Enter a Database, or leave it empty to use the server's default database.
Select Test connection to check the details before the build.
Select Save.
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
Open the
â‹®menu on the graph's row.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
Open the
â‹®menu on the graph's row.Select Upload new version.
Drag a
.jsonfile onto the dashed area, or select the area to choose one.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
Open the
â‹®menu on the graph's row.Select Version history.
Find the version to restore. Select View graph to look at it first.
Select Restore.
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
Open the
â‹®menu on the graph's row.Select Edit.
Change the Graph Name.
Select Save.
Renaming changes only the name. It doesn't change the package, the nodes or the versions.
Edit a node
Open the graph, and then open Graph Explorer.
Select the node. Use Search nodes to find it by name.
Select Edit node, the pencil in the panel.
Change the properties. Name is required, Features takes one item per line, and Confidence Score takes a number. The ID can't be changed.
Select Save, or Cancel to discard your changes.
For which values you can edit, see Node editing.
Ask a graph a question
Open the graph, and then open Ask the Agent.
Choose a version in the select.
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
Open the graph, and then open About Graph.
Select Graph Summary or Traversal Guidelines.
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.
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
In Agent Builder, select + Add Knowledge on the canvas.
In Use Existing Knowledge, select the graph.
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?

