FAQs

1. What is Ethereal SDK?

Ethereal SDK is a framework designed for building agentic AI systems. It provides tools to create, manage, and customize AI agents that can process tasks, integrate with APIs, and interact with blockchain networks.

2. What are the prerequisites to use Ethereal SDK?

Before using Ethereal SDK, ensure you have the following installed:

• Python 3.8+

• Git (Optional, for cloning the repository)

• pip or Poetry for managing dependencies

3. How do I install Ethereal SDK?

You can install Ethereal SDK by cloning the repository and setting up a virtual environment. For detailed installation steps, refer to the Quick Setup.

4. How can I configure the SDK?

You can configure Ethereal SDK using the Settings class. You can set various configuration values such as log_level, use_blockchain, and api_key using the get and set methods. For example:

settings = Settings()

settings.set("log_level", "DEBUG")

5. What types of tasks can an agent handle?

An agent can handle a variety of tasks, such as:

• Data Processing: Process data from files or streams.

• Email Sending: Send emails based on task parameters.

• API Integration: Interact with external APIs.

• Blockchain Logging: Log events and data to blockchain networks like Ethereum.

6. How can I customize an agent’s behavior?

The AgentCustomization class allows you to define custom behaviors for specific agents. You can use the customize_behavior method to adjust parameters for an agent's tasks and retrieve current customizations with get_current_customizations.

7. What blockchain networks are supported?

Ethereal SDK currently supports popular blockchain networks like Ethereum and Binance Smart Chain (BSC). You can specify the network when setting up the BlockchainConnector.

8. How do I log actions to the blockchain?

Use the Web3Logger class to log actions to the blockchain. The log_to_blockchain method sends transactions to the blockchain, while the retrieve_log method allows you to fetch logs related to a specific agent.

9. How does the TaskQueue work?

The TaskQueue class helps manage tasks. You can add tasks to the queue using add_to_queue, and process them sequentially with process_queue. This is useful for ensuring tasks are handled in the right order.

10. How do I handle errors in the SDK?

Ethereal SDK provides error handling functions in the ErrorHandler module. You can use handle_error to log and manage errors, and fallback_action to perform actions like retrying the task or switching to a backup agent.

11. Can I integrate external APIs with Ethereal SDK?

Yes, you can integrate external APIs using the ExternalAPI class. The fetch_data method allows you to make HTTP requests to external endpoints, passing any required parameters and headers.

12. How do I store and retrieve data in memory?

The Memory class allows you to store and retrieve data. You can store data using the store method, and retrieve it by index using the retrieve method. This is useful for temporarily saving information that agents can access later.

13. How do I execute external tools?

The Tool class enables the execution of external tools with arguments. You can call the execute method with the necessary parameters to interact with these tools.