# Tools Overview
### 🤖 AI & Communication Tools
#### General Agent Tool
**Purpose**: Configurable LLM agent for various AI tasks including conversation, analysis, and structured data processing.
**Key Features**:
* **Normal Mode**: Flexible text responses based on your system prompt
* **Structured Mode**: Guaranteed JSON output with custom schemas
* **Multiple Models**: Choose from GPT-4, GPT-3.5, Claude, and more
* **Custom Prompts**: Define specific AI behaviors and personas
**Use Cases**: Customer support, content creation, data analysis, trading signals
Learn More
Configurable LLM agent for various AI tasks including conversation, analysis, and structured data processing.
### How to Use
#### Input Requirements
To configure the AI agent, you need:
* **Model Selection**: Choose any model from the available options
* **System Prompt**: Define how the AI should behave and respond
* **Mode**: Select Normal or Structured output mode
* **JSON Schema**: Required only for Structured mode
#### Configuration Modes
**Normal Mode**
**Purpose**: Get flexible text or JSON responses based on your system prompt
**Configuration**:
* **Model**: Choose any model from dropdown options (GPT-4, GPT-3.5, Claude, etc.)
* **System Prompt**: Write instructions for how the AI should behave
**Example Setup**:
```
Model: GPT-4System Prompt: "You are a helpful crypto trading assistant. Provide clear advice about DeFi protocols and market trends."
```
**Output**: String or JSON based on what your system prompt requests
**Structured Mode (For JSON Structured Output)**
**Purpose**: Get guaranteed JSON output that follows a specific format
**Configuration**:
* **Model**: Choose any model from dropdown options
* **System Prompt**: Write instructions for the AI
* **JSON Schema**: Define the exact structure you want
**Example Setup**:
```
Model: GPT-4System Prompt: "Analyze crypto prices and provide trading recommendations"JSON Schema: { "type": "object", "properties": { "recommendation": {"type": "string"}, "confidence": {"type": "number"}, "price_target": {"type": "number"} }}
```
**Output**: Always returns structured JSON matching your schema
#### Configuration Examples
**Customer Support Agent (Normal Mode)**
**Input**: `"Help me understand DeFi yield farming"` **System Prompt**: `"You are a friendly DeFi expert. Explain complex concepts in simple terms."` **Output**:
```
"DeFi yield farming is like earning interest on your crypto by lending it to protocols. You deposit tokens into pools and earn rewards, typically 5-20% annually. Popular platforms include Aave, Compound, and Uniswap. Start small and research risks before investing."
```
**Price Analysis Agent (Structured Mode)**
**Input**: `"Analyze Bitcoin price trends"` **System Prompt**: `"Analyze crypto market data and provide trading insights"` **JSON Schema**:
```
{ "type": "object", "properties": { "trend": {"type": "string"}, "confidence": {"type": "number"}, "recommendation": {"type": "string"}, "target_price": {"type": "number"} }}
```
**Output**:
```
{ "trend": "bullish", "confidence": 0.75, "recommendation": "BUY", "target_price": 52000}
```
**Content Creator Agent (Normal Mode)**
**Input**: `"Write a tweet about Ethereum"` **System Prompt**: `"You are a crypto content creator. Write engaging, informative social media posts."` **Output**:
```
"🚀 Ethereum continues to lead DeFi innovation! With over $50B locked in protocols and growing Layer 2 adoption, $ETH remains the backbone of decentralized finance. What's your favorite dApp? #Ethereum #DeFi #Web3"
```
**Data Extraction Agent (Structured Mode)**
**Input**: `"Extract key info from this contract: 0x1234..."` **System Prompt**: `"Extract blockchain contract information and return structured data"` **JSON Schema**:
```
{ "type": "object", "properties": { "contract_type": {"type": "string"}, "token_symbol": {"type": "string"}, "total_supply": {"type": "number"}, "is_verified": {"type": "boolean"} }}
```
**Output**:
```
{ "contract_type": "ERC-20", "token_symbol": "USDC", "total_supply": 1000000000, "is_verified": true}
```
#### Mode Selection Guide
**Choose Normal Mode When:**
* You want flexible, conversational responses
* Output format can vary based on the question
* You need explanations, summaries, or creative content
* Human-readable text is the primary goal
**Choose Structured Mode When:**
* You need consistent JSON output format
* Data will be processed by other systems
* You require specific fields every time
* Building APIs or automated workflows
#### Input Format
Provide questions or requests in natural language:
**Example inputs:**
* `"Explain how staking works"`
* `"Analyze this wallet address"`
* `"Write a summary of today's crypto news"`
* `"Compare Uniswap vs SushiSwap"`
#### Output Format
**Normal Mode**: Returns flexible text or JSON based on system prompt **Structured Mode**: Returns guaranteed JSON matching your schema
#### Use Cases
**Trading & Analysis**
* Market trend analysis
* Portfolio recommendations
* Risk assessments
* Trading signal generation
**Content Creation**
* Social media posts
* Blog articles
* Documentation
* Educational content
**Data Processing**
* Contract analysis
* Wallet research
* Transaction summaries
* Protocol comparisons
**Customer Support**
* Answer user questions
* Explain crypto concepts
* Troubleshoot issues
* Provide guidance
***
#### Telegram Tool
**Purpose**: Seamless integration with Telegram for bot messaging, broadcasting, and interactive communication.
**Key Features**:
* **Polling Mode**: Listen for messages and act as trigger point
* **Broadcast Mode**: Send messages to groups and channels
* **Combined Mode**: Both receive and send capabilities
* **Rich Messages**: Text, images, documents, and interactive buttons
**Use Cases**: Community management, trading alerts, customer support, news distribution
Learn More
Seamless integration with Telegram for bot messaging, broadcasting, and interactive communication.
### How to Use
#### Input Requirements
To configure the Telegram bot, you need:
* **Bot Token**: Get from BotFather on Telegram
* **Mode Selection**: Choose Polling, Broadcast, or both
* **Chat ID**: Optional specific chat/group ID
* **Message Content**: Text, images, or documents to send
#### Configuration Modes
**Polling Mode (Trigger Starting Point)**
**Purpose**: Listen for incoming messages and act as a trigger for other flows
**Configuration**:
* ✅ **Polling**: Enabled
* ❌ **Broadcast**: Disabled
**Behavior**:
* Acts as trigger starting point for workflows
* Listens for user messages and commands
* All trigger flows need to be subscribed to this
* Responds to incoming messages automatically
**Use When**: You want the bot to respond to user messages
**Broadcast Mode (Send Messages to Groups)**
**Purpose**: Send messages to multiple users or groups
**Configuration**:
* ❌ **Polling**: Disabled
* ✅ **Broadcast**: Enabled
**Behavior**:
* Sends messages to configured groups/channels
* One-way communication (send only)
* Good for announcements and notifications
* Can reach multiple recipients at once
**Important**:
* Chat ID and broadcast option **don't work together**
* Whichever group or chat ID you want to use, they must do `/start` to start the bot first
* Bot needs to be activated in each chat/group before broadcasting
**Use When**: You want to send alerts, news, or updates to groups
**Combined Mode (Both Polling & Broadcast)**
**Configuration**:
* ✅ **Polling**: Enabled
* ✅ **Broadcast**: Enabled
**Behavior**:
* Can both receive and send messages
* Full bidirectional communication
* Responds to users AND sends broadcasts
**Important**: If you have multiple Telegram nodes, only ONE should have polling enabled to avoid bot conflicts
#### Chat ID Configuration
**Default Behavior**
Without specific Chat ID, the bot uses default settings
**Specific Chat ID**
**Configuration**: Set Chat ID in the options **Command**: `/chatId telegram` **Purpose**: Send messages to a specific chat or group
**Important Limitations**:
* **Chat ID and broadcast option don't work together**
* Choose either specific Chat ID OR broadcast mode, not both
* For broadcast mode, recipients must `/start` the bot first
**Example**:
* Chat ID: `123456789` (send to specific user)
* Chat ID: `-987654321` (send to specific group)
**Setup Requirements**:
* User or group must send `/start` to the bot before receiving messages
* Bot must be added to groups and activated
#### Configuration Examples
**Customer Support Bot (Polling Mode)**
**Settings**:
* ✅ Polling: ON
* ❌ Broadcast: OFF
* Chat ID: (empty - responds to anyone)
**Behavior**: Responds to customer questions automatically
**News Broadcaster (Broadcast Mode)**
**Settings**:
* ❌ Polling: OFF
* ✅ Broadcast: ON
* Chat ID: (empty - don't set specific Chat ID)
**Behavior**:
* Sends crypto news updates to subscribed users/groups
* Recipients must have sent `/start` to the bot first
**Community Manager Bot (Combined Mode)**
**Settings**:
* ✅ Polling: ON
* ✅ Broadcast: ON
* Chat ID: (empty - broadcast doesn't work with specific Chat ID)
**Behavior**:
* Answers questions from anyone who messages the bot
* Sends announcements to all users who have sent `/start`
**Private Assistant (Specific Chat ID)**
**Settings**:
* ✅ Polling: ON
* ❌ Broadcast: OFF
* Chat ID: `123456789` (your personal chat)
**Behavior**: Personal bot that only talks to you
#### Input Format
Send messages in natural language:
**Example inputs:**
* `"Send price alert to crypto group"`
* `"Respond to user questions about DeFi"`
* `"Broadcast daily market summary"`
* `"Send notification to admin chat"`
#### Output Format
Various message types supported:
* **Text Messages**: Plain text responses
* **Rich Messages**: Formatted text with Markdown
* **Images**: Charts, graphs, screenshots
* **Documents**: PDFs, reports, files
* **Buttons**: Interactive keyboards and menus
#### Use Cases
**Community Management**
* Answer member questions
* Send announcements
* Moderate discussions
* Share updates
**Trading Alerts**
* Price notifications
* Market analysis
* Trading signals
* Portfolio updates
**Customer Support**
* 24/7 automated responses
* Help documentation
* Issue escalation
* User onboarding
**News & Updates**
* Market news
* Protocol updates
* Event notifications
* Research reports
#### Bot Conflict Prevention
**Problem**: Multiple Telegram bots with polling enabled can conflict
**Solution**:
* Use only ONE Telegram node with Polling enabled
* Other Telegram nodes should have Polling disabled
* Each bot token should be unique
**Example Setup**:
* Bot 1: Polling ON, Broadcast OFF (handles incoming messages)
* Bot 2: Polling OFF, Broadcast ON (sends announcements)
***
###
***
### 🔗 Blockchain & DeFi Tools
#### Blockchain Interaction Tool (GOAT SDK)
**Purpose**: AI-powered blockchain interaction across multiple chains using natural language commands via the GOAT SDK.
**Key Features**:
* **Multi-Chain Support**: Solana, Ethereum, and other EVM-compatible networks
* **Natural Language Interface**: Execute transactions using plain English commands
* **Jupiter Integration**: Advanced DEX aggregation and best rate finding on Solana
* **Plugin Architecture**: Extensible system for different protocols and operations
**Use Cases**: Token swaps, portfolio management, DeFi operations, cross-chain transactions
[**Learn More →**](https://docs.skynetxbt.ai/flows/blockchain-interaction-goat)
***
#### Ethers Tool
**Purpose**: Enhanced blockchain interaction using Ethers.js for EVM-compatible chains.
**Key Features**:
* **Natural Language Interface**: Interact with smart contracts using plain English
* **AI-Powered Function Selection**: Automatically selects appropriate contract functions
* **Multi-Chain Support**: Works with any EVM-compatible blockchain
* **Transaction Monitoring**: Real-time transaction status tracking
**Use Cases**: DeFi operations, token management, smart contract interaction, portfolio management
***
#### DeFi Llama Tool
**Purpose**: Analytics and tracking for DeFi protocols using the DeFi Llama API.
**Key Features**:
* **TVL Tracking**: Monitor Total Value Locked across protocols
* **Yield Analysis**: Compare yield opportunities across platforms
* **Protocol Comparison**: Analyze different protocols side by side
* **Market Insights**: Get market trends and protocol rankings
**Use Cases**: Market research, investment decisions, protocol monitoring, portfolio analysis
***
### 🔄 Data & Logic Tools
#### Fetch Tool
**Purpose**: Fetch data from a URI with optional authentication for external API integration.
**Key Features**:
* **HTTP Methods**: Support for GET, POST, PUT, DELETE requests
* **Authentication**: Bearer tokens, API keys, custom headers
* **Data Parsing**: Automatically parse JSON responses
* **Error Handling**: Graceful handling of API errors and timeouts
**Use Cases**: Price feeds, weather data, news APIs, social media integration
***
#### Parser Tool
**Purpose**: Parse and extract nested values from JSON objects.
**Key Features**:
* **Dot Notation Paths**: Extract values using simple path syntax
* **Array Handling**: Process arrays with index or wildcard selection
* **Nested Extraction**: Navigate deeply nested object structures
* **Multiple Formats**: Handle various data types and structures
**Use Cases**: API response parsing, configuration reading, data transformation, form processing
***
#### Conditional Tool
**Purpose**: Route flow based on conditions using natural language logic.
**Key Features**:
* **Natural Language Conditions**: Write conditions in plain English
* **True/False Routing**: Direct flow based on condition evaluation
* **Custom Prompts**: Descriptive evaluation contexts
* **Business Logic**: Handle authentication, validation, and workflow control
**Use Cases**: Authentication checks, business logic, data validation, workflow control
***
### ⏱️ Automation Tools
#### Timer Tool
**Purpose**: Scheduled task execution and time-based automation with auto-execute functionality.
**Key Features**:
* **Auto Execute**: Continuous execution at specified intervals
* **Flexible Intervals**: Support for seconds, minutes, hours, and days
* **Agent Integration**: Execute any configured agent automatically
* **Real-time Control**: Start, stop, and modify schedules on-demand
**Use Cases**: Monitoring agents, data collection, report generation, health checks
***
#### Webhook Tool
**Purpose**: Webhook handling and HTTP endpoints for external system integration.
**Key Features**:
* **Event Handling**: Process incoming webhook events
* **HTTP Server**: Create custom HTTP endpoints
* **Data Processing**: Parse and transform incoming webhook data
* **Security**: Verify webhook signatures and authenticate requests
**Use Cases**: Third-party integrations, event-driven automation, data ingestion, API gateway
[**Learn More →**](https://docs.skynetxbt.ai/flows/webhook)
***
### 🔧 Advanced Tools
#### MCP Agent Tool
**Purpose**: Model Context Protocol integration for enhanced AI capabilities with multiple tools.
**Key Features**:
* **Multiple MCP Tools**: CoinMarketCap, Twitter, Farcaster, Search APIs
* **API Key Management**: Individual authentication for each tool
* **Unified Interface**: Access multiple services through single flow
* **Tool Integration**: Combine crypto data, social media, and search capabilities
**Available Tools**: Custom MCP, Farcaster, CoinMarketCap, Dex Paprika, Tavily Search, Brave Search, Perplexity, Exa Search, Twitter
***
### 🏗️ Specialized Tools
#### Berachain Tool
**Purpose**: Comprehensive analytics and pool information for the Berachain ecosystem with markdown-formatted reports.
**Key Features**:
* **Pool Analytics**: Detailed insights into Berachain pools with APR calculations
* **Liquidity Metrics**: Real-time TVL, volume, and fee tracking
* **Reward Vault Information**: BGT rewards and incentive program details
* **Markdown Reports**: Professional-grade analytics in clean, readable format
**Use Cases**: Berachain yield farming, pool analysis, liquidity provision strategy, DeFi research
***
#### Beefy Suggestions Tool
**Purpose**: Intelligent yield farming strategy recommendations powered by Beefy Finance.
**Features**: Strategy analysis, risk assessment, APY calculations, portfolio optimization
***
### 🎯 Quick Start Guide
#### 1. Choose Your Tools
Select tools based on your use case:
* **AI Chat Bot**: General Agent + Telegram
* **DeFi Monitor**: DeFi Llama + Timer + Telegram
* **Trading Bot**: GOAT SDK + Fetch + Conditional + Timer
* **Berachain Analytics**: Berachain + Timer + Telegram
* **Data Pipeline**: Fetch + Parser + Webhook
#### 2. Configuration
Each tool has specific requirements:
* **API Keys**: Most tools require API keys for external services
* **Environment Variables**: Set up your `.env` file
* **Mode Selection**: Configure tool behavior (polling, broadcast, etc.)
#### 3. Integration
Combine tools for powerful workflows:
* Use **Timer** to schedule regular execution
* Use **Conditional** to add business logic
* Use **Parser** to process API responses
* Use **Telegram** for notifications
#### 4. Best Practices
* **Start Simple**: Begin with single tools before combining
* **Test Thoroughly**: Verify configurations before production
* **Monitor Performance**: Use appropriate intervals and timeouts
* **Secure API Keys**: Store credentials safely in environment variables
***
### 🚀 Ready-to-Use Templates
Skip the setup and start with proven workflows! Check out our [**Templates**](https://docs.skynetxbt.ai/templates) section for ready-to-duplicate flows:
* **🐦 BD Pokemon Bot** - Multi-group Telegram monitoring with AI filtering
* **📊 Trading Dashboards** - Automated market analysis and alerts
* **🔔 Notification Systems** - Smart alert management across platforms
* **🤖 Community Bots** - Automated engagement and moderation
[**Browse All Templates →**](https://docs.skynetxbt.ai/templates)
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.skynetxbt.ai/documentation/getting-started/markdown/tools-overview.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.