In AI brokers, a context graph is the a part of agent reminiscence that captures choices.
This put up explains why AI brokers have to seize choices, how context graphs seize them, how brokers use them, and the way brokers improve their capabilities and efficiency with them.
An agent failure case
It is the final week of the quarter. A renewal agent is working a $480k account. The shopper needs 20% off or they stroll. The agent’s directions state >$100k accounts mustn’t churn, however the agent’s coverage caps renewals at 10%. Now what?
If a human was dealing with this, they’re going to most likely use expertise and reminiscence to resolve.
Did not we do that actual factor with Globex final quarter? It was the same story. They have been threatening to churn, and somebody signed off on 20% as a result of the CEO needed to retain Fortune 500 logos and the danger was value taking up a $300k account. It labored and Globex renewed shortly after.
This reasoning chain that makes the choice just isn’t written down anyplace your agent can learn. The agent will discover Globex’s exception case in Salesforce, however Salesforce is not going to inform it that the quantity was an exception, who accredited it, why it was accredited, whether or not the present scenario is an identical or not.
The why lives in –
- Previous slack threads the place finance staff admits a $300k account is definitely worth the threat.
- Zoom calls the place gross sales veterans point out these form of accounts pay finally.
- Emails from the CEO saying retaining Fortune-500 logos is vital.
These are vital items of data wanted to make the choice, however the agent can’t entry them.
So your agent does considered one of two issues –
- It sends an e-mail informing the coverage caps at 10%, and also you lose the account.
- It escalates to a human, who spends 24 hours doing Slack archaeology to reconstruct a call the corporate already made as soon as.
Both means, the group failed to learn by adopting an AI agent.
It is a common downside. Organizations lose billions annually –
- making the identical errors,
- reinventing the identical options,
- losing time on beforehand solved issues,
- being extremely gradual at onboarding new staff,
- combating compliance and audit gaps in an AI-native world.
It is because we now have gotten extraordinarily good at recording what occurred, however we systematically throw away why it occurred, which is the one factor your agent wanted right here.
Context graphs retailer the why in an agent’s reminiscence.
Basis Capital known as it “a trillion-dollar AI alternative“, which is the form of phrase that sends folks reaching for the again button. However stick round anyway. The time period is new and a bit of overloaded, but it surely factors at one thing actual. Should you use or construct brokers, you may find yourself utilizing a context graph quickly.
Flat context is unhealthy
The unhealthy option to give your AI brokers context is to only give all of them the info, data, paperwork, guidelines, insurance policies in a flat context window.
Say you’ve gotten an bill processing agent. You dump the bill, PO, vendor file, contract, coverage doc into the context. Then watch the agent fail. Why?
1. Context rot
When the agent asks itself “can I pay bill #842?” To reply, it has to hop – which PO does this bill reference? does that PO nonetheless have price range? was the supply obtained? is the seller on fee maintain? does $12,400 cross the approval threshold? what do the contract’s fee phrases say? is the coverage doc correct and up-to-date? are there undocumented nuances associated to this bill fee presently residing on Slack messages and Zoom name transcripts?
Flat retrieval tries handy this large quantity of data to the LLM mannequin in a pile of disconnected chunks. Some bill textual content right here, some PO textual content there, some language from random docs and slack channels, all given as a flat wall of textual content.
“Can I pay bill #842?”
Inbox
Acme Billing
billing@acme.com · Tue 09:14
Bill #842 — $12,400.00 due
Hello, attaching this month’s bill. Phrases per contract.
📎 invoice_842.pdf · 84 KB
SAPBuy Order · ME23N
7731
Acme Company Ltd
12,400.00
3,600.00
Posted · 12 Mar
Open
W policy_v4.docx
AP Approval Coverage
▸ Invoices ≥ $10,000 want supervisor sign-off
# ap-ops
Dana 10:21
Acme at all times pays finish of quarter — don’t chase them.
Wes 10:22
famous 👍 leaving #842 as-is
▦ payment_hold.csv
| A · Vendor | B · On maintain | |
| 1 | Acme Company Ltd | No |
| 2 | Globex LLC | Sure |
| 3 | Initech | No |
● REC Renewal name · transcript 14:02
Gross sales Gave Acme Internet-60 this renewal.
AP lead Paid late twice… but it surely’s a $40k account. Authorized.
The agent is pressured to re-derive each a type of connections between these items of knowledge from scratch on every flip. Flattening enterprise knowledge into free textual content destroys precisely the construction it wants.
And as context turns into giant, LLMs wrestle to manage up with the scale and begin failing of their duties. They fail to comply with directions, drop guidelines randomly, misunderstand the relation between two items of data far aside, ignore middle-of-context knowledge, apply guidelines and constraints out of order.
Surge AI paperwork this of their instruction-following benchmark. The most effective frontier mannequin solves <41% of such advanced duties.
2. Lack of choice traces
Like we noticed in our first instance, AI Brokers run into the identical ambiguity people resolve day by day with precedents, experiences, organizational reminiscence. However you possibly can’t give this stuff to an agent in a flat context window.
- Tribal data. “We at all times waive the $5k onboarding price for logistics firms however provided that they push again on the timeline first.” That is not within the CRM. It is tribal data handed down by way of inner conversations.
- Previous choices. “We structured a deal for account X the place they cut up funds into installments. We must always supply this related account Y the identical.” No system hyperlinks the 2 offers to convey why Y’s contract was drafted this manner.
- Context throughout techniques of file. An account supervisor sees utilization sliding within the product dashboard, an unpaid bill in NetSuite, a chilly one-line e-mail. They flag the account as “churn threat” within the CRM. The reasoning occurred of their head, however the CRM file simply reveals “churn threat”.
- Guide approvals. A VP approves a reduction on a Zoom name. The Hubspot file reveals the modified value. It would not present why this choice was made.
Reasoning behind knowledge, choices, actions is not captured in a flat context window.
In case you are a developer, this idea hits even tougher. Why did we decide this queue over that one in 2019? Why is there a sleep(200) within the retry path that breaks every little thing while you take away it? It was apparent to whoever wrote it, however that data is gone now. Bear in mind Structure Determination Information? They have been invented again in 2011 to repair precisely this. However most ADR folders die at three entries, as a result of writing them is friction and no person reads them later.
It is a common downside. Firms are good at storing what occurred, and unhealthy at storing why they occurred. It is because the why is unstructured, unfold throughout techniques, and no person reads it even for those who retailer it.
Each issues, context rot and lack of choice traces, are solved by context graphs.
What’s a context graph?
A context graph is a means of structuring an LLM’s context as a graph, the place nodes maintain items of data and edges maintain the relationships between them. It is optimized for the mannequin to learn, not for a human to browse.
Most agent reminiscence at the moment is flat. AI brokers embed your knowledge, cut up them into chunks, and return the few chunks that look most just like the continuing job. The LLM will get a pile of textual content with no sense of how these chunks join to 1 one other. That is vector RAG, the usual reminiscence utilized in AI brokers at the moment.
A context graph retains these connections. As an alternative of “listed below are 5 related paragraphs,” it may possibly say “Service A –will depend on–> on Service B,” “this launch –brought on–> that outage,” or “this bill –follows–> that coverage.” The sides carry which means, and the mannequin can traverse them.

