Skip to content

docs(adk): create State and Configuration concept pages#449

Merged
jacksonyzj merged 32 commits intomasterfrom
feat/adk-new-concept-pages
Apr 13, 2026
Merged

docs(adk): create State and Configuration concept pages#449
jacksonyzj merged 32 commits intomasterfrom
feat/adk-new-concept-pages

Conversation

@jacksonyzj
Copy link
Copy Markdown
Contributor

@jacksonyzj jacksonyzj commented Apr 6, 2026

Summary

Two new concept pages for State and Configuration, filling gaps in the ADK documentation.

Tickets

# Ticket Page
1 ADK-304 State
2 ADK-303 Configuration

State page covers

  • Three state scopes: bot (global), user (per-user), conversation (per-conversation)
  • Defining schemas in agent.config.ts and Conversation definitions
  • Reading/writing state in handlers (clarified: only inside runtime context)
  • Tags definition and read/write for bot, user, conversation
  • State references with Reference.Workflow()
  • bot.id and user.id identity accessors

Configuration page covers

  • Full defineConfig reference with all options (including evals)
  • configuration runtime import (read-only proxy)
  • adk config / config:get / config:set with --prod flag (with real CLI output)
  • Environment variables (process.env in agent.config.ts)
  • Note: no dedicated secrets API; integration secrets via dashboard
  • Note: adk config is separate from integration configuration
  • Note: config:get reads persisted values only, not schema defaults
  • Default models, custom events, dependencies

Test plan

  • Preview via Mintlify staging deployment
  • Live tested adk config, config:set, config:get on real bot
  • Verified all internal links resolve

@mintlify
Copy link
Copy Markdown

mintlify Bot commented Apr 6, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
botpress 🟢 Ready View Preview Apr 6, 2026, 2:49 PM

@jacksonyzj jacksonyzj marked this pull request as ready for review April 6, 2026 15:52
@jacksonyzj jacksonyzj requested review from a team and aj-botpress April 6, 2026 15:52
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/configuration.mdx
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/configuration.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/state.mdx Outdated
Comment thread adk/concepts/configuration.mdx Outdated
Copy link
Copy Markdown
Collaborator

@adkah adkah left a comment

Choose a reason for hiding this comment

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

just a couple of comments in addition to those already left

Comment thread adk/concepts/state.mdx
Comment thread adk/concepts/state.mdx Outdated
@jacksonyzj jacksonyzj merged commit ff2cf73 into master Apr 13, 2026
4 checks passed
@jacksonyzj jacksonyzj deleted the feat/adk-new-concept-pages branch April 13, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants