docs(agent-tracing): Normalize GenAI developer conventions

[sentry-junior]

DESCRIBE YOUR PR

Moves the developer conventions portion of #19459 into a separate PR so the 404 workflow does not build both docs sites in the same job.

Normalizes current GenAI attribute names, clarifies message part shapes, and fixes cached and reasoning token subset references in the AI Agents module.

Part of TET-2938.

IS YOUR CHANGE URGENT?

• Urgent deadline (GA date, etc.): YYYY-MM-DD
• Other deadline: YYYY-MM-DD
• No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

via Ogi.

--

View Junior Session [Sentry]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Sep 17, 2026 3:06pm UTC
sentry-docs	Ready	Preview	Sep 17, 2026 3:06pm UTC

[linear-code]

TET-2938

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 4285b1e. Configure here.}

[sentry-junior]

Closing as superseded. Everything in this PR has either landed or moved:

• The AI Agents doc changes landed in docs(agent-tracing): Update GenAI conventions #19509.
• The cross-site link handling in scripts/lint-404s was fixed differently in fix(ci): Handle developer docs links in 404 lint #19526. It reads the site's address from the sitemap, so the --internal-hostname flag isn't needed.
• The workflow change that builds and lints docs and developer docs one after the other is now in fix(ci): Lint docs and developer docs in separate jobs #19830, rebuilt on current master.

Thanks for the review, @vgrozdanic. #19830 keeps the same cleanup behavior you approved here.