Merge pull request #428 from asiffarhankhan/main

Add .py files for all existing .mdx tools, Add .mdx, .py for the new AgentQL tool

Author: MervinPraison

docs/tools/external/agentql-toolkit.mdx

@@ -0,0 +1,52 @@
+---
+title: "AgentQL structured data extraction Tool"
+description: "Guide for using the AgentQL structured data extraction with PraisonAI agents."
+icon: "code"
+---
+
+## Overview
+
+AgentQL is a tool that allows you to extract structured data from webpages using AI Agents.
+
+```bash
+pip install langchain_agentql langchain-community
+```
+
+```bash
+os.environ["AGENTQL_API_KEY"] = "your_api_key_here"
+```
+
+```python
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_agentql.tools import ExtractWebDataTool
+from dotenv import load_dotenv
+
+import os
+
+os.environ["AGENTQL_API_KEY"] = os.getenv('AGENTQL_API_KEY')
+
+def extract_web_data_tool(url, query):
+    agentql_tool = ExtractWebDataTool().invoke(
+        {
+            "url": url,
+            "prompt": query,
+        },)
+    return agentql_tool
+
+# Create agent with web extraction instructions
+orchestration_agent = Agent(
+    instructions="""Extract All 37 products from the url https://www.colorbarcosmetics.com/bestsellers along with its name, overview, description, price and additional information by recursively clicking on each product""",
+    tools=[extract_web_data_tool]
+)
+
+# Initialize and run agents
+agents = PraisonAIAgents(agents=[orchestration_agent])
+agents.start()
+```
+
+## Getting Started
+
+1. Get your AgentQL API key from [AgentQL Dashboard](https://agentql.com)
+2. Set the API key in your environment variables
+3. Install the required dependencies
+4. Use the example code to start extracting structured data

examples/tools/langchain/agentql-toolkit.py

@@ -0,0 +1,27 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_agentql.tools import ExtractWebDataTool
+from dotenv import load_dotenv
+
+load_dotenv()
+import os
+
+os.environ["AGENTQL_API_KEY"] = os.getenv('AGENTQL_API_KEY')
+
+def extract_web_data_tool(url, query):
+    agentql_tool = ExtractWebDataTool().invoke(
+        {
+            "url": url,
+            "prompt": query,
+        },)
+    return agentql_tool
+
+
+# Create agent with web extraction instructions
+orchestration_agent = Agent(
+    instructions="""Extract All 37 products from the url https://www.colorbarcosmetics.com/bestsellers along with its name, overview, description, price and additional information by recursively clicking on each product""",
+    tools=[extract_web_data_tool]
+)
+
+# Initialize and run agents
+agents = PraisonAIAgents(agents=[orchestration_agent])
+agents.start()

examples/tools/langchain/azure-code-interpreter.py

@@ -0,0 +1,12 @@
+from praisonaiagents import Agent, PraisonAIAgents
+import getpass
+from langchain_azure_dynamic_sessions import SessionsPythonREPLTool
+
+POOL_MANAGEMENT_ENDPOINT = getpass.getpass()
+
+coder_agent = Agent(instructions="""word = "strawberry"
+                                    count = word.count("r")
+                                    print(f"There are {count}'R's in the word 'Strawberry'")""", tools=[SessionsPythonREPLTool])
+
+agents = PraisonAIAgents(agents=[coder_agent])
+agents.start()

examples/tools/langchain/bearly-code-interpreter.py

@@ -0,0 +1,8 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.tools import BearlyInterpreterTool
+
+coder_agent = Agent(instructions="""for i in range(0,10):
+                                        print(f'The number is {i}')""", tools=[BearlyInterpreterTool])
+
+agents = PraisonAIAgents(agents=[coder_agent])
+agents.start()

examples/tools/langchain/duckduckgo-search.py

@@ -0,0 +1,7 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from praisonaiagents.tools import duckduckgo
+
+data_agent = Agent(instructions="Search and Read Research Papers on DNA Mutation", tools=[duckduckgo])
+editor_agent = Agent(instructions="Write a scientifically researched outcome and findings about DNA Mutation")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent])
+agents.start()

examples/tools/langchain/exa-search.py

@@ -0,0 +1,17 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from exa_py import Exa
+import os
+
+exa = Exa(api_key=os.environ["EXA_API_KEY"])
+
+def search_and_contents(query: str):
+    """Search for webpages based on the query and retrieve their contents."""
+    # This combines two API endpoints: search and contents retrieval
+    return str(exa.search_and_contents(
+        query, use_autoprompt=False, num_results=5, text=True, highlights=True
+    ))
+
+data_agent = Agent(instructions="Find the latest jobs for Video Editor in New York at startups", tools=[search_and_contents])
+editor_agent = Agent(instructions="Curate the available jobs at startups and their email for the candidate to apply based on his skills on Canva, Adobe Premiere Pro, and Adobe After Effects")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent], process='hierarchical')
+agents.start()

examples/tools/langchain/google-search.py

@@ -0,0 +1,8 @@
+import os 
+from langchain_google_community import GoogleSearchAPIWrapper
+from praisonaiagents import Agent, PraisonAIAgents
+
+data_agent = Agent(instructions="Search about best places to visit in India during Summer", tools=[GoogleSearchAPIWrapper])
+editor_agent = Agent(instructions="Write a blog article")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent], process='hierarchical')
+agents.start()

examples/tools/langchain/google-serper-search.py

@@ -0,0 +1,15 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.utilities import GoogleSerperAPIWrapper
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+os.environ['SERPER_API_KEY'] = os.getenv('SERPER_API_KEY')
+
+search = GoogleSerperAPIWrapper()
+
+data_agent = Agent(instructions="Suggest me top 5 most visited websites for Dosa Recipe", tools=[search])
+editor_agent = Agent(instructions="List out the websites with their url and a short description")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent])
+agents.start()

examples/tools/langchain/jina-code-interpreter.py

@@ -0,0 +1,9 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.tools.riza.command import ExecPython
+
+coder_agent = Agent(instructions="""word = "strawberry"
+                                    count = word.count("r")
+                                    print(f"There are {count}'R's in the word 'Strawberry'")""", tools=[ExecPython])
+
+agents = PraisonAIAgents(agents=[coder_agent])
+agents.start()

examples/tools/langchain/jina-search.py

@@ -0,0 +1,19 @@
+from praisonaiagents import Agent, PraisonAIAgents
+from langchain_community.tools import JinaSearch
+import os 
+
+def invoke_jina_search(query: str):
+    JinaSearchTool = JinaSearch()
+    model_generated_tool_call = {
+        "args": {"query": query},
+        "id": "1",
+        "name": JinaSearchTool.name,
+        "type": "tool_call",
+    }
+    tool_msg = JinaSearchTool.invoke(model_generated_tool_call)
+    return(tool_msg.content[:1000])
+
+data_agent = Agent(instructions="Find 10 websites where I can learn coding for free", tools=[invoke_jina_search])
+editor_agent = Agent(instructions="write a listicle blog ranking the best websites. The blog should contain a proper intro and conclusion")
+agents = PraisonAIAgents(agents=[data_agent, editor_agent], process='hierarchical')
+agents.start()