> For the complete documentation index, see [llms.txt](https://darksun.gitbook.io/docs.darksun.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://darksun.gitbook.io/docs.darksun.is/darksun/advanced-ai-agent.md).

# Advanced Ai Agent

*Darksun is built using the ELIZA agent framework.* \
\
ELIZA agents are sophisticated AI components that handle autonomous interactions. These agents are built on a complex system that enables them to maintain consistent behavior and memory across various platforms. Here's a comprehensive breakdown of how ELIZA agents work:

### Core Components

#### AgentRuntime

The AgentRuntime class is the primary implementation of the IAgentRuntime interface, managing the agent's core functions:

* **Message and Memory Processing**: Stores, retrieves, and manages conversation data and contextual memory.
* **State Management**: Composes and updates the agent's state for coherent, ongoing interactions.
* **Action Execution**: Handles behaviors such as transcribing media, generating images, and following rooms.
* **Evaluation and Response**: Assesses responses, manages goals, and extracts relevant information.

#### Role File System

The foundation of each ELIZA agent is its persona file, which defines the agent's personality in detail. This file includes:

* **Knowledge**: The agent's base of information.
* **Background**: The agent's backstory and narrative foundation.
* **Style**: Conversational tone and platform-specific responses.
* **Topic**: Areas of interest or expertise.
* **Adjectives**: Self-descriptors for the agent.
* **Examples**: Sample messages to fine-tune interactive behavior.

### Memory Systems

ELIZA agents utilize multiple types of memory:

* **Message History**: Stores recent conversations for short-term context.
* **Factual Memory**: Holds specific, context-based facts about users or the environment.
* **Knowledge Base**: Contains general knowledge for broader queries.
* **Relationship Tracking**: Manages the agent's understanding of its relationship with users.

### Action System

The action system in ELIZA is a significant innovation, treating each agent action as an independent event:

1. **Determine Intent**: The agent decides what action to take.
2. **Execution**: A dedicated module performs the specific task.

This separation allows for multi-stage workflows and rigorous validation processes, making it particularly suitable for secure applications like blockchain transactions.

### Providers and Evaluators

* **Providers**: Inject real-time contextual information to make conversations more dynamic and responsive.
* **Evaluators**: Analyze and extract key details from interactions, feeding into the multi-level memory structure.

### Natural Language Processing

While modern ELIZA agents are more advanced, the original ELIZA program used a pattern-matching algorithm:

1. **Input Processing**: The program searches for specific keywords or phrases in user input.
2. **Pattern Matching**: When a match is found, simple rules are applied to generate a response.
3. **Response Generation**: The output is often a reformulation of the input, transformed into a question.

### Development and Deployment

* ELIZA provides an out-of-the-box framework for rapid prototyping and deployment.
* Developers can focus on creating unique agent personalities rather than building infrastructure.
* The system supports various clients such as Discord and Telegram while maintaining consistent behavior.

### Advanced Features

* **Built-in RAG (Retrieval Augmented Generation)**: Allows agents to access a knowledge base when making queries.
* **Data Flywheel**: In trading applications, ELIZA agents can use a self-reinforcing feedback loop to optimize strategies over time.

By combining these elements, ELIZA agents can engage in complex, context-aware interactions across multiple platforms, making them powerful tools for various applications, from customer service to financial trading.