Strands Agents

Overview

Strands Agents is an open-source SDK from AWS for building and running AI agents. It emits OpenTelemetry spans natively using the OTel GenAI semantic conventions, making it straightforward to integrate with Confident AI for real-time tracing and evaluation.

The integration works via OpenTelemetry: instrument_strands() registers a StrandsSpanInterceptor and a ContextAwareSpanProcessor on the global TracerProvider. Strands’ built-in tracer picks up the provider automatically — so you only need to call instrument_strands() once before creating your Agent, and all spans flow to Confident AI in real time.

Tracing Quickstart

$
export CONFIDENT_OTEL_URL="https://eu.otel.confident-ai.com"

$
pip install -U deepeval strands-agents opentelemetry-sdk opentelemetry-exporter-otlp-proto-http

1
from strands import Agent
2
from deepeval.integrations.strands import instrument_strands
3
4
instrument_strands()
5
6
agent = Agent(model="us.amazon.nova-lite-v1:0")
7
result = agent("Explain OpenTelemetry in one sentence.")
8
print(result.message)

$
python main.py

What Gets Captured

The Strands integration automatically extracts the following data from each span:

Token counts are read from gen_ai.usage.input_tokens / gen_ai.usage.output_tokens (and the prompt_tokens / completion_tokens aliases). The LLM provider is inferred from the model name, or read directly from gen_ai.response.provider when available.

Advanced Usage

Logging threads

Threads group related traces together and are useful for chat apps, agents, or any multi-turn interactions. You can learn more about threads here. Pass thread_id to instrument_strands.

1
from strands import Agent
2
from deepeval.integrations.strands import instrument_strands
3
4
instrument_strands(
5
    thread_id="conversation-abc123",
6
    user_id="user_1",
7
)
8
9
agent = Agent(model="us.amazon.nova-lite-v1:0")
10
result = agent("What's the capital of France?")
11
print(result.message)

Trace attributes

All trace-level attributes are optional and apply to every trace produced while the instrumentation is active.

1
from strands import Agent
2
from deepeval.integrations.strands import instrument_strands
3
4
instrument_strands(
5
    name="My Strands Agent",
6
    tags=["production", "v2"],
7
    metadata={"region": "us-east-1"},
8
    user_id="user_1",
9
    thread_id="conversation-abc123",
10
    environment="production",
11
)
12
13
agent = Agent(model="us.amazon.nova-lite-v1:0")
14
result = agent("Summarize the latest AI news.")
15
print(result.message)

Logging prompts

If you are managing prompts on Confident AI and wish to log them, use next_llm_span to associate a Prompt with the next LLM span before invoking your agent.

1
from strands import Agent
2
from deepeval.prompt import Prompt
3
from deepeval.tracing import next_llm_span
4
from deepeval.integrations.strands import instrument_strands
5
6
instrument_strands(environment="production")
7
8
agent = Agent(model="us.amazon.nova-lite-v1:0")
9
10
prompt = Prompt(alias="<prompt-alias>")
11
prompt.pull(version="00.00.01")
12
13
with next_llm_span(prompt=prompt):
14
    result = agent(prompt.interpolate())
15
print(result.message)

Using with tools

The integration captures tool spans automatically. Define tools with the @tool decorator and pass them to your Agent as usual.

1
from strands import Agent
2
from strands.tools import tool
3
from deepeval.integrations.strands import instrument_strands
4
5
instrument_strands(environment="production")
6
7
@tool
8
def get_weather(city: str) -> str:
9
    """Get the current weather for a city."""
10
    return f"The weather in {city} is sunny and 22°C."
11
12
agent = Agent(
13
    model="us.amazon.nova-lite-v1:0",
14
    tools=[get_weather],
15
)
16
17
result = agent("What's the weather like in Paris?")
18
print(result.message)

Each tool invocation produces a tool span with the tool name and input parameters captured automatically.

Using with observe

When instrument_strands is called inside an active deepeval @observe / with trace(...) context, Strands’ OTel spans are stitched into the enclosing deepeval trace. update_current_span(...) and update_current_trace(...) work anywhere in the call stack.

1
from strands import Agent
2
from deepeval import observe
3
from deepeval.integrations.strands import instrument_strands
4
5
instrument_strands()
6
7
agent = Agent(model="us.amazon.nova-lite-v1:0")
8
9
@observe(name="my-app")
10
def run_pipeline(prompt: str) -> str:
11
    # Strands spans are stitched into this @observe trace automatically
12
    result = agent(prompt)
13
    return result.message

Evals Usage

Online evals

You can run online evals on your Strands agent, which will run evaluations on all incoming traces on Confident AI’s servers. This approach is recommended if your agent is in production.

1
from strands import Agent
2
from deepeval.integrations.strands import instrument_strands
3
4
instrument_strands(
5
    metric_collection="my-trace-collection",
6
    environment="production",
7
)
8
9
agent = Agent(model="us.amazon.nova-lite-v1:0")
10
result = agent("Summarize the latest AI news.")
11
print(result.message)

You can view evals on Confident AI by clicking on the link in the output printed in the console.