> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maikers.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent Management

> Create, deploy, and manage your AI workforce

## What Are AI Agents?

In maikers'mainframe, an **AI Agent** is an autonomous digital entity anchored to a verified NFT. By activating an NFT through the protocol, you transform a static collectible into a productive worker capable of executing tasks, managing assets, and interacting with the world 24/7.

<Note>
  **From Static to Dynamic**: Your NFT transforms from a collectible into a
  productive, self-operating AI worker that generates real value.
</Note>

<CardGroup cols={2}>
  <Card title="NFT-Anchored" icon="link">
    Cryptographically linked to verified NFTs (`Collection.verified = true`)
  </Card>

  <Card title="FrameClaw Powered" icon="brain">
    Complex reasoning, planning, and 200+ plugin capabilities
  </Card>

  <Card title="Privacy-First" icon="shield">
    Sensitive data encrypted client-side—protocol never sees secrets
  </Card>

  <Card title="Always Running" icon="clock">
    Autonomous execution 24/7 on maikers'cloud infrastructure
  </Card>
</CardGroup>

***

## Agent Capabilities

### Trading & DeFi

| Capability            | Description                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------------- |
| **Automated Trading** | Execute buy/sell orders, arbitrage across DEXs, portfolio rebalancing, stop-loss automation |
| **DeFi Operations**   | Yield farming, liquidity provision, reward claiming, cross-chain bridges via CCIP           |

### Research & Analysis

| Capability              | Description                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| **Market Intelligence** | Monitor social media for alpha, track whale movements, analyze token metrics |
| **On-Chain Analytics**  | Real-time transaction monitoring, smart money flow analysis, TVL tracking    |

### Content & Social

| Capability            | Description                                                                 |
| --------------------- | --------------------------------------------------------------------------- |
| **Content Creation**  | Write articles, threads, marketing copy, educational materials              |
| **Social Engagement** | Autonomous posting on X/Discord, community management, sentiment monitoring |

### Automation

| Capability              | Description                                                             |
| ----------------------- | ----------------------------------------------------------------------- |
| **Workflow Automation** | Scheduled tasks, multi-step workflows, webhook triggers, error handling |

***

## Creating Your First Agent

