Skip to content

docs: clarify identity scope as three per-resource axes - #5269

Closed
Florence Morris (fjmorris) wants to merge 1 commit into
fjmorris/DOC-1403from
fjmorris/DOC-1471
Closed

docs: clarify identity scope as three per-resource axes#5269
Florence Morris (fjmorris) wants to merge 1 commit into
fjmorris/DOC-1403from
fjmorris/DOC-1471

Conversation

@fjmorris

Copy link
Copy Markdown
Contributor

Docs-review pass on the Managed Deep Agents identity page. Stacked on #5262 (base fjmorris/DOC-1403), so this diff shows only the review change; it retargets to main automatically once #5262 merges.

Reworks the "Choose a scope" section so the three scopable resources and their distinct value sets are explicit (review feedback):

  • Names the three resources up front — threads, memory, credentials — and states each accepts its own set of values.
  • Splits the single merged value table into per-resource tables (Threads, Memory, Credentials), each listing only that resource's legal values with a "How the agent acts" column. Makes clear that conversation is threads-only and custom is credentials-only.
  • Adds a "Set one value for all three" table showing how a single scope value expands per resource; keeps the product-shape combinations table.
  • Accuracy fix: scope: "organization" resolves credentials to none, not agent (verified against dev84 _SCOPE_AXES). Flagging in case agent was the intended product behavior rather than a doc error.

Values and per-resource behavior sourced from managed-deepagents==0.5.0.dev84 (identity/__init__.py type aliases and identity/options.py).

Drafted with AI agent (dcode) assistance.

Rework the "Choose a scope" section so the three scopable resources and their
distinct value sets are explicit, per review feedback.

- Name the three resources up front (threads, memory, credentials) and state
  that each accepts its own set of values.
- Split the single merged value table into per-resource tables (Threads,
  Memory, Credentials), each listing only that resource's legal values with a
  "How the agent acts" column. Makes clear that `conversation` is threads-only
  and `custom` is credentials-only.
- Add a "Set one value for all three" table showing how a single `scope` value
  expands per resource; keep the product-shape combinations table.
- Fix an accuracy bug: `scope: "organization"` resolves credentials to `none`,
  not `agent` (verified against dev84 `_SCOPE_AXES`).

Values and per-resource behavior sourced from managed-deepagents==0.5.0.dev84
(identity/__init__.py type aliases and identity/options.py). Docs-review change,
not a technical migration change.
@github-actions github-actions Bot added langsmith For docs changes to LangSmith internal labels Aug 3, 2026
@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-fjmorr-1785791407-cdd2734

Site preview: https://langchain-5e9cc07a-preview-fjmorr-1785791407-cdd2734.mintlify.site

Important

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

@fjmorris

Copy link
Copy Markdown
Contributor Author

Closed in favor of #5272

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal langsmith For docs changes to LangSmith

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant