Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
type: docs
title: "Operations"
linkTitle: "Operations"
weight: 80
description: "Get started with secure and reliable operations of Dapr Agents"
aliases:
- /developing-ai/dapr-agents/dapr-agents-operations
---

## Operations

### Agent Registry

#### Agent Metadata Schema

Dapr Agents utilizes an agent registry (often referenced as `agent-registry` statestore) to communicate agent capabilities. The agent registry contains agent metadata, including the agent's name, description, version and more.

In order to facilitate easier handling of version changes to the agent metadata, Dapr Agents supplies versioned JSON schemas. Within the agents repository you'll find 3 types of JSON schema files:

- [index.json](https://raw.githubusercontent.com/dapr/dapr-agents/main/schemas/agent-metadata/index.json)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These URLS do not resolve. What are they intending to show?

Copy link
Contributor

@marcduiker marcduiker Jan 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Agents PR needs to be merged first: dapr/dapr-agents#373
Added the waiting-on-code-pr label.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. Once 373 is in main the links will resolve properly

- [latest.json](https://raw.githubusercontent.com/dapr/dapr-agents/main/schemas/agent-metadata/latest.json)
- `v{version}.json`

The `index.json` can be used as a lookup table and looks like:

```
{
"current_version": "X.Y.Z",
"schema_url": "https://raw.githubusercontent.com/dapr/dapr-agents/main/schemas/agent-metadata/vX.Y.Z.json",
"available_versions": [
"vX.Y.Z",
"vA.B.C"
]
}
```

When the agent starts up it will insert its own metadata into the supplied agent registry. The agent metadata object contains the key `schema_version` which can be used as a reference to fetch the valid schema for that agent version:

```sh
curl -s -v "https://raw.githubusercontent.com/dapr/dapr-agents/main/schemas/agent-metadata/v$(jq -r '.schema_version' agent-metadata.json).json"
```
Loading