Public note: this article uses fictionalized support details and simplified
names. It is intended to explain the operating model, not expose live customer
data, private tickets, credentials, channel IDs, or production configuration.
The Success IT Scenario
Imagine a support team using an agent platform for day-to-day operations.
A Support Agent owns intake and Support CRM workflow. A Coding Agent owns
engineering diagnostics, CodeGraph, database investigation, RCA, and PR
handoff.
Support CRM
P2 support ticket
SUP-2026-0142: Invoice total differs after posting
A user reports that a posted invoice total differs from the previewed
total in a web application. They attached a screenshot showing the
expected and actual totals for the same document.
PNG
Attachment shows document DEMO-INV-2026-014, preview total 12,240.00,
posted total 12,480.00, and the screen path used by the user.
What KM Means Here
In this operating model, KM is not just document tagging. It is the layer
that converts data access into disciplined action.
Skills
Task-specific instructions the agent must load before specialized work.
Runbooks
Step order, commands, evidence bars, handoff shapes, and stop conditions.
Permissions
Role, user, channel, tool, sandbox, and approval rules.
Workflow State
Ledgers, memory files, active investigations, PR records, and audit trails.
Source Metadata
Tagged source-system data: products, ticket types, repos, entities, owners, and ACLs.
Head-to-Head Output
Same ticket. Same model quality. Different operating knowledge available.
1. No KM
Only the prompt and generic AI knowledge.
Likely AI response
- "Check recent code changes around invoice posting."
- "Ask the user for reproduction steps."
- "Query invoice header, line, tax, and posting tables."
- "Create a Jira or GitHub issue if it looks like a bug."
What is missing
- No knowledge that the Support Agent owns intake and the Coding Agent owns engineering.
- No reliable direct-route rule for product + request type.
- No lane resolver before repo, branch, endpoint, or deploy decisions.
- No production DB approval rule or read-only diagnostic boundary.
- No required RCA, ledger, or handoff format.
Operational result
Plausible answer, inconsistent execution. The agent can sound helpful
while skipping policy, guessing authority, and leaving no durable audit
trail.
2. Connectors and Search
SharePoint, Jira, Confluence, Support CRM, SuccessGraph, and CodeGraph are indexed.
Likely AI response
- Finds similar invoice discrepancy tickets and related RCA notes.
- Finds product map entries and related repository docs.
- Finds CodeGraph nodes for posting, tax calculation, and invoice totals.
- Summarizes possible backend, SQL, and UI causes.
What is still missing
- Search does not decide which rule is binding.
- Search does not enforce who may approve production diagnostics.
- Search does not require CodeGraph before DB or code work.
- Search does not update the ticket, channel report, RCA, PR, and memory ledgers in order.
Operational result
Better factual grounding, but the agent still has to infer the operating
procedure from retrieved chunks. That inference can vary by prompt,
model, search ranking, and source freshness.
3. Structured KM Layer
Search plus skills, runbooks, permissions, state, and approvals.
Likely AI response
- The Support Agent classifies product + bug/data issue as engineering-routed.
- The Support Agent moves the ticket to To Dev and creates the engineering issue in the mapped repo.
- The Coding Agent resolves the product lane before branch, endpoint, DB, or PR decisions.
- The Coding Agent runs CodeGraph blast-radius analysis before DB queries or code changes.
- Production diagnostics are read-only, approval-gated, and audit-reasoned.
- RCA, active investigation ledger, PR evidence, and Support Agent handoff are updated.
Operational result
Consistent execution. The agent knows the procedure, follows authority
boundaries, records evidence, and produces a traceable support and
engineering handoff.
What Happens With No KM
No KM does not mean the AI is useless. It means every operational decision
is reconstructed from scratch, usually from incomplete prompt context.
1
Role confusion
The agent may investigate directly, assign a User, or ask a Manager,
because it does not know the Support Agent to Coding Agent split.
2
Unsafe authority
It may suggest production SQL or status changes without channel, user, or
approval context.
3
Weak traceability
It may summarize findings in chat but fail to update the durable RCA,
active investigation ledger, ticket comment, or PR evidence.
4
Inconsistent reasoning
One run may search tickets first, another may query the DB first, and
another may jump to code changes.
What the KM Layer Makes Repeatable
The key point: KM is the layer that coordinates the work, not just the layer
that stores documents.
01
Intake
The Support Agent reads the user evidence, captures required fields,
creates or updates the Support CRM ticket, and classifies product and type.
02
Route
Product map plus request-type rules decide engineering route vs manual
triage.
03
Resolve Lane
The Coding Agent resolves product, channel profile, repo, branch base, PR
target, tenant context, and allowed diagnostic surface.
04
Investigate
CodeGraph comes first. DB diagnostics are read-only, reasoned, and gated.
Findings are recorded as they happen.
05
Handoff
RCA, ticket update, channel report, PR evidence, and Support Agent handoff
use a consistent output shape.
Scorecard
The KM layer matters most when the answer must become a governed action.
| Capability |
No KM |
Connectors and Search |
Structured KM Layer |
| Find related information |
Low Depends on prompt context. |
High Indexes tickets, docs, source metadata, SuccessGraph, and CodeGraph. |
High Uses search when it is the right tool. |
| Choose the right workflow |
Low Guesses from general patterns. |
Medium Can retrieve rules but must infer precedence. |
High Loads the relevant skill and follows the runbook. |
| Respect permissions |
Low No role or channel authority model. |
Medium Can see ACL metadata if indexed. |
High Enforces channel, role, tool, sandbox, and approval gates. |
| Produce audit trail |
Low Chat answer may be the only artifact. |
Medium Can cite retrieved sources. |
High Updates ticket, RCA, memory, ledgers, and PR evidence. |
| Operate consistently |
Low Different runs produce different next steps. |
Medium Better context, but still variable execution. |
High Procedure and stop conditions are explicit. |
What the KM Layer Should Contain
If the end state is AI agents that assist daily operations, the KM layer must
be more than source tagging.
Practical definition
A KM layer is the operational knowledge substrate that lets agents turn
retrieved information into governed work.
It includes source metadata, but also the skills, policies, state, and
runbooks that make an agent behave like a trained team member rather than a
search box.
Entity Map
Products, customers, systems, tickets, repos, services, owners, and environments.
Procedures
Skills and runbooks for intake, triage, diagnostics, PRs, releases, and support replies.
Permissions
Role, user, channel, system, tool, and approval rules.
State
Durable ledgers for active work, handoffs, evidence, audit, and unresolved unknowns.
Observability
What was retrieved, what rule was applied, who approved it, and what artifact changed.
Further Reading
Connector/search platforms are still important. The point is that retrieval
should be paired with an operational layer for action.
Operational KM Layer
- Skills and runbooks that encode how work is done.
- Permissions and approval gates that encode who may do it.
- Workflow ledgers that encode what happened and what remains unknown.
- Audit trails that connect source evidence to operational actions.
The operating model described here is the same one behind my talk
Human in the Loop, and the starting point for the follow-up
paper Two Brains, One Operator.