This issues as a result of similarity just isn’t relevance. Two chunks can share phrases together with your job and nonetheless don’t have anything to do together with your precise job. Two different chunks can share no phrases together with your job and nonetheless relate to your job semantically.

The way to create a context graph?
A context graph goes after each failures, context rot and lack of choice traces, by altering what you retailer and the way.
Begin with “the way you retailer”. You retailer your corporation as a graph, not a pile of textual content. Entities, for instance, the bill, the PO, the account, the seller, the contract, the coverage, the approver, are all nodes within the context graph. The relationships between them are edges. This bill –references–> that PO. This PO –attracts on–> that price range. This price range –accredited by–> this individual. This vendor –ruled by–> that contract.
“Can I pay bill #842?”
You retailer every of these hyperlinks as soon as, as a substitute of leaving the mannequin to re-derive them from chunks of textual content each time it wants them. For every job/subtask, the agent pulls a small subgraph and leaves the opposite ten thousand data out of the window. Context rot goes away, as a result of the window stays small and on-point.
Now the “what you retailer”. You now additionally retailer every choice in a context graph. The unit of this context graph shall be a call hint. A flat file stops on the consequence “Initech renewed at 20%”. A choice hint retains the story behind it. The issue that triggered it, the choices weighed, why the rejected ones misplaced, the constraints, the exceptions, who determined, and the reasoning.

