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:

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.

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

// 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

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

🔐 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

  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:

✅ 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


Step 8: Test Your Agent

Verify everything is working correctly with some basic tests.

Basic Commands to Try

// 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

Security Best Practices

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:

"Show my complete portfolio"
"What's my portfolio performance today?"
"Track my DeFi positions"

Trading Operations:

"Swap 10 USDC for ETH"
"Get a quote for 0.1 ETH to DAI"
"Send 5 USDC to vitalik.eth"

Market Research:

"Find me some lowcap gems"
"What are the trending tokens?"
"Show me top gainers today"

Getting Help

📞 Support Channels

If you need assistance:


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.


Last updated