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.

Product Success IT Web Product
Request type Bug / Data Issue
Requester Example Operations User
Source Email with screenshot
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.

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.