That is what a call hint shops. That is additionally what an worker retains of their head. However with a context graph of choice traces, an agent can learn it.
So a context graph is these two issues collectively – entities and relationships, plus a call hint on each choice, created throughout techniques of file and time. Basis Capital’s one-liner for it’s a “system of file for choices“. Most of your techniques already retailer the present state of issues. A context graph shops how the state bought that means.
You utilize a schema for the choice hint that’s superb in your use case.
Now the second half is popping previous choices into one thing the agent can lean on.
The way to use a context graph?
Few implementation particulars which can be vital when utilizing context graphs –
Seize it on the best way in
Brokers with context graphs must be low friction, in any other case nobody will need to preserve them. Seize the choice the second it’s made, not later.
Reconstructing context after the choice shall be lossy guesswork. The assembly is over, the Slack thread scrolled away, the individual left the corporate. A lot of the agent’s context has slipped away with out getting saved within the agent reminiscence.
Seize it when the choice is made, at nearly no additional effort. The entire context is already there within the lively context window. Additionally if a human overrides the agent’s choice, that override is the second to ask why and retailer the reply with minimal friction from the human.
That is additionally why brokers change the economics of organizational reminiscence. We’ve got at all times recognized we lose the why. Wikis, Confluence, post-mortems, ADRs: each considered one of them tries to put it aside, and each one decays, for a similar two causes. Writing it down is friction, and no person reads it again.
Brokers break each without delay. The agent sits within the execution path, so seize is a facet impact of doing the work, not an additional job bolted on afterward. And the agent is a tireless reader that may fortunately seek the advice of ten thousand previous choices earlier than making the following one. Organizational reminiscence lastly has a reader value writing for. That flips the idea of storing why, from a price you nag folks about into an asset that compounds.
Use saved choices as precedent
As soon as choices dwell within the graph, search turns them into precedent.
- a brand new choice alternative reveals up
- the agent pull the direct context
- the agent pulls the closest precedents
- the agent causes on the context and precedents
- the agent takes a call (or suggests it)
- choice is taken
- choice is saved as a call hint within the context graph
- choice is linked to related previous choices within the context graph

