Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex AI Studio
    • About Yandex AI Studio
    • Yandex Workflows
    • Quotas and limits
    • Terms and definitions
  • Compatibility with OpenAI
    • About Yandex Cloud ML SDK
      • Overview
      • Authentication
        • Overview
        • Assistant types
        • Tools
        • Operation
        • Tuning
        • Result types for models
        • Datasets
        • Search API
        • Messages
        • Run types
        • Search index types
        • Other types
        • Batch
      • Request retries
  • Access management
  • Pricing policy
  • Audit Trails events
  • Public materials
  • Release notes

In this article:

  • class yandex_cloud_ml_sdk._runs.status.BaseRunStatus
  • class yandex_cloud_ml_sdk._runs.status.RunStatus
  • class yandex_cloud_ml_sdk._runs.status.StreamEvent
  • class yandex_cloud_ml_sdk._runs.result.RunResult
  • class yandex_cloud_ml_sdk._runs.result.RunStreamEvent
  1. Yandex Cloud ML SDK
  2. SDK reference
  3. Types
  4. Run types

Run types

Written by
Yandex Cloud
Updated at November 7, 2025
  • class yandex_cloud_ml_sdk._runs.status.BaseRunStatus
  • class yandex_cloud_ml_sdk._runs.status.RunStatus
  • class yandex_cloud_ml_sdk._runs.status.StreamEvent
  • class yandex_cloud_ml_sdk._runs.result.RunResult
  • class yandex_cloud_ml_sdk._runs.result.RunStreamEvent

class yandexcloudmlsdk.runs.status.BaseRunStatusclass yandex_cloud_ml_sdk._runs.status.BaseRunStatus

Class for run status enumerations.

property is_failed: bool

Check if operation execution failed.

property is_finished: bool

Check if operation execution finished.

property is_running: bool

Check if operation execution is still in progress.

property is_succeeded: bool

Check if operation execution completed successfully.

property status_name: str

Get operation execution status name.

class yandexcloudmlsdk.runs.status.RunStatusclass yandex_cloud_ml_sdk._runs.status.RunStatus

Enumeration of possible run statuses.

UNKNOWN = -1

Unknown status (-1)

RUN_STATUS_UNSPECIFIED = 0

Status not specified

PENDING = 1

Status not specified

IN_PROGRESS = 2

Run is in progress

FAILED = 3

Run has failed

COMPLETED = 4

Run completed successfully

TOOL_CALLS = 5

Run requires tool calls

property is_running: bool

Check if operation execution is still in progress.

property is_succeeded: bool

Check if operation execution completed successfully.

property is_failed: bool

Check if operation execution failed.

__new__(value)

class yandexcloudmlsdk.runs.status.StreamEventclass yandex_cloud_ml_sdk._runs.status.StreamEvent

Enumeration of possible stream events during run execution.

UNKNOWN = -1

Unknown event type (-1)

EVENT_TYPE_UNSPECIFIED = 0

Event type not specified

PARTIAL_MESSAGE = 1

Partial message content

ERROR = 2

Error occurred

DONE = 3

Execution completed

TOOL_CALLS = 4

Tool calls required

property is_running: bool

Check if operation execution is still in progress.

property is_succeeded: bool

Check if operation execution completed successfully.

property is_failed: bool

Check if operation execution failed.

__new__(value)

class yandexcloudmlsdk.runs.result.RunResultclass yandex_cloud_ml_sdk._runs.result.RunResult

RunResult(status: ‘StatusTypeT’, error: ‘str | None’, tool_calls: ‘ToolCallList[ProtoAssistantToolCallList, ToolCallTypeT] | None’, _message: ‘MessageTypeT | None’, usage: ‘Usage | None’)

usage: Usage | None

Token usage statistics

property citations: tuple[Citation]... ,

Return citations from the assistant’s message if present.

Citations refer to references to external sources or documents that the model used to generate its response. These typically include: - Source document IDs - Document titles or descriptions - Relevant snippets or passages Returns None if no citations are present in the message.

property is_failed: bool

Check if operation execution failed.

property is_finished: bool

Check if operation execution finished.

property is_running: bool

Check if operation execution is still in progress.

property is_succeeded: bool

Check if operation execution completed successfully.

property message: MessageTypeT | None

Get the message result of the run. If run has failed this property raise error value.

property parts: tuple[Any]... ,

Get message parts if available, otherwise return nothing.

property status_name: str

Get operation execution status name.

property text: str | None

Get the text content of the message if available, otherwise return nothing.

status: StatusTypeT

Run status

error: str | None

Error message if run failed

tool_calls: ToolCallList[ToolCallList, ToolCallTypeT] | None

List of tool calls if any

class yandexcloudmlsdk.runs.result.RunStreamEventclass yandex_cloud_ml_sdk._runs.result.RunStreamEvent

Represents a streaming event in a run execution process.

This class encapsulates all possible events that can occur during streaming execution of a run, including: - Partial and completed messages - Errors that may occur during execution - Tool calls initiated by the model

property is_failed: bool

Check if operation execution failed.

property is_finished: bool

Check if operation execution finished.

property is_running: bool

Check if operation execution is still in progress.

property is_succeeded: bool

Check if operation execution completed successfully.

property message: MessageTypeT | None

Get the message result of the run. If run has failed this property raise error value.

property parts: tuple[Any]... ,

Get message parts if available, otherwise return nothing.

property status_name: str

Get operation execution status name.

property text: str | None

Get the text content of the message if available, otherwise return nothing.

status: StatusTypeT

Run status

error: str | None

Error message if run failed

tool_calls: ToolCallList[ToolCallList, ToolCallTypeT] | None

List of tool calls if any

Was the article helpful?

Previous
Messages
Next
Search index types
© 2025 Direct Cursus Technology L.L.C.