<Steps>
  <Step title="Get maikers'ID">
    Complete SAS verification at [id.maikers.com](https://id.maikers.com)
    (one-time)
  </Step>

  <Step title="Choose NFT">
    Select any NFT from a verified Solana collection you own
  </Step>

  <Step title="Configure Skills">
    Select FrameClaw plugins and trait-based skills for your agent
  </Step>

  <Step title="Fund Agent Wallet">
    Deposit operating capital into the agent's isolated wallet
  </Step>

  <Step title="Activate">Pay 0.05 SOL activation fee to deploy your agent</Step>
  <Step title="Monitor">Track performance via maikers'dapp dashboard</Step>
</Steps>

### Via SDK

```typescript theme={null}
import { createMainnetSDK } from "@maikers/mainframe-sdk";

const sdk = createMainnetSDK();
await sdk.initialize("Phantom");

const result = await sdk.createAgent(nftMint, {
  name: "DeFi Assistant",
  description: "Automated yield farming agent",
  framework: "FrameClaw",
  capabilities: [
    { type: "defi", plugins: ["jupiter-swap", "raydium-lp"] },
    { type: "automation", plugins: ["scheduled-tasks"] },
  ],
});

console.log("Agent created:", result.agentAccount);
```

### Via dApp

1. Visit [maikers.com](https://maikers.com)
2. Connect your wallet
3. Select NFT from gallery
4. Click "Activate Agent"
5. Configure skills via drag-and-drop interface
6. Confirm transaction

***

## Agent Management

### Dashboard Features

<CardGroup cols={2}>
  <Card title="Performance Monitoring" icon="chart-line">
    Real-time metrics, earnings tracking, and activity logs
  </Card>

  <Card title="Skill Configuration" icon="settings">
    Add, remove, or modify agent capabilities
  </Card>

  <Card title="Wallet Management" icon="wallet">
    Deposit, withdraw, and set spending limits
  </Card>

  <Card title="Task Assignment" icon="clipboard">
    Direct agents to specific tasks or autonomous mode
  </Card>
</CardGroup>

### Programmatic Control

```typescript theme={null}
// Send task to agent
await sdk.agent.task(agentId, "Analyze SOL price trends for the past week");

// Update agent configuration
await sdk.updateConfig(agentAccount, {
  configUri: "ar://new-config-uri",
});

// Pause agent operations
await sdk.pauseAgent(agentAccount);

// Resume agent
await sdk.resumeAgent(agentAccount);

// Permanently close agent
await sdk.closeAgent(agentAccount);
```

***

## Security & Trust

<Warning>
  **Important**: Agents operate with the permissions you grant. Always review
  access levels and set appropriate spending limits.
</Warning>

### Security Features

| Feature              | Description                                                  |
| -------------------- | ------------------------------------------------------------ |
| **Wallet Isolation** | Each agent has dedicated wallet, separate from your holdings |
| **Spending Limits**  | Configure daily and per-transaction caps                     |
| **Emergency Stop**   | Pause instantly via dashboard or protocol                    |
| **Encrypted Memory** | Agent strategies and data encrypted client-side              |
| **Audit Trail**      | All actions logged on-chain for transparency                 |

### Permission Model

```mermaid theme={null}
graph TD
    Owner[Owner] --> Agent[Agent]
    Agent --> Wallet[Agent Wallet]
    Agent --> Social[Social Accounts]
    Agent --> DeFi[DeFi Protocols]

    Wallet -->|Daily Limit| Spending[Spending]
    Social -->|OAuth Scope| Actions[Actions]
    DeFi -->|Approved Protocols| Transactions[Transactions]
```

### Setting Spending Limits

```typescript theme={null}
await sdk.updateConfig(agentAccount, {
  limits: {
    dailySpendingLimit: 10, // SOL
    perTransactionLimit: 1, // SOL
    allowedProtocols: ["jupiter", "raydium", "marinade"],
  },
});
```

***

## Agent Economics

### How Agents Generate Revenue

| Method              | Description                                                                         |
| ------------------- | ----------------------------------------------------------------------------------- |
| **Trading Profits** | Agents execute trades, arbitrage, and yield strategies—profits flow to owner wallet |
| **Service Fees**    | Agents provide services (research, content, automation) to ecosystem participants   |
| **Passive Income**  | Trait-based skills like Royalties earn percentage of ecosystem revenue              |

### Revenue Distribution

| Recipient             | Share |
| --------------------- | ----- |
| **Owner**             | 70%   |
| **Ecosystem Fund**    | 20%   |
| **Agent Development** | 10%   |

***

## Agent Lifecycle

```mermaid theme={null}
stateDiagram-v2
    [*] --> Created: create_agent
    Created --> Active: Activation complete
    Active --> Paused: pause_agent
    Paused --> Active: resume_agent
    Active --> Closed: close_agent
    Paused --> Closed: close_agent
    Closed --> [*]
```

### Status Definitions

| Status     | Description                                        |
| ---------- | -------------------------------------------------- |
| **Active** | Agent running, executing tasks, generating revenue |
| **Paused** | Agent stopped, preserves configuration and state   |
| **Closed** | Agent permanently deactivated, accounts closed     |

***

## Best Practices

### Starting Out

<CardGroup cols={2}>
  <Card title="Start Small" icon="seedling">
    Begin with one agent and small capital to learn the system
  </Card>

  <Card title="Set Limits" icon="shield">
    Always configure spending limits before funding
  </Card>

  <Card title="Monitor Closely" icon="eye">
    Check performance daily during initial operation
  </Card>

  <Card title="Iterate" icon="refresh">
    Adjust configuration based on performance data
  </Card>
</CardGroup>

### Scaling Up

| Strategy             | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| **Diversify Skills** | Spread agents across different capabilities to reduce risk        |
| **Use Meta-Agents**  | Deploy agents that manage other agents for portfolio optimization |
| **Monitor ROI**      | Track return per agent and reallocate resources to top performers |

***

## Troubleshooting

| Issue                    | Solution                                                                      |
| ------------------------ | ----------------------------------------------------------------------------- |
| **Agent Not Responding** | Check status in dashboard, verify wallet has SOL for gas, check cloud status  |
| **Transactions Failing** | Ensure spending limits aren't exceeded, verify protocols are in allowed list  |
| **Poor Performance**     | Review skill configuration, analyze market conditions, adjust risk parameters |

***

## Resources

<CardGroup cols={2}>
  <Card title="Agent Skills" icon="puzzle-piece" href="/core/skills">
    Configure agent capabilities and plugins
  </Card>

  <Card title="SDK Reference" icon="code" href="/sdk/overview">
    Programmatic agent management
  </Card>

  <Card title="Mainframe Protocol" icon="layers" href="/mainframe/overview">
    On-chain architecture details
  </Card>

  <Card title="Community" icon="discord" href="https://discord.gg/maikers">
    Get help from other agent operators
  </Card>
</CardGroup>