> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# knowledge_graph

> Files used to build a structured knowledge graph for the agent.

# `knowledge_graph` — Knowledge graph

Files used to build a structured knowledge graph for the agent.

**Section key** `knowledge_graph` · **Shape** object · **Tier** All plans\
**Edit in the dashboard:** [Knowledge page](/sidebar-menu/knowledge)

## Fields

| Field   | Required | Type            | Allowed values / constraints | Default | Description                                                |
| ------- | -------- | --------------- | ---------------------------- | ------- | ---------------------------------------------------------- |
| `files` | no       | array of object | —                            | —       | List of uploaded knowledge-graph files. Item fields below. |

### `files` items

List of uploaded knowledge-graph files.

| Field               | Required | Type    | Allowed values / constraints           | Default | Description                                                                                                                                   |
| ------------------- | -------- | ------- | -------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `filename`          | **yes**  | string  | —                                      | —       | Original upload filename.                                                                                                                     |
| `stored_name`       | **yes**  | string  | —                                      | —       | Canonical name assigned to the processed file (always .json).                                                                                 |
| `triple_count`      | **yes**  | integer | —                                      | —       | Number of triples (edges) in the graph.                                                                                                       |
| `node_count`        | no       | integer | —                                      | —       | Number of nodes with metadata (label/description). Optional; absent for edges-only files.                                                     |
| `size_bytes`        | **yes**  | integer | —                                      | —       | File size in bytes.                                                                                                                           |
| `uploaded_at`       | **yes**  | string  | —                                      | —       | ISO 8601 upload timestamp.                                                                                                                    |
| `source`            | no       | enum    | one of `json`, `csv_zip`, `text`       | —       | Input adapter that produced this file.                                                                                                        |
| `status`            | no       | enum    | one of `ready`, `extracting`, `failed` | —       | Processing status. 'extracting' = the file is still being processed (text source only); 'failed' = processing errored.                        |
| `error`             | no       | string  | —                                      | —       | Failure detail when status==='failed'.                                                                                                        |
| `source_path`       | no       | string  | —                                      | —       | Identifier linking an auto-extracted graph back to the internal document it was extracted from. Absent for directly-uploaded graphs.          |
| `retrieval_enabled` | no       | boolean | —                                      | —       | Owner toggle. When false, this graph is excluded from search (the knowledge\_graph\_query tool skips it). Absent/true = considered in search. |