Skip to main content

Discovery

Pavri Discovery finds AI agents running in your infrastructure that are not yet instrumented with the Pavri SDK. These are called shadow assets.

How Discovery Works

Discovery uses connectors — lightweight workers that poll hosted AI platform APIs to inventory deployed agents.

Supported Platforms

Hosted coded-agent platforms:

PlatformConnectorWhat It Finds
Google Vertex AI Agent Enginevertex_ai_agent_engineDeployed agents, tools, models
LangGraph Cloudlanggraph_hostedHosted assistants, graphs
Azure AI Foundryazure_foundryAI agents, tools
CrewAI AMPcrewai_ampDeployed crews, agents, tools

No/low-code workflow platforms:

PlatformConnectorWhat It Finds
Microsoft Power Automatepower_automateFlows, connectors, runs
Make.commakeScenarios, modules, executions
ZapierzapierZaps, steps, task history
n8nn8nWorkflows, nodes, executions
WorkatoworkatoRecipes, connectors, audit logs
Dialogflow CXdialogflowAgents, flows, webhooks
UiPath OrchestratoruipathProcesses, jobs, audit logs
ServiceNow Flow DesignerservicenowFlows, subflows, executions
Cognigy.AIcognigyProjects, flows, extensions
BotpressbotpressBots, integrations, webhooks
FlowiseflowiseChatflows, assistants, tools
ManyChatmanychatBots, flows, external requests
LandbotlandbotBots, blocks, webhooks
AWS HoneycodehoneycodeApps, tables, automations
LangSmith Studiolangsmith_studioLocal/hosted graphs, traces
ReplitreplitProjects, AI integrations
OpenAI Agent Builderopenai_agent_builderExported agent workflows
Generic HTTP platformgeneric_httpAny platform with HTTP APIs

No-code workflows are registered as first-class agents and appear in the same inventory, sessions, policies, and alerts surfaces as coded agents. See No/Low-Code Security Plane for the full model.

Discovery Flow

  1. Poll — Connectors query platform APIs on a configurable interval
  2. Normalize — Raw API responses are transformed into standardized discovery evidence records
  3. Correlate — Discovered assets are compared against SDK-registered agents to find matches
  4. Triage — Operators review discovered assets and decide: approve, reject, or defer

Asset Lifecycle

Every discovered asset follows this lifecycle:

unknown → discovered → correlated → reviewed → approved
↘ rejected
approved → drifted → reviewed → approved
  • Unknown — Asset not yet seen by any source
  • Discovered — Found by a connector, awaiting correlation
  • Correlated — Matched to an SDK-registered agent (exact or fuzzy)
  • Reviewed — Operator has examined the asset
  • Approved — Confirmed as a known, governed agent
  • Rejected — Marked as not relevant or out of scope
  • Drifted — Previously approved asset has changed (tools, model, config)

Evidence and Confidence

Every discovery record is an immutable evidence entry with:

  • Source — which connector produced it
  • Three timestampsobserved_at (platform time), collected_at (Pavri ingestion), processed_at (evaluation)
  • Confidence score — based on the source type:
SourceConfidenceRationale
SDK telemetry0.95Direct observation from instrumented agent
Replay evidence0.90Deterministic re-execution
Hosted discovery0.75API-observed, may be stale
MCP scan0.60Static analysis, point-in-time

Correlation

When a discovered asset matches an SDK-registered agent, Pavri creates a correlation candidate:

  • Exact match — Same agent name → confidence 0.95
  • Fuzzy match — Tool overlap > 80% → confidence proportional to overlap
  • Ambiguous — Multiple possible matches → queued for operator review

Ambiguous matches are never auto-merged. An operator must review and decide.

Posture History

Every change to a discovered asset is recorded in the posture history timeline:

  • New capabilities added or removed
  • Model changes
  • Configuration drift
  • Rediscovery after absence

This provides an audit trail for security reviews and compliance.

Failure Behavior

Discovery is an observability-path system. It fails open:

  • If a connector cannot reach its platform, it logs a warning and continues
  • Stale discovery data is acceptable
  • Discovery never blocks agent operations