Skip to main content

aip_sdk.RunSummary

aip_sdk.RunSummary(id: str, pipeline: str, status: str, runner_mode: str, project_id: str | None, dataset_id: str | None, dataset_version_id: str | None, sut_id: str | None, connection_id: str | None, error: str | None, created_at: datetime | None, updated_at: datetime | None, started_at: datetime | None, completed_at: datetime | None, user_id: str | None = None, attribution_reported: bool = True, span_table_id: str | None = None, test_plan_id: str | None = None)

A single run record from a run listing.

A read-only snapshot of a run as returned by aip.list_runs(). Use id with aip.get_run() to attach to the run and read its results.

Attributes

  • id str: Run identifier.
  • pipeline str: Pipeline that produced the run (e.g. "evaluate_sut_hosted", "metric_invoke").
  • status str: Run status — one of "pending", "claimed", "running", "completed", "retryable_failed", "failed", or "cancelled".
  • runner_mode str: Where the run executed — "hosted" or "external".
  • project_id str | None: Project the run belongs to, if any.
  • dataset_id str | None: Dataset scored by the run, if any.
  • dataset_version_id str | None: Specific dataset version scored, if any.
  • sut_id str | None: SUT associated with the run, if any.
  • connection_id str | None: SUT connection used, if any.
  • error str | None: Failure reason for a failed run; None otherwise.
  • created_at datetime | None: When the run was created.
  • updated_at datetime | None: When the run was last updated.
  • started_at datetime | None: When execution began, if it has.
  • completed_at datetime | None: When execution finished, if it has.
  • user_id str | None: User attribution recorded for the run. None means unattributed. This includes historical runs, admin or service callers that named no target user, and runs created by automated trace ingestion. A rerun inherits the source run's user, so this is who the run is attributed to, not a record of who triggered it.
  • attribution_reported bool: Whether the server reported attribution for this run at all. False against a platform predating the field, where user_id is None on every run and means "not reported" rather than "unattributed" — check this before reading a fleet-wide None as a real attribution gap.
  • span_table_id str | None: Opaque token identifying the span table this run scored. Two agent-trace runs are row-comparable only when this matches, since span ids are minted per ingest. None for a run outside the agent-trace schema. Compare tokens for equality; the value has no other meaning.
  • test_plan_id str | None: Id of the test plan version that supplied this run's evaluation config, None when no plan governed it. Read the plan by this id for what that version holds.

aip_sdk.RunSummary.attribution_reported​

aip_sdk.RunSummary.attribution_reported: bool = True

No docstring is defined in the source.

aip_sdk.RunSummary.completed_at​

aip_sdk.RunSummary.completed_at: datetime | None

No docstring is defined in the source.

aip_sdk.RunSummary.connection_id​

aip_sdk.RunSummary.connection_id: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.created_at​

aip_sdk.RunSummary.created_at: datetime | None

No docstring is defined in the source.

aip_sdk.RunSummary.dataset_id​

aip_sdk.RunSummary.dataset_id: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.dataset_version_id​

aip_sdk.RunSummary.dataset_version_id: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.error​

aip_sdk.RunSummary.error: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.id​

aip_sdk.RunSummary.id: str

No docstring is defined in the source.

aip_sdk.RunSummary.pipeline​

aip_sdk.RunSummary.pipeline: str

No docstring is defined in the source.

aip_sdk.RunSummary.project_id​

aip_sdk.RunSummary.project_id: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.runner_mode​

aip_sdk.RunSummary.runner_mode: str

No docstring is defined in the source.

aip_sdk.RunSummary.span_table_id​

aip_sdk.RunSummary.span_table_id: str | None = None

No docstring is defined in the source.

aip_sdk.RunSummary.started_at​

aip_sdk.RunSummary.started_at: datetime | None

No docstring is defined in the source.

aip_sdk.RunSummary.status​

aip_sdk.RunSummary.status: str

No docstring is defined in the source.

aip_sdk.RunSummary.sut_id​

aip_sdk.RunSummary.sut_id: str | None

No docstring is defined in the source.

aip_sdk.RunSummary.test_plan_id​

aip_sdk.RunSummary.test_plan_id: str | None = None

No docstring is defined in the source.

aip_sdk.RunSummary.updated_at​

aip_sdk.RunSummary.updated_at: datetime | None

No docstring is defined in the source.

aip_sdk.RunSummary.user_id​

aip_sdk.RunSummary.user_id: str | None = None

No docstring is defined in the source.