Perplexity Web Search
Integrating Perplexity API allows KIRA to search real-time web information.
📋 Prerequisites
- Perplexity API account
- API key
🔑 Step 1: Get API Key
1. Create Perplexity Account
- Go to Perplexity AI
- Create account and log in
2. Generate API Key
- Go to Perplexity API page
- Click "Generate API Key"
- Copy API key (save for later)
API Pricing
Perplexity API charges based on usage. Check free tier and paid plans.
⚙️ Step 2: Configure KIRA
1. Launch KIRA App
Open the Environment Variables tab.
2. Find Perplexity Section
MCP Settings > Perplexity
3. Enable Setting
- Turn the toggle switch ON
4. Enter API Key
- PERPLEXITY_API_KEY: The API key you copied
5. Save Settings
- Click "Save Settings" button
- Restart server
✅ Step 3: Test
Ask KIRA on Slack:
What's the weather in Seoul today?Search for recent AI newsKIRA will search real-time information and respond.
🎯 Usage Examples
Weather Info
User: Tell me tomorrow's weather in New York
KIRA: [Perplexity search] Tomorrow New York will be sunny with a high of 65°F...Latest News
User: Summarize today's top news
KIRA: [Perplexity search] 1. ... 2. ... 3. ...Real-time Info
User: What's the current Bitcoin price?
KIRA: [Perplexity search] Current Bitcoin price is...🔧 Troubleshooting
"API key is invalid"
- Verify API key is entered correctly
- Check if API key is activated on Perplexity website
"Rate limit exceeded"
- API usage limit exceeded
- Check usage on Perplexity dashboard
- Consider upgrading to paid plan
No search results
- Verify PERPLEXITY_ENABLED is set to True
- Confirm server was restarted
- Check logs for error messages
💡 Tips
Effective Search Queries
- ✅ "Seoul weather November 2024"
- ✅ "AI news from last week"
- ❌ "weather" (too vague)
Cost Saving
- Only request web search when needed
- Simple questions can be answered with KIRA's built-in knowledge