aip_sdk.promote_trace_version

aip_sdk.promote_trace_version(version_id: str, *, client: APIClient | None = None) -> TraceCurrentVersion

Choose which version of a trace dataset its metrics score, stepping back whichever was.

Attaching ground truth already hands currency to the version it derives, so this is for the cases that are not that — going back to the un-annotated version, or selecting a derivation built from a version that was not current at the time.

Parameters

• version_id str: Dataset version to make current.
• client APIClient | None: Optional API client.

Returns

• TraceCurrentVersion: The version metrics now score.

Raises

• AuthError: If credentials are missing or invalid.
• ForbiddenError: If the caller lacks editor rights on the version's workspace.
• NotFoundError: If the dataset version does not exist.
• UnprocessableEntityError: If the version is not an agent-trace version, or is already the version metrics score.
• ResponseParseError: If the platform's response does not match this SDK version.