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

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.