feat: trace provider interface#140
Merged
afarntrog merged 5 commits intostrands-agents:mainfrom Feb 20, 2026
Merged
Conversation
Introduce an abstract TraceProvider base class for retrieving agent trace data from observability backends for evaluation. This includes: - TraceProvider ABC with get_session, list_sessions, and get_session_by_trace_id methods - SessionFilter dataclass for filtering session discovery - Custom error hierarchy (TraceProviderError, SessionNotFoundError, TraceNotFoundError, ProviderError) - Session and Trace data types with span tree construction and convenience accessors (input/output messages, token usage, duration) - New providers module exposed at package level - Comprehensive unit tests for providers and trace types
Add abstract TraceProvider that retrieves agent trace data from observability backends and returns Session/Trace types the evals system already consumes. - TraceProvider ABC with get_session() (required), list_sessions() and get_session_by_trace_id() (optional, raise NotImplementedError) - SessionFilter dataclass for time-range and limit-based discovery - Exception hierarchy: TraceProviderError base with SessionNotFoundError, TraceNotFoundError, ProviderError - Export providers module from strands_evals package
afarntrog
temporarily deployed
to
auto-approve
GitHub Actions
Inactive
afarntrog
changed the title
Add abstract TraceProvider that retrieves agent trace data from observability backends and returns Session/Trace types the evals system already consumes. - TraceProvider ABC with get_session() (required), list_sessions() and get_session_by_trace_id() (optional, raise NotImplementedError) - SessionFilter dataclass for time-range and limit-based discovery - Exception hierarchy: TraceProviderError base with SessionNotFoundError, TraceNotFoundError, ProviderError - Export providers module from strands_evals package
afarntrog
temporarily deployed
to
auto-approve
GitHub Actions
Inactive
afarntrog
temporarily deployed
to
auto-approve
GitHub Actions
Inactive
JackYPCOnline
previously approved these changes
Feb 17, 2026
Unshure
reviewed
Feb 19, 2026
Unshure
reviewed
Feb 20, 2026
…sionFilter Remove SessionFilter dataclass, list_sessions(), and get_evaluation_data_by_trace_id() from TraceProvider to keep the interface minimal. Only the core get_evaluation_data() abstract method remains. Associated tests and public exports are updated accordingly.
afarntrog
temporarily deployed
to
auto-approve
GitHub Actions
Inactive
Contributor
Author
|
Discussion on how to further expand this interface in the future: #143 |
Unshure
approved these changes
Feb 20, 2026
Merged
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add TraceProvider interface for observability backends
Add abstract TraceProvider that retrieves agent trace data from
observability backends and returns Session/Trace types the evals
system already consumes.
and get_session_by_trace_id() (optional, raise NotImplementedError)
SessionNotFoundError, TraceNotFoundError, ProviderError
Related Issues
#97
Documentation PR
Type of Change
New feature
Testing
How have you tested the change? Verify that the changes do not break functionality or introduce warnings in consuming repositories: agents-docs, agents-tools, agents-cli
hatch run prepareChecklist
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.