docs: add section for dapr agents regarding default values to cover default agent statestore naming for auto attachment#4979
Open
CasperGN wants to merge 13 commits intodapr:v1.16from
Open
Conversation
…efault agent statestore naming for auto attachment Signed-off-by: Casper Nielsen <casper@diagrid.io>
4 tasks
Signed-off-by: Casper Nielsen <casper@diagrid.io>
msfussell
reviewed
Jan 27, 2026
daprdocs/content/en/developing-ai/dapr-agents/dapr-agents-core-concepts.md
Outdated
Show resolved
Hide resolved
…-concepts.md Co-authored-by: Mark Fussell <markfussell@gmail.com> Signed-off-by: Casper Nielsen <whopsec@protonmail.com>
…untimeconf & secrets Signed-off-by: Casper Nielsen <casper@diagrid.io>
marcduiker
requested changes
Feb 13, 2026
Contributor
marcduiker
left a comment
There was a problem hiding this comment.
Small clarification is suggested
daprdocs/content/en/developing-ai/dapr-agents/dapr-agents-core-concepts.md
Outdated
Show resolved
Hide resolved
…-concepts.md Co-authored-by: Marc Duiker <marcduiker@users.noreply.github.com> Signed-off-by: Casper Nielsen <whopsec@protonmail.com>
msfussell
reviewed
Feb 23, 2026
|
|
||
| ### Default settings | ||
|
|
||
| Dapr Agents comes with pre-set sensible defaults on different settings. Descriptions of each of them are below. |
Member
There was a problem hiding this comment.
Suggested change
| Dapr Agents comes with pre-set sensible defaults on different settings. Descriptions of each of them are below. | |
| Dapr Agents comes with pre-set defaults on different settings. Descriptions of each of them are below. |
|
|
||
| #### State store | ||
|
|
||
| By ensuring the following statestores with these metadata names are present, the Dapr Agent will resolve these from the Dapr Metadata API: |
Member
There was a problem hiding this comment.
Suggested change
| By ensuring the following statestores with these metadata names are present, the Dapr Agent will resolve these from the Dapr Metadata API: | |
| By ensuring the following statestores with these metadata names are present, Dapr Agents resolves these from the Dapr Metadata API: |
| The default key is set to the agents name in lowercase with space replaced by `-` with the `-session` suffix. | ||
| - `agent-runtimestatestore`: Agent runtime configuration | ||
| The statestore is loaded with key `agent_runtime` expecting field `data` containing a dictionary (i.e., `{ "key": "value" }`) | ||
| currently the agent supports auto-instrumenting itself with OpenTelemetry by setting the following available options: |
Member
There was a problem hiding this comment.
Suggested change
| currently the agent supports auto-instrumenting itself with OpenTelemetry by setting the following available options: | |
| Dapr Agents supports auto-instrumenting with OpenTelemetry by setting the following environment variables: |
| | OTEL_TRACING_EXPORTER | "otlp_grpc"/"otlp_http"/"console" | Which exporter to use. Default: "console" | | ||
|
|
||
|
|
||
| For `DurableAgent` you can also rely on the workflow statestore: |
Member
There was a problem hiding this comment.
Suggested change
| For `DurableAgent` you can also rely on the workflow statestore: | |
| For `DurableAgent` you can also set on the workflow statestore: |
|
|
||
| #### Pub/Sub | ||
|
|
||
| By ensuring the following pubsub component with appropriate naming is present, the Dapr Agent will resolve it from the Dapr Metadata API: |
Member
There was a problem hiding this comment.
Suggested change
| By ensuring the following pubsub component with appropriate naming is present, the Dapr Agent will resolve it from the Dapr Metadata API: | |
| By ensuring the following pubsub component with appropriate naming is present, Dapr Agents resolves it from the Dapr Metadata API: |
|
|
||
| #### Secret store | ||
|
|
||
| By ensuring the following secret component with approproate naming is present, the Dapr Agent will resolve it from the Dapr Metadata API: |
Member
There was a problem hiding this comment.
Suggested change
| By ensuring the following secret component with approproate naming is present, the Dapr Agent will resolve it from the Dapr Metadata API: | |
| By ensuring the following secret component with appropriate naming is present, Dapr Agents resolves it from the Dapr Metadata API: |
| By ensuring the following secret component with approproate naming is present, the Dapr Agent will resolve it from the Dapr Metadata API: | ||
|
|
||
| - `agent-secretstore`: Secrets for agent runtime | ||
| The agent will bulk load all secrets and insert them into it's runtime secrets. The currently supported secrets are: |
Member
There was a problem hiding this comment.
Suggested change
| The agent will bulk load all secrets and insert them into it's runtime secrets. The currently supported secrets are: | |
| The agent bulk loads all secrets and inserts them into it's runtime secrets. The supported secrets are: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Please follow this checklist before submitting:
In addition, please fill out the following to help reviewers understand this pull request:
Description
Add "Default Settings" section for dapr agents explaining the default attachment to statestores and pubsub if none is supplied.
Issue reference
N/A