A pile of previous choices turns into reminiscence the agent can really use. That is additionally how an agent enter a mode of self-learning with out anybody fine-tuning it or updating guidelines/directions.
new case
Globex needs Internet-60
- paid late as soon as final yr
- $500k renewal in danger
- #348 on the Fortune 500
precedent · Determination Hint 118
Acme → Internet-60
- late twice however nonetheless granted
- $540k judged definitely worth the threat
- #211 on the Fortune 500. Nice brand.
↳ The agent reads the precedent and proposes to grant Internet-60 beneath the exception rule.
new case
Quote for MediCorp
- section: healthcare
- 9-month procurement cycle
- net-new brand
Determination hint 07
ABC Pharma → +10% buffer
- section: healthcare
- procurement cycles are brutal
- construct +10% into the quote
- captured at onboarding zoom name transcript in call_id 4329
↳ This doesn’t present up within the CRM. It simply lives in veterans’ heads. Reference a maatching choice hint, the agent provides the ten% buffer robotically and might say why each time requested.
new case
Account Q · renewal due
- utilization −30%Product
- bill 38d overdueNetSuite
- one-line chilly replySlack channel #C0BCH243GFE
Decison hint 151
Account Z → churn threat
- utilization slid 28%Product
- unpaid bill for 37 daysNetSuite
- chilly renewal replyOutlook
- CSM modified standing to churn threat
↳ The flat CRM discipline simply says “churn threat.” The choice hint retains the three indicators throughout Product, NetSuite and e-mail — that triggered the standing change. So the agent reassembles the identical image for Q and modifications its standing to “churn threat”.
There is a second payoff right here. As a result of traces file exceptions, not simply the clear path, you possibly can see when a rule retains getting overridden. If AP grants the identical late-payment exception to twenty distributors, the coverage is unsuitable, not the distributors. The graph can flip this sample right into a sign to repair the underlying coverage itself.
0occasions the Internet-60 exception
was granted this quarter
⚑ Sample detected
→ elevate the Internet-60 threshold
Over time, the context graph turns into the true supply of fact for autonomy, and your organization can simply audit and debug this autonomy.
The latest ACE paper, “Agentic Context Engineering”, makes the mechanism concrete:
Deal with the gathered context as a playbook that grows by way of era, reflection, and curation, and let actual outcomes refine it. The agent will get higher by modifying what it is aware of, not by touching a single weight. A correction at the moment turns into a rule tomorrow. A hint at the moment turns into precedent subsequent quarter. This suggestions loop permits studying in brokers.
Instance of an agent utilizing context graphs
An agent resolving the Initech renewal with a context graph
STEP 1 / 7
Open choice: Initech renewal
Use ← / → or the arrows to step by way of.
Much like data graphs?
The components are the identical, however the implementation is new.
Data graphs have been round since Google shipped one in 2012. Occasion sourcing, storing the sequence of occasions as a substitute of simply the most recent state, is a sample any backend engineer already is aware of. A context graph is near occasion sourcing for choices, the place every occasion drags alongside its rationale and its hyperlinks to every little thing.
So no, there isn’t any new primitive right here. What’s new is that you simply seize the why on the write path as structured knowledge, as a result of for the primary time there is a shopper, i.e. the agent, hungry and tireless sufficient to learn it.

RAG, for distinction, retrieves paperwork that look just like your query. A context graph retrieves choices, with their reasoning and their edges to every little thing they affected. One palms the mannequin textual content to learn. The opposite palms it construction to stroll and precedent to motive from.
System-of-record brokers will not work
Methods of file most likely have it unsuitable. Salesforce launched Agentforce, ServiceNow launched Now Help, Workday is doing one thing related. Their reasoning is so as to add intelligence the place the info resides.
However their brokers will inherit the very same limitations as their dad and mom.
- Methods of file seize what modified, not why. Salesforce tracks discipline historical past, however just for a restricted set of fields, and just for some time. And when somebody approves a reduction, no discipline anyplace shops the reasoning. The context of the choice is gone the second it is made.
- These techniques additionally miss knowledge. A assist ticket would not simply dwell in Zendesk. It wants consumer tiers from CRM, SLA phrases from billing, latest outages from PagerDuty, Slack thread flagging churn threat. No single system of file sees the entire image. And every vendor’s agent treats its personal system as the middle of the universe.
Methods of data are constructing their very own brokers, locking down APIs (ahem ahem), and slapping egress charges, however they can not insert themselves into an orchestration layer they have been by no means a part of.

