Skip to main content
This asynchronous HTTP client reads persisted evidence and starts or polls trace evaluations independently of trace export. It reuses an existing tracing client’s resolved endpoint, API key, and project, with a separate lifecycle. Close it separately when you supply it to Reflect. The SDK currently exposes trace reads and trace evaluation resources. The HTTP API also documents operations such as sessions and monitors that are not typed SDK resources here. All timeouts and polling intervals are seconds. Safe GETs have bounded retries; evaluation creation is sent once because the server has no idempotency-key contract. Poll the returned run ID. An uncertain create outcome must not be automatically retried. wait_visible / waitVisible waits for a terminal persisted trace, including an error trace. Evaluation wait requires usable scores for every requested trace/metric pair; terminal status alone is insufficient. Missing, duplicate, nonnumeric, or failed evidence does not become a passing result.

On this page

Evaluations, PlatformClient, PlatformOptions, RequestOptions, Traces.

Example

This creates a real evaluation run for an existing trace. traceId is a persisted task trace UUID from the same project.

Evaluations

Source declaration

Constructor

Methods

Returns the supported trace metric metadata from the platform.
Creates one batch trace-evaluation run. Deduplicates trace IDs and metric names and requires nonempty inputs. Creation is never automatically retried.
Fetches one evaluation run and verifies its identity. A RUNNING or PENDING result is not complete evidence.
Fetches the score records for an evaluation run; use wait to require a complete usable set.

PlatformClient

Native, independently owned platform requests. All durations are seconds. Source declaration

Constructor

Fields and properties

Methods

PlatformOptions

Source declaration

Fields and properties

RequestOptions

Source declaration

Fields and properties

Traces

Source declaration

Constructor

Methods

Fetches one trace with span evidence and verifies that the returned trace ID matches the requested ID.
Returns a page of trace summaries. Limit must be 1–200 and offset must be nonnegative.
Iterates trace summaries in pages, stopping at the configured maximum or the end of the server result.

Signatures and fields are generated from the SDK source. See the import index for available entry points.