Classic painting used as the article cover
← Back to blog

Agent Operations

What Is an Agent Inventory?

A structured system of record for every agent: who owns it, what it can access, what it can do, and whether it's still approved to operate.

Paulina XuJun 12, 20268 min
Agent InventoryAgent OperationsGovernance

Overview

An agent inventory is a structured record of the AI agents operating across an enterprise. It is the source of truth for the questions that determine whether autonomous systems are under control or quietly drifting out of it: what agents do we have, who owns them, what can they access, what can they do, and are they still approved to operate?

It sits early in Agent Operations. Discovery tells you which agents exist; the inventory turns that raw finding into a durable system of record that the rest of governance can build on.

The distinction matters. A list of agent names is not an inventory any more than a pile of receipts is an accounting system. An inventory is organized, attributed, and maintained—each agent carries the context needed to make decisions about it.

Why Informal Tracking Breaks Down

In the early days of agent adoption, tracking is informal and scattered. The information exists, but it never exists in one place, and no single view is complete:

  • One team maintains a spreadsheet of the agents it built.
  • Another tracks agents as entries in a ticketing system.
  • Developers document agents in code repositories and READMEs.
  • SaaS-embedded agents appear only inside vendor admin consoles.
  • OAuth-connected agents surface as app grants in identity logs.

Each of these captures a slice. None captures the whole. A procurement team might know its contract-review agent exists because they requested it, but have no record that it holds a standing token into the vendor management system. The identity team can see that token, but not who owns the agent behind it. The picture is real, but fragmented across systems that were never designed to talk to each other.

An agent inventory exists to bring this information together—to reconcile the spreadsheet, the ticket, the repository, the admin console, and the app grant into a single normalized record per agent.

What an Inventory Records

A useful inventory captures more than a name and a checkbox. For each agent it records the operational context that governance, security, and ownership decisions depend on:

  • Name and description: what the agent is and what it is for.
  • Owner: the accountable person or team, not just whoever deployed it.
  • Business purpose: the outcome it is meant to support.
  • Platform and environment: where it runs, and whether it is in development, staging, or production.
  • Users: who it acts on behalf of, and under whose identity.
  • Connected tools and data access: the systems and datasets it can reach.
  • Action permissions: what it can actually do, not just what it can see.
  • Credentials: the keys, tokens, and secrets it holds.
  • Lifecycle state: proposed, active, deprecated, or retired.
  • Risk level and last review date: how exposed the agent is, and when someone last confirmed it should still be running.

Consider a marketing analytics agent. The name tells you little. The inventory record tells you that the campaign team owns it, that it runs in production on a managed runtime, that it reads from the warehouse and can publish to the email platform, that it holds a scoped warehouse token, and that it was last reviewed in March. That is the difference between knowing an agent exists and knowing whether it is safe.

Classifying Agents

An inventory should also distinguish between types of agents, because type shapes how an agent is reviewed, owned, and constrained. Agents are not interchangeable line items.

  • Internal assistants that answer questions or draft content for employees.
  • Workflow automations that move data and trigger actions across multiple systems.
  • Coding and engineering agents that operate inside development environments.
  • Third-party agents brought in by vendors or partners.
  • SaaS-embedded agents that ship inside platforms you already license.

A second, orthogonal distinction is just as important: how the agent is triggered. Some agents act only when a person explicitly prompts them. Others run autonomously on a schedule or in response to events, with no human in the immediate loop. An HR onboarding agent that provisions accounts the moment a new hire is created behaves very differently, from a risk standpoint, than a legal assistant that drafts a clause only when an attorney asks.

Why classification earns its place: type and trigger together determine the depth of review an agent needs. Tagging them in the inventory lets you filter for the agents that warrant the most attention instead of treating every agent the same.

Why Context Equals Risk

This context matters because not all agents carry the same risk. The inventory is what makes risk legible at a glance instead of buried in a configuration file someone has to go read.

A read-only documentation assistant that summarizes an internal wiki is, in practice, low risk. An agent that can query customer records, send messages to external recipients, or modify production infrastructure is not. The same is true within a single domain: a finance agent that reads ledger balances to build a report is a different risk profile from one that can initiate payments.

The inventory captures the attributes that drive that judgment—data access, action permissions, blast radius, autonomy—so risk is something you can see and compare across the fleet rather than something you rediscover during an incident. When a question arises about which agents can touch sensitive data, the answer should be a query against the inventory, not a week of investigation.

Operational Infrastructure, Not a Compliance Artifact

An agent inventory is easy to mistake for a document you produce once for an audit and then forget. That framing undersells it. A well-maintained inventory is operational infrastructure—something multiple teams use continuously, each for a different reason:

  • Security teams use it to review risk and find the agents with the most exposure.
  • IT teams use it to find and remove stale access when an agent is no longer needed.
  • AI and platform teams use it to understand adoption and avoid rebuilding agents that already exist.
  • Business owners use it to manage dependencies and understand what breaks if an agent goes away.
  • Compliance teams use it to prepare for audits without a scramble.

The inventory becomes most valuable at scale. With a handful of agents, an experienced engineer can hold the whole picture in their head. Once an enterprise has dozens or hundreds of agents spread across AI platforms, SaaS tools, and internal services, no single person can remember where they all are or what they all do. The inventory is what replaces that fading institutional memory with a durable, queryable record.

In Practice

The most useful inventories are queryable, not just readable. The point is to be able to ask a question and get a list of agents that match. A few examples of the questions an inventory should answer in seconds:

# Which production agents can write to customer-facing systems?
filter: environment = production
        AND action_permissions includes "write"
        AND data_access includes "customer"

# Which agents haven't been reviewed in the last 90 days?
filter: last_review_date < now() - 90d

# Which agents have no named owner?
filter: owner IS NULL

Each record is small. A normalized entry might look like this, regardless of whether the agent was discovered in a repository, an admin console, or an OAuth grant:

{
  "name": "vendor-contract-reviewer",
  "owner": "procurement-ops",
  "type": "workflow-automation",
  "trigger": "event",
  "environment": "production",
  "data_access": ["contracts", "vendor-records"],
  "action_permissions": ["read", "flag-for-review"],
  "credentials": ["vault:procurement-scoped-token"],
  "lifecycle_state": "active",
  "risk_level": "medium",
  "last_review_date": "2026-04-22"
}

The first time a team builds this, the work is mostly reconciliation: pulling records from each source and resolving duplicates where the same agent appears in two systems under two names. The discipline that follows is keeping it current—updating the record when an agent gains a new permission, changes owners, or is retired. An inventory that is accurate today and stale in three months is worse than none, because it invites false confidence. Treat the last_review_date field as a commitment, not a timestamp.

From a List to a System of Record

An agent inventory is the step that turns visibility into something you can act on. Discovery answers which agents exist. The inventory answers what each of them is, who owns it, what it can reach, and whether it should still be running—and keeps answering as the fleet grows.

Without it, every governance question becomes an investigation. With it, the answers are already written down, attributed, and current.

An inventory is not paperwork you produce for an audit. It is the operational record that makes every later control—review, offboarding, accountability—possible at scale.