Function choice_body

src/google/adk/telemetry/_stable_semconv.py:113–146

Builds the body for a `gen_ai.choice` log event. ADK always returns a single candidate, so `index` is always 0. `finish_reason` is included only when present on the response. Args: llm_response: The LLM response describing the choice. do_not_elide_content: When True, always include t

(
    llm_response: LlmResponse | None,
    telemetry_config: TelemetryConfig,
    *,
    do_not_elide: bool = False,
)

def choice_body(
    llm_response: LlmResponse | None,
    telemetry_config: TelemetryConfig,
    *,
    do_not_elide: bool = False,
) -> Mapping[str, AnyValue]:
  """Builds the body for a `gen_ai.choice` log event.

  ADK always returns a single candidate, so `index` is always 0.
  `finish_reason` is included only when present on the response.

  Args:
    llm_response: The LLM response describing the choice.
    do_not_elide_content: When True, always include the content regardless of
      the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` env var.
  """
  if llm_response is None:
    return {"content": None, "index": 0}
  body: dict[str, AnyValue] = {
      "content": _serialize_content_with_optional_elision(
          llm_response.content,
          capture_content=do_not_elide
          or telemetry_config.should_add_content_to_logs,
      ),
      "index": 0,  # ADK always returns a single candidate.
  }
  if llm_response.finish_reason is not None:
    finish_reason = llm_response.finish_reason
    body["finish_reason"] = (
        finish_reason.value
        if hasattr(finish_reason, "value")
        else str(finish_reason)
    )
  return body