Skip to content

Document user data toggle and conversation title in Agent Builder traces - #8094

Open
charlotte-hoblik wants to merge 5 commits into
mainfrom
AB-traces-1621
Open

Document user data toggle and conversation title in Agent Builder traces#8094
charlotte-hoblik wants to merge 5 commits into
mainfrom
AB-traces-1621

Conversation

@charlotte-hoblik

Copy link
Copy Markdown
Contributor

Summary

Documents two 9.6 additions to Agent Builder trace collection, both already live on Serverless:

  • agentBuilder:tracing:includeUserData (kibana#282858) — new privacy toggle recording user.id and user.name, replacing the user.hash kept by default.
  • elastic.conversation.title (kibana#281166) — conversation title span attribute, gated by includeRealNames.

kibana#281166 also renamed the includeRealNames setting, so that row is version-scoped rather than overwritten. The page covers 9.5+ and both labels have to coexist.

collect-traces.md

  • New includeUserData row, scoped stack: ga 9.6+ / serverless: ga.
  • includeRealNames row carries both the 9.5 and 9.6 labels. Corrected its effect: it also governs workflow names, tool definitions and tool descriptions, and rewrites span names.
  • Noted that includeRealIds also controls the agent ID and workflow execution ID, which its label omits.
  • Added the conversation round span to the span content list. It is the only span carrying the title and user fields.
  • Documented attributes.kibana.inference.root as the way to select it, since generate_title is also a CHAIN span and carries neither.
  • Anonymization note now gives the concrete ID formats, and flags that user.id is the one case where anonymizing changes the field name.
  • Noted that setting changes affect new traces only.
  • New screenshot and alt text, seven toggles.

agent-traces-dashboard.md

  • New User attributes section with the three fields and their required settings.
  • attributes.user.hash is stable per user, so per-user dashboards work without enabling user data.
  • Added elastic.conversation.title and kibana.inference.root to the attribute reference.
  • Noted that span.name is anonymized along with the attributes.

Relates to elastic/docs-content-internal#1621

@charlotte-hoblik charlotte-hoblik self-assigned this Aug 26, 2026
@charlotte-hoblik
charlotte-hoblik requested a review from a team as a code owner August 26, 2026 10:06
@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant