> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fiddler.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Complete API reference for fiddler-strandsagents

[![PyPI](https://img.shields.io/pypi/v/fiddler-strands)](https://pypi.org/project/fiddler-strands/)

## Overview

Complete API reference documentation for the `fiddler-strands` package, which
instruments the [Strands Agents SDK](https://strandsagents.com/) and exports
OpenTelemetry traces to Fiddler.

The package is published to PyPI as **`fiddler-strands`** and imported in
Python as **`fiddler_strandsagents`**:

```bash theme={null}
pip install fiddler-strands
```

```python theme={null}
from fiddler_strandsagents import StrandsAgentInstrumentor
```

## Components

### Conversation And Session

Conversation and session attribute helpers. `set_conversation_id` / `get_conversation_id` set and read the conversation ID for the current execution context. `set_session_attributes` / `get_session_attributes` replace and read the session attribute dict for the current context.

* [get\_conversation\_id](/sdk-api/strands/get-conversation-id)
* [get\_session\_attributes](/sdk-api/strands/get-session-attributes)
* [set\_conversation\_id](/sdk-api/strands/set-conversation-id)
* [set\_session\_attributes](/sdk-api/strands/set-session-attributes)

### Instrumentation

`StrandsAgentInstrumentor` installs Fiddler tracing into the Strands Agents runtime. `FiddlerInstrumentationHook` is the Strands hook used internally by the instrumentor.

* [FiddlerInstrumentationHook](/sdk-api/strands/fiddler-instrumentation-hook)
* [StrandsAgentInstrumentor](/sdk-api/strands/strands-agent-instrumentor)

### Llm Context

`set_llm_context` attaches context (e.g. retrieved documents) to a Strands `Model` so it appears on its LLM spans. `clear_llm_context` removes previously set LLM context. `get_llm_context` reads the current LLM context for a model.

* [clear\_llm\_context](/sdk-api/strands/clear-llm-context)
* [get\_llm\_context](/sdk-api/strands/get-llm-context)
* [set\_llm\_context](/sdk-api/strands/set-llm-context)

### Span Attributes

`set_span_attributes` and `get_span_attributes` set and read per-span custom attributes.

* [get\_span\_attributes](/sdk-api/strands/get-span-attributes)
* [set\_span\_attributes](/sdk-api/strands/set-span-attributes)

### Span Processor

`StrandsSpanProcessor` propagates parent attributes and patches Strands' missing `gen_ai.system.message` event. `FiddlerSpanProcessor` is a backwards-compatible alias for `StrandsSpanProcessor` (same class object).

* [FiddlerSpanProcessor](/sdk-api/strands/fiddler-span-processor)
* [StrandsSpanProcessor](/sdk-api/strands/strands-span-processor)