Merge pull request MervinPraison#406 from MervinPraison/develop

Add external search tool documentation for PraisonAI agents

Author: MervinPraison

docs/mint.json

@@ -206,6 +206,15 @@
       "pages": [
         "tools/tools",
         "tools/langchain_tools",
+        {
+          "group": "External Tools",
+          "icon": "subscript",
+          "pages": [
+            "tools/external/serp-api",
+            "tools/external/brave-search",
+            "tools/external/google-trends"
+          ]
+        },
         "tools/duckduckgo_tools",
         "tools/arxiv_tools",
         "tools/calculator_tools",

docs/tools/external/brave-search.mdx

@@ -0,0 +1,38 @@
+---
+title: "BraveSearch Tool"
+description: "Guide for using the BraveSearch tool with PraisonAI agents."
+icon: "magnifying-glass"
+---
+
+## Overview
+
+The BraveSearch tool is a tool that allows you to search the web using the BraveSearch API.
+
+```bash
+pip install langchain-community google-search-results
+``` 
+
+```bash
+export BRAVE_SEARCH_API=your_api_key_here
+export OPENAI_API_KEY=your_api_key_here
+```
+
+```python
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.tools import BraveSearch
+import os
+
+
+def search_brave(query: str):
+    """Searches using BraveSearch and returns results."""
+    api_key = os.environ['BRAVE_SEARCH_API']
+    tool = BraveSearch.from_api_key(api_key=api_key, search_kwargs={"count": 3})
+    return tool.run(query)
+
+data_agent = Agent(instructions="Search about AI job trends in 2025", tools=[search_brave])
+editor_agent = Agent(instructions="Write a blog article")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent])
+agents.start()
+```
+
+Generate your BraveSearch API key from [BraveSearch](https://brave.com/search/api/)

docs/tools/external/google-trends.mdx

@@ -1,29 +1,34 @@
+---
+title: "Google Trends Tool"
+description: "Guide for using the Google Trends tool with PraisonAI agents."
+icon: "arrow-trend-up"
+---
 
+## Overview
+
+The Google Trends tool is a tool that allows you to search the web using the Google Trends API.
+
+```bash
+pip install langchain-community google-search-results
+```
+
+```bash
+export SERPAPI_API_KEY=your_api_key_here
+```
 
 ```python
-import os
-from langchain_community.tools.google_trends import GoogleTrendsQueryRun
 from langchain_community.utilities.google_trends import GoogleTrendsAPIWrapper
 from praisonaiagents import Agent, PraisonAIAgents
 
-# Set your SerpApi API Key
-os.environ["SERPAPI_API_KEY"] = "your_serpapi_key_here"
-
-# Initialize the Google Trends API Wrapper and Tool
-google_trends_api_wrapper = GoogleTrendsAPIWrapper()
-google_trends_tool = GoogleTrendsQueryRun(api_wrapper=google_trends_api_wrapper)
-
-# Define your agents with appropriate tools
 research_agent = Agent(
     instructions="Research trending topics related to AI",
-    tools=[google_trends_tool]
+    tools=[GoogleTrendsAPIWrapper]
 )
 
 summarise_agent = Agent(
     instructions="Summarise findings from the research agent",
 )
 
-# Instantiate and start your PraisonAIAgents
 agents = PraisonAIAgents(agents=[research_agent, summarise_agent])
 agents.start()
 ```

docs/tools/external/serp-api.mdx

@@ -0,0 +1,26 @@
+---
+title: "SerpAPI Tool"
+description: "Guide for using the SerpAPI tool with PraisonAI agents."
+icon: "searchengin"
+---
+
+## Overview
+
+The SerpAPI tool is a tool that allows you to search the web using the SerpAPI.
+
+```bash
+pip install langchain-community google-search-results
+export SERPAPI_API_KEY=your_api_key_here
+export OPENAI_API_KEY=your_api_key_here
+```
+
+```python
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.utilities import SerpAPIWrapper
+
+data_agent = Agent(instructions="Search about AI job trends in 2025", tools=[SerpAPIWrapper])
+editor_agent = Agent(instructions="Write a blog article")
+
+agents = PraisonAIAgents(agents=[data_agent, editor_agent])
+agents.start()
+```