When an agent triages an escalation, responds to an incident, or decides on a reduction, it pulls context from a number of techniques and time durations. The orchestration layer alone sees the complete image – what inputs have been gathered, what insurance policies utilized, what exceptions have been granted, and why choices have been taken.
As a result of it is executing the workflow, it may possibly seize that context at choice time as a substitute of bolting on governance afterwards.
That is the essence of a context graph, and that would be the single most precious asset in your firm within the period of AI.
The laborious components
Earlier than you get too excited –
- Rubbish in, rubbish precedent. If the captured rationale is lazy (“accredited, see Slack”), your precedents are landfill. The graph is value precisely the standard of the why you set in it, and writing why is actual work. However this time, it’s sure this work will reap advantages.
- Who writes the hint. If a human has to kind considerate rationale each time, it’d rot the identical means as a wiki. If the agent infers the rationale, it’s important to belief the inference, and “the mannequin guessed why we did this” is a shaky base. The actual reply is someplace in between, and getting that proper just isn’t trivial.
- The choice swamp. A greater title at the moment for knowledge lakes that exist in organizations could be knowledge swamps. We dump every little thing in them with no schema and no curation. A graph of hundreds of thousands of contradictory, half-true traces is similar failure with additional edges. With out curation, extra traces make precedent search worse, not higher.
- That is early. Most vendor decks make it sound shipped. It is not. The sample is sound and the early outcomes are unbelievably good. There’s something right here, undoubtedly. However “nice early outcomes” just isn’t “confirmed,” and anybody who tells you in any other case is pitching.
The complete stack
An AI-native workflow with context graphs has 4 layers –
1. Methods of file. Salesforce, SAP, Zendesk, GitHub, Slack, the Zoom transcript from this morning’s name. They maintain the state of your corporation – each file, ticket, commit, and message. What they do not maintain is the reasoning that connects them. However they’re nonetheless the bottom fact for what’s.
2. The harness. It sits within the execution path and runs the explanation → act → observe loop. It holds the instruments, picks what goes into the mannequin on every step, shops corrections as reminiscence, checkpoints lengthy runs, enforces permissions, logs each choice, and catches errors earlier than they crash the run. This engine turns a stateless LLM right into a system that finishes work.
3. The context graph. Because the harness runs, each choice leaves a hint: what inputs it gathered, which rule it utilized, what exception it took, who accredited, and why. The graph stitches these traces throughout entities and time. Your techniques of file keep the reality for what occurred. The graph turns into the reality for why.
4. Brokers and people. Brokers execute the routine instances finish to finish. People deal with the instances the agent flags as unsure. Each correction a human makes flows again into reminiscence and the graph, so future agent runs are higher.

This maps to the 2 core options of AI-native organizations, Common context and Loops.
- Common context is your techniques of file made queryable by way of the context graph. The agent would not re-derive the hyperlinks between an bill, a PO, a contract, and a Slack message on each flip. The graph already holds them.
- Loops are the harness closing suggestions on each run. A correction at the moment turns into a rule tomorrow. A choice hint at the moment turns into precedent subsequent quarter.
The place to start out
Do not attempt to implement context graphs in all places without delay. Decide one workflow/staff and show it earlier than you develop. Attempt to decide a workflow/staff with a number of of those three traits –
- Excessive headcount, as a result of that labor exists to deal with messy logic.
- Exception-heavy choices, as a result of precedent issues loads there.
- Cross-functional roles, as a result of they exist simply to hold context that no different system holds presently.
If all three line up, that is your first goal. Procurement, finance, claims, deal desk, underwriting, escalation administration are few examples.
And do not be afraid to tokenmaxx. In case your month-to-month AI utilization invoice would not make you uncomfortable today, you’re doing one thing unsuitable. Plus, you possibly can greater than compensate in your AI payments at the moment by saving in your payrolls tomorrow.
Conclusion
A clear option to maintain all of this in your head:
The mannequin is your mind, the agent / agentic harness is your limbs, and the context graph is the map of your particular world (firm). An excellent physique with no map of your world stalls at each fork within the highway that requires understanding the map, and enterprise processes are nothing however these forks.
So the query value asking about your personal firm is small and uncomfortable. The place do you bear in mind why issues occurred, and what really labored? If the sincere reply is “in just a few folks’s heads,” you already know the place the danger is, and also you already know what’s value constructing.
Capturing the “why” behind choices is the following nice leap in enterprise intelligence.
