# Making an agent
## Creating a Frame Agent
{% hint style="info" %}
**🤖 Build Your AI Blockchain Assistant**
This guide walks you through creating your first Frame Agent - a personalized AI assistant that can execute blockchain operations through natural conversation.
{% endhint %}
### Prerequisites
Before starting, make sure you have:
{% hint style="warning" %}
**📋 Required Items**
* **Telegram Account**: You'll need an active Telegram account
* **Basic Crypto Knowledge**: Understanding of wallets, tokens, and transactions
* **Secure Environment**: Safe place to store private keys and wallet information
{% endhint %}
#### What You'll Get
After completing this guide, you'll have:
* ✅ Your own AI-powered blockchain assistant
* ✅ A personal Ethereum wallet with full custody
* ✅ Access to conversational DeFi operations
* ✅ Ability to customize your agent's personality
***
### Step 1: Access the Frame Manager Bot
The Frame Manager Bot is your gateway to creating and managing Frame Agents.
#### Finding the Manager Bot
{% hint style="info" %}
**🔍 Locating the Manager Bot**
Contact the Frame team or check our community channels for the current Frame Manager Bot username.
* **Telegram**: [t.me/frameagentbot](https://t.me/frameagentbot)
* **Website**: [framebot.dev](https://framebot.dev)
{% endhint %}
#### Starting the Manager
1. **Open Telegram** on your device
2. **Search** for the Frame Manager Bot
3. **Start a conversation** by clicking "Start" or sending `/start`
You should see a welcome message with inline buttons for bot management.
***
### Step 2: Initiate Agent Creation
Now you'll begin the process of creating your Frame Agent.
#### Launch Creation Wizard
**Option A: Using Buttons**
* Click the **"🤖 Create New Bot"** button in the manager interface
**Option B: Using Commands**
* Type `/createbot` in the chat
#### What Happens Next
The Frame Manager will guide you through a 3-step creation process:
1. **Bot Name**: Choose a unique identifier
2. **Bot Token**: Secure token generation
3. **Personality**: Define your agent's behavior
***
### Step 3: Choose Your Bot Name
Your bot name is how you'll identify and manage your Frame Agent.
#### Naming Guidelines
```javascript
// Good bot names:
"TradingBot"
"MyFrameAgent"
"CryptoAssistant"
"DegenBot"
// Avoid:
Names with spaces or special characters
Names that are too long
Names already in use
```
#### Name Requirements
{% hint style="warning" %}
**📝 Naming Rules**
* **Unique**: No two users can have the same bot name
* **Alphanumeric**: Letters and numbers only
* **Length**: 3-20 characters recommended
* **No Spaces**: Use underscores or camelCase instead
{% endhint %}
**Example Process:**
1. Manager asks: "Please enter a name for your bot:"
2. You respond: `MyTradingBot`
3. If available, you'll proceed to Step 2
4. If taken, you'll be asked to choose another name
***
### Step 4: Bot Token Generation
The system will automatically generate a secure token for your bot.
#### Understanding Bot Tokens
{% hint style="info" %}
**🔐 What is a Bot Token?**
A bot token is a unique identifier that:
* Connects your agent to Telegram's servers
* Enables communication between you and your agent
* Provides secure access to Frame's services
* Cannot be changed once generated
{% endhint %}
#### Token Generation Process
1. **Automatic Creation**: The system generates a unique token
2. **Telegram Registration**: Your bot is registered with Telegram
3. **Frame Integration**: Token is linked to Frame's services
4. **Verification**: System confirms successful creation
This step is handled automatically - no action required from you.
***
### Step 5: Define Your Agent's Personality
This is where you customize how your Frame Agent behaves and responds.
#### Writing Your Prompt
Your prompt defines your agent's:
* **Personality traits** (professional, casual, humorous)
* **Specialization** (trading focus, portfolio management, general use)
* **Communication style** (formal, friendly, technical)
* **Specific behaviors** (risk tolerance, preferred tokens)
#### Prompt Examples
📊 Professional Trading Assistant
```
You are a professional cryptocurrency trading assistant. You provide detailed market analysis, execute trades with precision, and always consider risk management. You speak in a professional, analytical tone and provide clear explanations for all recommendations. You focus on helping users make informed decisions and managing their portfolios effectively.
```
🎯 DeFi Specialist
```
You are a DeFi specialist who loves exploring new protocols and yield opportunities. You help users navigate complex DeFi strategies, explain protocol mechanics, and find the best yields. You're enthusiastic about decentralized finance and always provide educational context along with your recommendations.
```
🤖 Casual Crypto Buddy
```
You are a friendly and casual crypto assistant. You make blockchain operations fun and easy to understand. You use simple language, occasional humor, and always celebrate wins with your users. You're patient with beginners and excited about the potential of crypto technology.
```
🔥 Degen Trading Bot
```
You are a degen trading assistant who loves finding alpha and hunting for gems. You're always on the lookout for new opportunities, early token launches, and high-potential plays. You understand the risks but aren't afraid to take calculated chances. You speak the language of crypto degens and stay updated on the latest trends.
```
***
### Step 6: Complete Creation Process
After defining your prompt, the system finalizes your Frame Agent.
#### Final Steps
1. **Processing**: The system configures your agent with your settings
2. **Wallet Generation**: A personal Ethereum wallet is created for you
3. **Bot Deployment**: Your agent is deployed and becomes active
4. **Confirmation**: You receive confirmation with important details
#### Success Information
Upon successful creation, you'll receive:
```javascript
✅ Bot Created Successfully!
Bot Details:
• Name: YourBotName
• Username: @your_bot_username
• Invite Code: ABC123XYZ
Next Steps:
1. Click the bot link to open your agent
2. Send the invite code to access your wallet
3. Start using conversational commands
```
***
### Step 7: Access Your Frame Agent
Now it's time to connect to your newly created agent.
#### Opening Your Agent
**Method 1: Click the Link**
* Click the provided Telegram link in the success message
* This opens your agent directly in Telegram
**Method 2: Manual Search**
* Open Telegram
* Search for your bot's username (e.g., `@your_bot_username`)
* Start a conversation
#### First Connection
1. **Start the Bot**: Click "Start" or send `/start`
2. **Enter Invite Code**: Send the invite code you received
3. **Wallet Setup**: Your agent will provide wallet details
4. **Security Notice**: You'll receive your wallet address and security reminders
{% hint style="danger" %}
**🔐 Critical Security Information**
Your agent will provide:
* **Wallet Address**: Your public Ethereum address (safe to share)
* **Private Key**: Your wallet's private key (NEVER share this)
**Important**: Store your private key securely. Frame agents need it to execute transactions, but you should never share it with anyone else.
{% endhint %}
***
### Step 8: Test Your Agent
Verify everything is working correctly with some basic tests.
#### Basic Commands to Try
```javascript
// Test wallet functionality
"What's my wallet address?"
"Check my ETH balance"
"Show my token portfolio"
// Test market data
"What's the current ETH price?"
"Show me trending tokens"
"Get gas prices"
// Test understanding
"Help me understand how you work"
"What can you do for me?"
"Explain your features"
```
#### Expected Responses
Your agent should:
* ✅ Respond to all basic commands
* ✅ Show your wallet address when asked
* ✅ Provide current market information
* ✅ Demonstrate the personality you defined
* ✅ Handle errors gracefully
#### Quick Menu Access
Try the `/menu` command to see your agent's interface:
* 💰 Wallet Balance
* 🔑 Wallet Address
* 💸 Send Tokens
* 🔄 Swap Tokens
* And more...
***
### Customization Options
After creation, you can further customize your Frame Agent.
#### Available Customizations
✏️ Change Agent Prompt
**How to Update:**
1. Return to the Frame Manager Bot
2. Use `/changeprompt` command
3. Select your bot from the list
4. Enter your new prompt
**When to Update:**
* You want to change your agent's personality
* You need different specialization
* You want to improve responses
* You're not satisfied with current behavior
🏷️ Rename Your Agent
**How to Rename:**
1. Use the Frame Manager Bot
2. Select your bot for modification
3. Choose "Change Name" option
4. Enter the new name
**Limitations:**
* New name must still be unique
* Cannot change Telegram username
* Name change affects only display name
🖼️ Change Agent Image
**How to Update Image:**
1. Open your Frame Agent
2. Use `/menu` command
3. Click "🖼️ Change Image"
4. Upload your new image
**Image Requirements:**
* Supported formats: JPG, PNG, GIF
* Maximum size: 10MB
* Recommended: Square images work best
***
### Troubleshooting
Common issues and solutions when creating Frame Agents.
#### Creation Issues
❌ "Bot name already taken"
**Problem**: Another user has already used that bot name.
**Solutions:**
* Try adding numbers: `TradingBot2`, `MyBot2024`
* Use underscores: `Trading_Bot`, `My_Assistant`
* Be more specific: `AliceTradeBot`, `JohnDeFiAgent`
* Check for typos in your intended name
❌ "Creation failed" or timeout errors
**Problem**: Technical issue during bot creation.
**Solutions:**
* Wait 5 minutes and try again
* Check your internet connection
* Try a different bot name
* Contact support if the issue persists
**Prevention:**
* Use a stable internet connection
* Don't refresh or close the app during creation
* Choose simple, clear bot names
❌ "Invalid prompt" error
**Problem**: Your prompt contains unsupported content.
**Common Issues:**
* Extremely long prompts (over 1000 characters)
* Special characters or formatting
* Requesting unsafe or illegal activities
**Solutions:**
* Shorten your prompt to key personality traits
* Remove special characters
* Focus on legitimate blockchain/trading activities
* Use the example prompts as templates
#### Access Issues
❌ "Bot not responding" after creation
**Problem**: Your agent isn't responding to messages.
**Immediate Checks:**
1. Verify you're messaging the correct bot username
2. Ensure you sent the invite code correctly
3. Check if the bot shows as "online"
**Solutions:**
* Try `/start` command again
* Re-enter your invite code
* Wait 2-3 minutes for system sync
* Contact support with your bot details
❌ "Access denied" or invite code issues
**Problem**: Invite code not working or access denied.
**Solutions:**
* Double-check the invite code for typos
* Ensure you're using the code with the correct bot
* Try copying and pasting the code
* Generate a new invite code from the manager
**Note**: Invite codes are case-sensitive and must be entered exactly.
***
### Best Practices
Tips for creating and using effective Frame Agents.
#### Prompt Writing Best Practices
{% hint style="success" %}
**✨ Effective Prompts**
**Do:**
* Keep prompts concise but descriptive
* Focus on 2-3 key personality traits
* Include specific use cases or specializations
* Use clear, simple language
* Test and iterate based on responses
**Don't:**
* Write extremely long prompts (>500 words)
* Include contradictory instructions
* Request unsafe or illegal activities
* Use overly complex technical jargon
* Set unrealistic expectations
{% endhint %}
#### Security Best Practices
{% hint style="danger" %}
**🔐 Security Essentials**
**Protect Your Assets:**
* Never share your private key with anyone
* Store wallet information in a secure location
* Use your agent only for amounts you can afford to lose initially
* Test with small amounts before larger transactions
* Regularly backup your wallet information
**Safe Usage:**
* Verify transaction details before confirming
* Check gas prices before executing trades
* Be cautious with new or unknown tokens
* Don't share your invite codes publicly
{% endhint %}
#### Usage Tips
**Start Small:**
* Begin with small test transactions
* Learn your agent's capabilities gradually
* Use demo amounts for learning
**Regular Maintenance:**
* Check your agent periodically
* Update prompts as your needs change
* Monitor your wallet balances
**Community Engagement:**
* Join the Frame community for tips
* Share experiences (without sensitive info)
* Ask questions and learn from others
***
### What's Next?
After creating your Frame Agent, explore these next steps.
#### Immediate Actions
1. **Explore Commands**: Try different conversational commands
2. **Check Portfolio**: Monitor your wallet and balances
3. **Test Trading**: Start with small token swaps
4. **Join Community**: Connect with other Frame users
#### Advanced Features
**Portfolio Management:**
```javascript
"Show my complete portfolio"
"What's my portfolio performance today?"
"Track my DeFi positions"
```
**Trading Operations:**
```javascript
"Swap 10 USDC for ETH"
"Get a quote for 0.1 ETH to DAI"
"Send 5 USDC to vitalik.eth"
```
**Market Research:**
```javascript
"Find me some lowcap gems"
"What are the trending tokens?"
"Show me top gainers today"
```
#### Getting Help
{% hint style="info" %}
**📞 Support Channels**
If you need assistance:
* **Community**: [t.me/makeframebots](https://t.me/makeframebots)
* **Documentation**: [framebot.dev](https://framebot.dev)
* **Email**:
* **Reset Command**: Use `/reset` in your agent if needed
{% endhint %}
***
### Frequently Asked Questions
❓ Can I create multiple Frame Agents?
Yes! You can create multiple Frame Agents, each with different personalities and specializations. Each agent will have its own wallet and unique characteristics.
❓ Can I delete or stop my Frame Agent?
Yes, you can stop your Frame Agent using the Frame Manager Bot. Use the `/stopbot` command and select the agent you want to stop. Note that this action cannot be easily undone.
❓ What happens if I lose my invite code?
Contact the Frame support team with your bot details. They can help you regain access to your agent, though you may need to verify ownership.
❓ Can I change my agent's wallet address?
No, wallet addresses are permanent and cannot be changed. Each Frame Agent gets one unique Ethereum wallet that remains constant throughout its lifetime.
❓ Is there a limit to how many commands I can use?
Currently, there are no strict limits on command usage. However, blockchain operations require gas fees, and some API calls may have rate limits during high usage periods.
❓ Can my Frame Agent work in group chats?
Frame Agents are designed for private, one-on-one conversations. While they may respond in groups, they work best in direct messages where they can access your personal wallet and provide secure services.
***
{% hint style="success" %}
**🎉 Congratulations!**
You now have all the knowledge needed to create and customize your Frame Agent. Your AI-powered blockchain assistant is ready to help you navigate the world of DeFi through simple conversation.
**Ready to start?** Head to the Frame Manager Bot and begin creating your agent today!
{% endhint %}
