Error Handling

Error Types

The Narada SDK raises specific exceptions for different error conditions. All errors inherit from NaradaError.

from narada import (
    NaradaError,
    NaradaTimeoutError,
    NaradaUnsupportedBrowserError,
    NaradaExtensionMissingError,
    NaradaExtensionUnauthenticatedError,
    NaradaInitializationError
)

Error Handling Examples

Look at the following examples to see how to handle different errors.

NaradaTimeoutError

Raised when operations exceed timeout limits.

from narada import NaradaTimeoutError

try:
    response = await agent.run(
        prompt='find a specific element',
        timeout=30
    )
except NaradaTimeoutError:
    print("Operation timed out. Try increasing timeout or simplifying the task.")

NaradaUnsupportedBrowserError

Raised when using an unsupported browser.

from narada import BrowserEnvironment, NaradaUnsupportedBrowserError

env = BrowserEnvironment()
try:
    await env.start()
except NaradaUnsupportedBrowserError:
    print("Please use Chrome browser. Other browsers are not supported.")
finally:
    await env.close()

NaradaExtensionMissingError

Raised when the Chrome extension is not installed.

from narada import BrowserEnvironment, NaradaExtensionMissingError

env = BrowserEnvironment()
try:
    await env.start()
except NaradaExtensionMissingError:
    print("Narada extension not found. Please install it from the Chrome Web Store.")
finally:
    await env.close()

NaradaExtensionUnauthenticatedError

Raised when the extension is not signed in.

from narada import BrowserEnvironment, NaradaExtensionUnauthenticatedError

env = BrowserEnvironment()
try:
    await env.start()
except NaradaExtensionUnauthenticatedError:
    print("Please sign in to your Narada account in the Chrome extension.")
finally:
    await env.close()

NaradaInitializationError

Raised when SDK initialization fails.

from narada import BrowserEnvironment, NaradaInitializationError

env = BrowserEnvironment()
try:
    await env.start()
except NaradaInitializationError:
    print("Failed to initialize SDK. Check your API key and internet connection.")
finally:
    await env.close()

Retry Pattern

For transient errors, implement retry logic:

import asyncio
from narada import Agent, BrowserEnvironment, NaradaTimeoutError

async def retry_operation(agent, prompt, max_retries=3):
    for attempt in range(max_retries):
        try:
            return await agent.run(prompt=prompt)
        except NaradaTimeoutError:
            if attempt == max_retries - 1:
                raise
            await agent.reset_agent_state()
            await asyncio.sleep(2 ** attempt)  # Exponential backoff

async def main():
    env = BrowserEnvironment()
    agent = Agent(environment=env)

    try:
        response = await retry_operation(
            agent,
            'search for "python tutorial"'
        )
        print(response.text)
    finally:
        await env.close()

asyncio.run(main())

Best Practices

Catch Specific Errors

Handle specific error types rather than generic exceptions

Implement Retries

Use retry logic for timeout and initialization errors

Log Errors

Log errors with context for debugging

Graceful Degradation

Design fallback behavior when automation fails

Most errors are recoverable. Check the error message and implement appropriate retry or fallback logic.

Action TraceDetailed logging and visual recording of automation workflows

Getting Started

Development

Web Agent Guides

Narada Assistant

Error Handling

Error Types

Error Handling Examples

Retry Pattern

Best Practices

Catch Specific Errors

Implement Retries

Log Errors

Graceful Degradation

​Error Types

​Error Handling Examples

​Retry Pattern

​Best Practices

Catch Specific Errors

Implement Retries

Log Errors

Graceful Degradation

Error Types

Error Handling Examples

Retry Pattern

Best Practices