gen_ai_hub.orchestration_v2.exceptions module

Exceptions for the orchestration service module.

exception gen_ai_hub.orchestration_v2.exceptions.OrchestrationError(request_id: str, headers: Headers, message: str, code: int, location: str, intermediate_results: ModuleResults | dict, retries: int = 0)

Bases: Exception

This exception is raised when an error occurs during the execution of the orchestration service, typically due to incorrect usage, invalid configurations, or issues with run parameters defined by the user.

__init__(request_id: str, headers: Headers, message: str, code: int, location: str, intermediate_results: ModuleResults | dict, retries: int = 0)

Initializes the OrchestrationError with detailed context.

Parameters:

  • request_id (str) – unique identifier for the request that encountered the error.

  • headers (httpx.Headers) – HTTP headers associated with the request, useful in case of e.g. rate limiting..

  • message (str) – Detailed error message describing the issue.

  • code (int) – Error code associated with the specific type of failure.

  • location (str) – Specific component or step in the orchestration process where the error occurred.

  • intermediate_results (ModuleResults) – State information and partial results from various modules at the time of the error, useful for debugging.

  • retries (int, optional) – Number of retries attempted before the error was raised.

  • errors (Optional[list[dict[str, Any]]]) – Raw error payload(s) from the API. Can contain multiple errors.

exception gen_ai_hub.orchestration_v2.exceptions.OrchestrationErrorList(errors: list[OrchestrationError])

Bases: Exception

__init__(errors: list[OrchestrationError])