Skip to content

Add span types documentation page#121

Open
laminar-coding-agent[bot] wants to merge 1 commit into
mainfrom
agent/lam-1408/span-type-section/5724e1
Open

Add span types documentation page#121
laminar-coding-agent[bot] wants to merge 1 commit into
mainfrom
agent/lam-1408/span-type-section/5724e1

Conversation

@laminar-coding-agent

@laminar-coding-agent laminar-coding-agent Bot commented Apr 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new dedicated /tracing/structure/span-types page that comprehensively documents each span type (DEFAULT, LLM, TOOL, EXECUTOR)
  • Emphasizes that tool call spans should be typed as TOOL for better visibility in the trace view and queryability in the SQL editor
  • Covers why typing matters, how to set types via @observe and manual spans, includes a full agent-with-tools example, and shows SQL queries for TOOL spans
  • Updates manual-span-creation.mdx to replace the brief inline span types list with a link to the new page
  • Adds a "Mark spans as tool calls or LLM calls" entry to the overview quick reference table

Resolves LAM-1408

Test plan

  • Verify the new page renders correctly on Mintlify (navigation, tabs, code blocks, tables)
  • Confirm the navigation entry appears in the correct position in the sidebar
  • Check that links from overview and manual-span-creation correctly point to the new page

🤖 Generated with Claude Code


Note

Low Risk
Low risk documentation-only change; main risk is broken Mintlify nav/linking or formatting issues in the new page.

Overview
Adds a new tracing/structure/span-types documentation page describing when to use DEFAULT, LLM, TOOL, and EXECUTOR, including examples for setting span type via observe/manual spans and sample SQL queries for TOOL spans.

Updates the sidebar (docs.json) and the Tracing Structure overview/manual-span docs to link to this new guide (replacing the prior brief inline span-type blurb and adding a quick-reference entry).

Written by Cursor Bugbot for commit 3cfc154. This will update automatically on new commits. Configure here.

Adds a comprehensive /tracing/structure/span-types page that explains
each span type (DEFAULT, LLM, TOOL, EXECUTOR) with emphasis on properly
typing tool call spans as TOOL for better visibility and queryability.
Updates manual-span-creation to link to the new page and adds a quick
reference entry in the overview.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant