mirror of
https://github.com/hwchase17/langchain.git
synced 2025-10-22 09:41:52 +00:00
72 lines
2.1 KiB
Python
72 lines
2.1 KiB
Python
"""Tool for the DataForSeo SERP API."""
|
|
|
|
from typing import Optional
|
|
|
|
from pydantic.fields import Field
|
|
|
|
from langchain.callbacks.manager import (
|
|
AsyncCallbackManagerForToolRun,
|
|
CallbackManagerForToolRun,
|
|
)
|
|
from langchain.tools.base import BaseTool
|
|
from langchain.utilities.dataforseo_api_search import DataForSeoAPIWrapper
|
|
|
|
|
|
class DataForSeoAPISearchRun(BaseTool):
|
|
"""Tool that queries the DataForSeo Google search API."""
|
|
|
|
name = "dataforseo_api_search"
|
|
description = (
|
|
"A robust Google Search API provided by DataForSeo."
|
|
"This tool is handy when you need information about trending topics "
|
|
"or current events."
|
|
)
|
|
api_wrapper: DataForSeoAPIWrapper
|
|
|
|
def _run(
|
|
self,
|
|
query: str,
|
|
run_manager: Optional[CallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool."""
|
|
return str(self.api_wrapper.run(query))
|
|
|
|
async def _arun(
|
|
self,
|
|
query: str,
|
|
run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool asynchronously."""
|
|
return (await self.api_wrapper.arun(query)).__str__()
|
|
|
|
|
|
class DataForSeoAPISearchResults(BaseTool):
|
|
"""Tool that queries the DataForSeo Google Search API
|
|
and get back json."""
|
|
|
|
name = "DataForSeo Results JSON"
|
|
description = (
|
|
"A comprehensive Google Search API provided by DataForSeo."
|
|
"This tool is useful for obtaining real-time data on current events "
|
|
"or popular searches."
|
|
"The input should be a search query and the output is a JSON object "
|
|
"of the query results."
|
|
)
|
|
api_wrapper: DataForSeoAPIWrapper = Field(default_factory=DataForSeoAPIWrapper)
|
|
|
|
def _run(
|
|
self,
|
|
query: str,
|
|
run_manager: Optional[CallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool."""
|
|
return str(self.api_wrapper.results(query))
|
|
|
|
async def _arun(
|
|
self,
|
|
query: str,
|
|
run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool asynchronously."""
|
|
return (await self.api_wrapper.aresults(query)).__str__()
|