Exceptions

All SDK exceptions inherit from ToolboxError.

Exception Hierarchy

ToolboxError
├── NotConfiguredError   — configure() not called, or missing required args
├── DatabaseError        — DB operation failed (upsert, schema mismatch, ...)
├── EmbeddingError       — HTTP call to embedding endpoint failed
└── ChunkingError        — text chunking produced an unexpected result

RateLimitExhausted (in chatbot_plugin_sdk.rate_limit) inherits directly from Exception so callers can catch it independently of storage errors.

---

chatbot_plugin_sdk.exceptions.ToolboxError

Bases: Exception

Base exception for all SDK errors.

chatbot_plugin_sdk.exceptions.NotConfiguredError

Bases: ToolboxError

Raised when a required SDK setting is missing.

chatbot_plugin_sdk.exceptions.DatabaseError

Bases: ToolboxError

Raised when a database operation fails.

chatbot_plugin_sdk.exceptions.EmbeddingError

Bases: ToolboxError

Raised when embedding model call fails.

chatbot_plugin_sdk.exceptions.ChunkingError

Bases: ToolboxError

Raised when text chunking fails.

chatbot_plugin_sdk.rate_limit.RateLimitExhausted

Bases: Exception

Raised when the daily request cap (rpd) is reached.

Callers may catch this to fall back to a different provider or abort.