For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Welcome
    • Contributing
  • Concepts
    • Columns
    • Seed Datasets
    • Agent Rollout Ingestion
    • Custom Columns
    • Validators
    • Processors
    • Person Sampling
    • Traces
    • Architecture & Performance
    • Deployment Options
    • Security
  • Tutorials
    • Overview
    • The Basics
    • Structured Outputs, Jinja Expressions, and Conditional Generation
    • Seeding with an External Dataset
    • Providing Images as Context
    • Generating Images
    • Image-to-Image Editing
  • Recipes
    • Recipe Cards
  • Plugins
    • Overview
    • Example Plugin
    • FileSystemSeedReader Plugins
    • Discover
  • Code Reference
    • Overview
      • Overview
      • models
      • mcp
      • column_configs
      • config_builder
      • data_designer_config
      • run_config
      • sampler_params
      • validator_params
      • seeds
      • processors
      • analysis
      • Config API
        • Analysis
        • Base
        • Column Configs
        • Column Types
        • Config Builder
        • Custom Column
        • Data Designer Config
        • Dataset Metadata
        • Default Model Settings
        • Errors
        • Exportable Config
        • Fingerprint
        • Interface
        • Mcp
        • Models
        • Preview Results
        • Processor Types
        • Processors
        • Run Config
        • Sampler Constraints
        • Sampler Params
        • Seed
        • Seed Source
        • Seed Source Dataframe
        • Seed Source Types
        • Testing
        • Utils
          • Code Lang
          • Constants
          • Errors
          • Image Helpers
          • Info
          • Io Helpers
          • Misc
          • Numerical Helpers
          • Trace Renderer
          • Trace Type
          • Type Helpers
          • Visualization
          • Warning Helpers
        • Validator Params
        • Version
  • Dev Notes
    • Overview
    • Have It Your Way
    • VLM Long Document Understanding
    • Push Datasets to Hugging Face Hub
    • Text-to-SQL for Nemotron Super
    • Async All the Way Down
    • Owning the Model Stack
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogoNeMo Data Designer
On this page
  • Module Contents
  • Classes
  • Functions
  • Data
  • API
Code ReferenceConfigConfig APIUtils

data_designer.config.utils.trace_renderer

||View as Markdown|
Previous

Numerical Helpers

Next

Trace Type

Module Contents

Classes

NameDescription
TraceToolCallFunctiondict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object’s (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)
TraceToolCalldict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object’s (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)
TraceContentBlockdict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object’s (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)
TraceMessagedict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object’s (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)
TraceRendererRenders LLM conversation traces for display_sample_record.

Functions

NameDescription
_extract_text_contentNone
_format_tool_call_argsNone
_build_html_blockNone

Data

logger _ROLE_STYLES _REASONING_LABEL_STYLE _REASONING_BODY_STYLE _TOOL_CALL_LABEL_STYLE _TOOL_CALL_BODY_STYLE RoleHtmlColor _ROLE_HTML_COLORS

API

1logger = getLogger(...)
1class data_designer.config.utils.trace_renderer.TraceToolCallFunction

Bases: typing.TypedDict

1name: str
1arguments: str
1class data_designer.config.utils.trace_renderer.TraceToolCall

Bases: typing.TypedDict

1id: str
1type: str
1function: data_designer.config.utils.trace_renderer.TraceToolCallFunction
1class data_designer.config.utils.trace_renderer.TraceContentBlock

Bases: typing.TypedDict

1type: str
1text: str
1class data_designer.config.utils.trace_renderer.TraceMessage

Bases: typing.TypedDict

1role: typing_extensions.Required[typing.Literal[system, user, assistant, tool]]
1content: typing_extensions.Required[list[data_designer.config.utils.trace_renderer.TraceContentBlock]]
1reasoning_content: str | None
1tool_calls: list[data_designer.config.utils.trace_renderer.TraceToolCall] | None
1tool_call_id: str | None
_ROLE_STYLES
dict[str, tuple[str, str]]
1_REASONING_LABEL_STYLE = italic bold medium_orchid1
1_REASONING_BODY_STYLE = italic medium_orchid1
1_TOOL_CALL_LABEL_STYLE = bold bright_yellow
1_TOOL_CALL_BODY_STYLE = bright_yellow
1RoleHtmlColor
_ROLE_HTML_COLORS
dict[str, data_designer.config.utils.trace_renderer.RoleHtmlColor]
1data_designer.config.utils.trace_renderer._extract_text_content(message: data_designer.config.utils.trace_renderer.TraceMessage) -> str
1data_designer.config.utils.trace_renderer._format_tool_call_args(raw_args: str) -> str
1class data_designer.config.utils.trace_renderer.TraceRenderer

Renders LLM conversation traces for display_sample_record.

1render_rich(
2 traces: list[data_designer.config.utils.trace_renderer.TraceMessage],
3 column_name: str
4) -> rich.panel.Panel

Return a Rich Panel containing the formatted trace conversation.

1render_notebook_html(
2 traces: list[data_designer.config.utils.trace_renderer.TraceMessage],
3 column_name: str
4) -> bool

Display HTML trace in Jupyter. Returns True if displayed, False otherwise.

1data_designer.config.utils.trace_renderer._build_html_block(
2 title: str,
3 body: str,
4 bg_color: data_designer.config.utils.trace_renderer.RoleHtmlColor,
5 *,
6 escape_body: bool = True
7) -> str