Skip to content

Agent Object Errors

consortium.server.exceptions.object_exceptions.agent_object_exceptions

AgentsObjectError(message='', detail=None)

Bases: BaseObjectError

Base exception for all errors raised by agent objects.

Attributes:

Name Type Description
code

A stable machine-readable string identifying the specific error.

message str

A human-readable description of what went wrong and, where possible, how to resolve it.

detail dict[str, JsonValue] | None

Optional structured context about the error, or None when there is none.

code = 'AGENTS_OBJECT_ERROR' class-attribute instance-attribute

AgentTaskNotFoundError(task_id)

Bases: AgentsObjectError

Raised when the requested task for a particular agent was not found.

code = 'AGENT_TASK_NOT_FOUND_ERROR' class-attribute instance-attribute

AgentTaskingError(message='', detail=None)

Bases: AgentsObjectError

Base exception for errors raised while tasking an agent.

code = 'AGENT_TASKING_ERROR' class-attribute instance-attribute

AgentCapabilityNotFoundError(command, agent_str, agent_type_str)

Bases: AgentTaskingError

Raised when the agent tasking references a command that does not match any capability of the agent's type.

code = 'AGENT_CAPABILITY_NOT_FOUND_ERROR' class-attribute instance-attribute

AgentCapabilityOptionNotFoundError(command, option_name, agent_str, agent_type_str)

Bases: AgentTaskingError

Raised when the agent tasking references an option that does not match any option of the agent capability.

code = 'AGENT_CAPABILITY_OPTION_NOT_FOUND_ERROR' class-attribute instance-attribute

AgentCapabilityValidatingFunctionError(agent_str, command, error_message, detail=None)

Bases: AgentTaskingError

Raised when an agent capability rejects its resolved arguments.

code = 'AGENT_CAPABILITY_VALIDATING_FUNCTION_ERROR' class-attribute instance-attribute

MissingRequiredAgentCapabilityOptionError(agent_str, agent_capability_name, option_name)

Bases: AgentTaskingError

Raised when a required option for an agent capability was not provided in the agent tasking.

code = 'MISSING_REQUIRED_AGENT_CAPABILITY_OPTION_ERROR' class-attribute instance-attribute

AgentCapabilityOptionValueValidationError(agent_str, option_name, option_value, error_message)

Bases: AgentTaskingError

Raised when the provided value for an agent capability option fails validation during agent tasking.

code = 'AGENT_CAPABILITY_OPTION_VALUE_VALIDATION_ERROR' class-attribute instance-attribute

AgentCreationError(message='', detail=None)

Bases: AgentsObjectError

Base exception for errors raised while creating an agent.

code = 'AGENT_CREATION_ERROR' class-attribute instance-attribute

AgentCreationParameterTypeError(parameter_name=None, parameter_type=None)

Bases: AgentCreationError

Raised when a parameter provided during agent creation is not of the expected type.

code = 'AGENT_CREATION_PARAMETER_TYPE_ERROR' class-attribute instance-attribute

AgentTypeResolutionError(message='', detail=None)

Bases: AgentCreationError

Raised when the agent's type could not be resolved during agent creation.

code = 'AGENT_TYPE_RESOLUTION_ERROR' class-attribute instance-attribute