Skip to main content

​
Agent Registry

The Agent Registry provides a discovery layer for AI agents and tools. The core A2A Agent Registry is available now with full CRUD, fine-grained authorization, and event streaming. The registry fills the explicit gap in the A2A specification, which acknowledges the need for curated registries but does not prescribe a standard API for them.
The A2A specification states: “The current A2A specification does not prescribe a standard API for curated registries” and “The A2A community explores standardizing registry interactions or advanced discovery protocols.” The Agent Registry is designed to fill this gap with enterprise-grade capabilities.

​
The Discovery Problem

The A2A protocol v1.0 defines three agent discovery strategies, two of which are limited: Meanwhile, the MCP ecosystem has its own public registry, and agentskills.io provides a portable skill format. These three ecosystems are complementary but fragmented — no unified discovery layer exists.

​
Key Capabilities

RESTful CRUD for Agent Cards with full schema validation, optimistic concurrency control, and fine-grained authorization. Agents can register, update, and manage their A2A-compliant Agent Cards through the registry API. Auto-detects A2A protocol version (0.3 vs 1.0) from card structure. SHA-256 card hash for duplicate detection.API surface:
Periodic multi-level health probes ensure agents are reachable and functioning:All probes include SSRF protection to prevent internal network scanning.
Track agents through their full lifecycle with administrative status and lifecycle stages:Administrative Status: PENDING, ACTIVE, SUSPENDED, DEREGISTEREDLifecycle Stage: EXPERIMENTAL, STABLE, DEPRECATED, RETIRED
Immutable version snapshots are created on every update to an agent’s registration. The registry supports version diffing and rollback to any previous version.
Enterprise-grade controls including:
  • Approval workflows for new agent registrations
  • Registration policies and change windows
  • Audit logging of all operations
  • Compliance reporting
  • Tenant-scoped administration with optional cross-tenant federation

​
Architecture

The Agent Registry follows a stateless API architecture backed by proven platform infrastructure, OIDC authentication, fine-grained authorization, event streaming, and relational storage.

​
Artifact Preview

Agents produce artifacts (query results, generated reports, intermediate data) that the platform can preview without forcing a full download. The Assets service exposes a preview endpoint that returns a structured snapshot of an artifact. Defaults (effective with em-runtime 5.3+):
  • Default row limit: 500 rows (raised from 10)
  • Maximum byte budget: 512 KB per response (raised from 64 KB)
  • Maximum row limit: 10,000 rows (cap regardless of caller request)
Response metadata (PreviewMetadata):
  • size_bytes: total file size for tabular, text, and raw artifacts (always present)
  • truncated: boolean flag set when either the row limit or the byte budget was reached
The service applies a byte-level truncation backstop after row-level limits, so a response that cuts cleanly at a record boundary still respects max_bytes. Callers should always check truncated before assuming a preview reflects the full artifact.

​
MCP Tool Integrations

The em-runtime MCP server exposes tool sets that agents can invoke via the Model Context Protocol. These tools proxy authenticated calls to platform services using the caller’s JWT and project context.

​
Talk2Data Tools

When TALK2DATA_BASE_URL is configured, the following tools are available: These tools forward requests to the Talk2Data Service using the caller’s bearer token and X-Project-ID header. If TALK2DATA_BASE_URL is not set, the tools return a talk2data_not_configured error. See Data Insights Overview for Talk2Data deployment.

​
Catalog Tools

The MCP server also exposes metadata and search tools against the Utils service (data catalog):
  • get_schema_mcp — Get schema metadata for a data connection entity by FQN
  • list_metadata_mcp — List metadata assets with filtering
  • search_metadata_mcp — Full-text search across the data catalog

​
Webhook Events

The registry emits events after successful registration operations.

​
Well-Known URI Crawling

The registry can automatically discover agents from configured domains by crawling their /.well-known/agent-card.json endpoints:
  • Scheduled crawls with configurable intervals
  • Caching to minimize network traffic
  • Drift detection to identify when a remote Agent Card changes
  • SSRF protection for all outbound requests

​
Multi-Tenancy

The registry supports full multi-tenant isolation:
  • Namespace isolation — each tenant’s agents are invisible to other tenants
  • Tenant-scoped administration — per-tenant admin roles and policies
  • Cross-tenant federation — optional sharing of selected agents across tenants
  • Cost attribution — per-tenant usage metering, quota enforcement, and chargeback

​
Target Personas

​
Success Metrics

​
Next Steps

Data Connections

Configure data source connections used by agents for data access.

Webhooks

Set up webhook notifications for agent lifecycle events.

Data Insights Agents

See how Data Insights uses A2A agents for conversational analytics.

Security Model

Understand authentication, authorization, and multi-tenant isolation.