Making an agent
Creating a Frame Agent
🤖 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.
Prerequisites
Before starting, make sure you have:
📋 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
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
🔍 Locating the Manager Bot
Contact the Frame team or check our community channels for the current Frame Manager Bot username.
Telegram: t.me/frameagentbot
Website: framebot.dev
Starting the Manager
Open Telegram on your device
Search for the Frame Manager Bot
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
/createbotin the chat
What Happens Next
The Frame Manager will guide you through a 3-step creation process:
Bot Name: Choose a unique identifier
Bot Token: Secure token generation
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
Name Requirements
📝 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
Example Process:
Manager asks: "Please enter a name for your bot:"
You respond:
MyTradingBotIf available, you'll proceed to Step 2
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
🔐 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
Token Generation Process
Automatic Creation: The system generates a unique token
Telegram Registration: Your bot is registered with Telegram
Frame Integration: Token is linked to Frame's services
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
Step 6: Complete Creation Process
After defining your prompt, the system finalizes your Frame Agent.
Final Steps
Processing: The system configures your agent with your settings
Wallet Generation: A personal Ethereum wallet is created for you
Bot Deployment: Your agent is deployed and becomes active
Confirmation: You receive confirmation with important details
Success Information
Upon successful creation, you'll receive:
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
Start the Bot: Click "Start" or send
/startEnter Invite Code: Send the invite code you received
Wallet Setup: Your agent will provide wallet details
Security Notice: You'll receive your wallet address and security reminders
🔐 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.
Step 8: Test Your Agent
Verify everything is working correctly with some basic tests.
Basic Commands to Try
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:
Return to the Frame Manager Bot
Use
/changepromptcommandSelect your bot from the list
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:
Use the Frame Manager Bot
Select your bot for modification
Choose "Change Name" option
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:
Open your Frame Agent
Use
/menucommandClick "🖼️ Change Image"
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,MyBot2024Use underscores:
Trading_Bot,My_AssistantBe more specific:
AliceTradeBot,JohnDeFiAgentCheck 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:
Verify you're messaging the correct bot username
Ensure you sent the invite code correctly
Check if the bot shows as "online"
Solutions:
Try
/startcommand againRe-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
✨ 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
Security Best Practices
🔐 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
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
Explore Commands: Try different conversational commands
Check Portfolio: Monitor your wallet and balances
Test Trading: Start with small token swaps
Join Community: Connect with other Frame users
Advanced Features
Portfolio Management:
Trading Operations:
Market Research:
Getting Help
📞 Support Channels
If you need assistance:
Community: t.me/makeframebots
Documentation: framebot.dev
Email: [email protected]
Reset Command: Use
/resetin your agent if needed
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.
🎉 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!
Last updated