Architecture

CowAgent 2.0 has evolved from a simple chatbot into a super intelligent assistant with Agent architecture, featuring autonomous thinking, task planning, long-term memory, and skill extensibility.

System Architecture

CowAgent's architecture consists of the following core modules:

Agent Mode Workflow

When Agent mode is enabled, CowAgent runs as an autonomous agent with the following workflow:

1. Receive Message — Receive user input through channels
2. Understand Intent — Analyze task requirements and context
3. Plan Task — Break complex tasks into multiple steps
4. Invoke Tools — Select and execute appropriate tools for each step
5. Update Memory & Knowledge — Store important information in long-term memory and organize structured knowledge into the knowledge base
6. Return Result — Send execution results back to the user

Workspace Directory Structure

The Agent workspace is located at ~/cow by default and stores system prompts, memory files, and skill files:

~/cow/
├── system.md          # Agent system prompt
├── user.md            # User profile
├── MEMORY.md          # Core memory
├── memory/            # Long-term memory storage
│   └── YYYY-MM-DD.md  # Daily memory
├── knowledge/         # Personal knowledge base
│   ├── index.md       # Knowledge index
│   └── <category>/    # Topic-based pages
└── skills/            # Custom skills
    ├── skill-1/
    └── skill-2/

Secret keys are stored separately in ~/.cow directory for security:

~/.cow/
└── .env               # Secret keys for skills

Core Configuration

Configure Agent mode parameters in config.json:

{
  "agent": true,
  "agent_workspace": "~/cow",
  "agent_max_context_tokens": 40000,
  "agent_max_context_turns": 30,
  "agent_max_steps": 15
}