{
 "schema": "aiblocks-page/1",
 "id": "agency-engineering-knowledge-graph-engineer",
 "type": "agent",
 "name": "Knowledge graph engineer",
 "summary": "Turn your documents into a knowledge graph design with linked facts, source tracking and test queries. Bring your files and your questions.",
 "headline": "Knowledge graph engineer",
 "subhead": "Give it sample documents and the questions you want answered. It designs a knowledge graph, a map of things and how they link, with every fact tied to the file it came from. You get the types of things, the links, starter Neo4j queries and checks.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "Three to five sample documents, pasted or attached",
  "The questions the graph must answer, such as \"which services depend on billing?\"",
  "The kinds of things to track, such as people, products or contracts (optional)",
  "The database you plan to use, such as Neo4j (optional)",
  "Any two documents you know disagree (optional)"
 ],
 "you_get": [
  "A list of entity types and relationship types, each with a short meaning",
  "A rule that links every fact to its source document",
  "Rules for conflicts, and for facts that have only one source",
  "Starter queries for your questions, written for Neo4j and marked untested",
  "Health checks to run after you load data, and a check for source changes",
  "A list of assumptions and missing facts"
 ],
 "use_when": [
  "Your AI answers from many documents but can't say which file a claim came from.",
  "Two documents disagree and nobody tracks which one is right.",
  "You plan to use Neo4j and want the design before you load any data.",
  "A source file changed and you need to know which facts it touches."
 ],
 "skip_when": [
  "You only want a table layout for an app. Use the Backend Architect agent.",
  "You want an AI to answer questions from documents by search, with no graph. Use the RAG pipeline implementation planner.",
  "Your data is messy and needs cleaning first. Use the AI data repair engineer."
 ],
 "output_sample": {
  "input": [
   "Three to five sample documents, or a description of them",
   "The questions your graph must answer",
   "The kinds of things to track, such as services, people or contracts (optional)",
   "The database you plan to use, such as Neo4j (optional)"
  ],
  "prerequisites": [
   "An AI that can read pasted text or files, such as Claude, ChatGPT or Gemini",
   "A Neo4j database, only if you want to run the draft queries (optional)"
  ],
  "output": [
   {
    "name": "Entity types",
    "contains": "Each kind of thing in your documents, what counts as one, and an example."
   },
   {
    "name": "Relationship types",
    "contains": "Each link between things, its direction, its meaning and how clearly the text must state it."
   },
   {
    "name": "Source and conflict rules",
    "contains": "How each fact points to its source, how disagreements are kept, and when a one-source fact is held back."
   },
   {
    "name": "Starter queries",
    "contains": "Draft Cypher for each of your questions, with the sources each answer must cite."
   },
   {
    "name": "Health checks",
    "contains": "Checks for broken links, facts with no source and flags that don't match."
   },
   {
    "name": "Change check",
    "contains": "How to find the facts to re-check when a source file changes."
   },
   {
    "name": "Assumptions and gaps",
    "contains": "What was assumed, what is MISSING and which queries were not run."
   }
  ]
 },
 "output_shape": "GOAL AND SCOPE\n  Questions the graph answers: <list> | In scope: <list> | Out of scope: <list>\n\nENTITY TYPES\n  <type> | <what counts as one> | <example from your documents>\n\nRELATIONSHIP TYPES\n  <from type> -[<link>]-> <to type> | <meaning> | <how clearly the text must say it>\n\nSOURCE RULES\n  <document title> | <path or link> | <date> | <hash or version, if known>\n\nCONFLICT AND REVIEW RULES\n  One-source facts held until <number> sources agree\n  Conflicts kept as <claim A and source> against <claim B and source>\n\nSTARTER QUERIES\n  <question> | <draft Cypher> | <sources the answer must cite>\n\nHEALTH CHECKS\n  <check> | <how to run it> | <what to do if it fails>\n\nCHANGE CHECK\n  If <source> changes: re-check <things within N links> | <how to mark them> | <how to clear them>\n\nASSUMPTIONS AND GAPS\n  MISSING: <what> | Not run: <what>",
 "how_to_use": [
  "Download the pack and add it to your AI as a skill. Or open a new chat and paste SKILL.md, then references/source-agent.md.",
  "Paste three to five sample documents, or attach them. Add the questions you want the graph to answer.",
  "Say if you use Neo4j. If you don't, ask for the design and plain-language queries only.",
  "Read \"Assumptions and gaps\" first. Rename any type that doesn't match how your team talks.",
  "Copy the draft queries into Neo4j and try them on a small test set. Your chat AI can't run them for you.",
  "When you add more documents, paste them with the earlier design and ask for a conflict and change check."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "RAG pipeline implementation planner",
   "url": "https://useaiblocks.com/skills/agency-engineering-rag-pipeline-engineer",
   "why": "Build it"
  },
  {
   "name": "Backend architect agent",
   "url": "https://useaiblocks.com/skills/agency-engineering-backend-architect",
   "why": "Build it"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-knowledge-graph-engineer.md",
  "licence": "MIT",
  "original_name": "Knowledge Graph Engineer",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Knowledge Graph Engineer",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-knowledge-graph-engineer.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions. On 2026-10-28 we matched the SKILL.md input note to the sample documents and questions this agent takes."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-engineering-knowledge-graph-engineer",
  "markdown": "https://useaiblocks.com/agents/agency-engineering-knowledge-graph-engineer.md",
  "json": "https://useaiblocks.com/agents/agency-engineering-knowledge-graph-engineer.json",
  "instructions": "https://useaiblocks.com/skills/agency-engineering-knowledge-graph-engineer/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-engineering-knowledge-graph-engineer.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-engineering-knowledge-graph-engineer",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-engineering-knowledge-graph-engineer",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
