Struct GenAiSpanBuilder 

pub struct GenAiSpanBuilder { /* private fields */ }

Available on crate feature telemetry only.

Builder for creating model call spans with full OTel GenAI semconv attributes.

Providers use this to construct spans with all available metadata. Fields not set are omitted from the span (recorded as Empty).

Example

use adk_telemetry::semconv::{GenAiSpanBuilder, GenAiProvider, GenAiOperation};

let span = GenAiSpanBuilder::new(GenAiProvider::Gemini, GenAiOperation::Chat, "gemini-2.5-flash")
    .stream(true)
    .temperature(0.7)
    .max_tokens(4096)
    .build();

Implementations

impl GenAiSpanBuilder

pub fn new( provider: GenAiProvider, operation: GenAiOperation, model: impl Into<String>, ) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Create a new span builder with required fields.

pub fn stream(self, stream: bool) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set whether this is a streaming request.

pub fn temperature(self, temp: f64) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set the temperature parameter.

pub fn max_tokens(self, max: i64) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set the max tokens parameter.

pub fn top_p(self, p: f64) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set the top_p parameter.

pub fn top_k(self, k: f64) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set the top_k parameter.

pub fn conversation_id(self, id: impl Into<String>) -> GenAiSpanBuilder

Available on crate feature genai-semconv only.

Set the conversation/session ID for correlation.

pub fn build(self) -> Span

Available on crate feature genai-semconv only.

Build and return the tracing Span.

The span name follows the pattern: gen_ai.{operation_name} {model}. All gen_ai.* response and usage fields are pre-declared as Empty so they can be recorded later via GenAiResponseRecorder.