agno 2.0.1__py3-none-any.whl → 2.3.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. agno/agent/agent.py +6015 -2823
  2. agno/api/api.py +2 -0
  3. agno/api/os.py +1 -1
  4. agno/culture/__init__.py +3 -0
  5. agno/culture/manager.py +956 -0
  6. agno/db/async_postgres/__init__.py +3 -0
  7. agno/db/base.py +385 -6
  8. agno/db/dynamo/dynamo.py +388 -81
  9. agno/db/dynamo/schemas.py +47 -10
  10. agno/db/dynamo/utils.py +63 -4
  11. agno/db/firestore/firestore.py +435 -64
  12. agno/db/firestore/schemas.py +11 -0
  13. agno/db/firestore/utils.py +102 -4
  14. agno/db/gcs_json/gcs_json_db.py +384 -42
  15. agno/db/gcs_json/utils.py +60 -26
  16. agno/db/in_memory/in_memory_db.py +351 -66
  17. agno/db/in_memory/utils.py +60 -2
  18. agno/db/json/json_db.py +339 -48
  19. agno/db/json/utils.py +60 -26
  20. agno/db/migrations/manager.py +199 -0
  21. agno/db/migrations/v1_to_v2.py +510 -37
  22. agno/db/migrations/versions/__init__.py +0 -0
  23. agno/db/migrations/versions/v2_3_0.py +938 -0
  24. agno/db/mongo/__init__.py +15 -1
  25. agno/db/mongo/async_mongo.py +2036 -0
  26. agno/db/mongo/mongo.py +653 -76
  27. agno/db/mongo/schemas.py +13 -0
  28. agno/db/mongo/utils.py +80 -8
  29. agno/db/mysql/mysql.py +687 -25
  30. agno/db/mysql/schemas.py +61 -37
  31. agno/db/mysql/utils.py +60 -2
  32. agno/db/postgres/__init__.py +2 -1
  33. agno/db/postgres/async_postgres.py +2001 -0
  34. agno/db/postgres/postgres.py +676 -57
  35. agno/db/postgres/schemas.py +43 -18
  36. agno/db/postgres/utils.py +164 -2
  37. agno/db/redis/redis.py +344 -38
  38. agno/db/redis/schemas.py +18 -0
  39. agno/db/redis/utils.py +60 -2
  40. agno/db/schemas/__init__.py +2 -1
  41. agno/db/schemas/culture.py +120 -0
  42. agno/db/schemas/memory.py +13 -0
  43. agno/db/singlestore/schemas.py +26 -1
  44. agno/db/singlestore/singlestore.py +687 -53
  45. agno/db/singlestore/utils.py +60 -2
  46. agno/db/sqlite/__init__.py +2 -1
  47. agno/db/sqlite/async_sqlite.py +2371 -0
  48. agno/db/sqlite/schemas.py +24 -0
  49. agno/db/sqlite/sqlite.py +774 -85
  50. agno/db/sqlite/utils.py +168 -5
  51. agno/db/surrealdb/__init__.py +3 -0
  52. agno/db/surrealdb/metrics.py +292 -0
  53. agno/db/surrealdb/models.py +309 -0
  54. agno/db/surrealdb/queries.py +71 -0
  55. agno/db/surrealdb/surrealdb.py +1361 -0
  56. agno/db/surrealdb/utils.py +147 -0
  57. agno/db/utils.py +50 -22
  58. agno/eval/accuracy.py +50 -43
  59. agno/eval/performance.py +6 -3
  60. agno/eval/reliability.py +6 -3
  61. agno/eval/utils.py +33 -16
  62. agno/exceptions.py +68 -1
  63. agno/filters.py +354 -0
  64. agno/guardrails/__init__.py +6 -0
  65. agno/guardrails/base.py +19 -0
  66. agno/guardrails/openai.py +144 -0
  67. agno/guardrails/pii.py +94 -0
  68. agno/guardrails/prompt_injection.py +52 -0
  69. agno/integrations/discord/client.py +1 -0
  70. agno/knowledge/chunking/agentic.py +13 -10
  71. agno/knowledge/chunking/fixed.py +1 -1
  72. agno/knowledge/chunking/semantic.py +40 -8
  73. agno/knowledge/chunking/strategy.py +59 -15
  74. agno/knowledge/embedder/aws_bedrock.py +9 -4
  75. agno/knowledge/embedder/azure_openai.py +54 -0
  76. agno/knowledge/embedder/base.py +2 -0
  77. agno/knowledge/embedder/cohere.py +184 -5
  78. agno/knowledge/embedder/fastembed.py +1 -1
  79. agno/knowledge/embedder/google.py +79 -1
  80. agno/knowledge/embedder/huggingface.py +9 -4
  81. agno/knowledge/embedder/jina.py +63 -0
  82. agno/knowledge/embedder/mistral.py +78 -11
  83. agno/knowledge/embedder/nebius.py +1 -1
  84. agno/knowledge/embedder/ollama.py +13 -0
  85. agno/knowledge/embedder/openai.py +37 -65
  86. agno/knowledge/embedder/sentence_transformer.py +8 -4
  87. agno/knowledge/embedder/vllm.py +262 -0
  88. agno/knowledge/embedder/voyageai.py +69 -16
  89. agno/knowledge/knowledge.py +594 -186
  90. agno/knowledge/reader/base.py +9 -2
  91. agno/knowledge/reader/csv_reader.py +8 -10
  92. agno/knowledge/reader/docx_reader.py +5 -6
  93. agno/knowledge/reader/field_labeled_csv_reader.py +290 -0
  94. agno/knowledge/reader/json_reader.py +6 -5
  95. agno/knowledge/reader/markdown_reader.py +13 -13
  96. agno/knowledge/reader/pdf_reader.py +43 -68
  97. agno/knowledge/reader/pptx_reader.py +101 -0
  98. agno/knowledge/reader/reader_factory.py +51 -6
  99. agno/knowledge/reader/s3_reader.py +3 -15
  100. agno/knowledge/reader/tavily_reader.py +194 -0
  101. agno/knowledge/reader/text_reader.py +13 -13
  102. agno/knowledge/reader/web_search_reader.py +2 -43
  103. agno/knowledge/reader/website_reader.py +43 -25
  104. agno/knowledge/reranker/__init__.py +2 -8
  105. agno/knowledge/types.py +9 -0
  106. agno/knowledge/utils.py +20 -0
  107. agno/media.py +72 -0
  108. agno/memory/manager.py +336 -82
  109. agno/models/aimlapi/aimlapi.py +2 -2
  110. agno/models/anthropic/claude.py +183 -37
  111. agno/models/aws/bedrock.py +52 -112
  112. agno/models/aws/claude.py +33 -1
  113. agno/models/azure/ai_foundry.py +33 -15
  114. agno/models/azure/openai_chat.py +25 -8
  115. agno/models/base.py +999 -519
  116. agno/models/cerebras/cerebras.py +19 -13
  117. agno/models/cerebras/cerebras_openai.py +8 -5
  118. agno/models/cohere/chat.py +27 -1
  119. agno/models/cometapi/__init__.py +5 -0
  120. agno/models/cometapi/cometapi.py +57 -0
  121. agno/models/dashscope/dashscope.py +1 -0
  122. agno/models/deepinfra/deepinfra.py +2 -2
  123. agno/models/deepseek/deepseek.py +2 -2
  124. agno/models/fireworks/fireworks.py +2 -2
  125. agno/models/google/gemini.py +103 -31
  126. agno/models/groq/groq.py +28 -11
  127. agno/models/huggingface/huggingface.py +2 -1
  128. agno/models/internlm/internlm.py +2 -2
  129. agno/models/langdb/langdb.py +4 -4
  130. agno/models/litellm/chat.py +18 -1
  131. agno/models/litellm/litellm_openai.py +2 -2
  132. agno/models/llama_cpp/__init__.py +5 -0
  133. agno/models/llama_cpp/llama_cpp.py +22 -0
  134. agno/models/message.py +139 -0
  135. agno/models/meta/llama.py +27 -10
  136. agno/models/meta/llama_openai.py +5 -17
  137. agno/models/nebius/nebius.py +6 -6
  138. agno/models/nexus/__init__.py +3 -0
  139. agno/models/nexus/nexus.py +22 -0
  140. agno/models/nvidia/nvidia.py +2 -2
  141. agno/models/ollama/chat.py +59 -5
  142. agno/models/openai/chat.py +69 -29
  143. agno/models/openai/responses.py +103 -106
  144. agno/models/openrouter/openrouter.py +41 -3
  145. agno/models/perplexity/perplexity.py +4 -5
  146. agno/models/portkey/portkey.py +3 -3
  147. agno/models/requesty/__init__.py +5 -0
  148. agno/models/requesty/requesty.py +52 -0
  149. agno/models/response.py +77 -1
  150. agno/models/sambanova/sambanova.py +2 -2
  151. agno/models/siliconflow/__init__.py +5 -0
  152. agno/models/siliconflow/siliconflow.py +25 -0
  153. agno/models/together/together.py +2 -2
  154. agno/models/utils.py +254 -8
  155. agno/models/vercel/v0.py +2 -2
  156. agno/models/vertexai/__init__.py +0 -0
  157. agno/models/vertexai/claude.py +96 -0
  158. agno/models/vllm/vllm.py +1 -0
  159. agno/models/xai/xai.py +3 -2
  160. agno/os/app.py +543 -178
  161. agno/os/auth.py +24 -14
  162. agno/os/config.py +1 -0
  163. agno/os/interfaces/__init__.py +1 -0
  164. agno/os/interfaces/a2a/__init__.py +3 -0
  165. agno/os/interfaces/a2a/a2a.py +42 -0
  166. agno/os/interfaces/a2a/router.py +250 -0
  167. agno/os/interfaces/a2a/utils.py +924 -0
  168. agno/os/interfaces/agui/agui.py +23 -7
  169. agno/os/interfaces/agui/router.py +27 -3
  170. agno/os/interfaces/agui/utils.py +242 -142
  171. agno/os/interfaces/base.py +6 -2
  172. agno/os/interfaces/slack/router.py +81 -23
  173. agno/os/interfaces/slack/slack.py +29 -14
  174. agno/os/interfaces/whatsapp/router.py +11 -4
  175. agno/os/interfaces/whatsapp/whatsapp.py +14 -7
  176. agno/os/mcp.py +111 -54
  177. agno/os/middleware/__init__.py +7 -0
  178. agno/os/middleware/jwt.py +233 -0
  179. agno/os/router.py +556 -139
  180. agno/os/routers/evals/evals.py +71 -34
  181. agno/os/routers/evals/schemas.py +31 -31
  182. agno/os/routers/evals/utils.py +6 -5
  183. agno/os/routers/health.py +31 -0
  184. agno/os/routers/home.py +52 -0
  185. agno/os/routers/knowledge/knowledge.py +185 -38
  186. agno/os/routers/knowledge/schemas.py +82 -22
  187. agno/os/routers/memory/memory.py +158 -53
  188. agno/os/routers/memory/schemas.py +20 -16
  189. agno/os/routers/metrics/metrics.py +20 -8
  190. agno/os/routers/metrics/schemas.py +16 -16
  191. agno/os/routers/session/session.py +499 -38
  192. agno/os/schema.py +308 -198
  193. agno/os/utils.py +401 -41
  194. agno/reasoning/anthropic.py +80 -0
  195. agno/reasoning/azure_ai_foundry.py +2 -2
  196. agno/reasoning/deepseek.py +2 -2
  197. agno/reasoning/default.py +3 -1
  198. agno/reasoning/gemini.py +73 -0
  199. agno/reasoning/groq.py +2 -2
  200. agno/reasoning/ollama.py +2 -2
  201. agno/reasoning/openai.py +7 -2
  202. agno/reasoning/vertexai.py +76 -0
  203. agno/run/__init__.py +6 -0
  204. agno/run/agent.py +248 -94
  205. agno/run/base.py +44 -5
  206. agno/run/team.py +238 -97
  207. agno/run/workflow.py +144 -33
  208. agno/session/agent.py +105 -89
  209. agno/session/summary.py +65 -25
  210. agno/session/team.py +176 -96
  211. agno/session/workflow.py +406 -40
  212. agno/team/team.py +3854 -1610
  213. agno/tools/dalle.py +2 -4
  214. agno/tools/decorator.py +4 -2
  215. agno/tools/duckduckgo.py +15 -11
  216. agno/tools/e2b.py +14 -7
  217. agno/tools/eleven_labs.py +23 -25
  218. agno/tools/exa.py +21 -16
  219. agno/tools/file.py +153 -23
  220. agno/tools/file_generation.py +350 -0
  221. agno/tools/firecrawl.py +4 -4
  222. agno/tools/function.py +250 -30
  223. agno/tools/gmail.py +238 -14
  224. agno/tools/google_drive.py +270 -0
  225. agno/tools/googlecalendar.py +36 -8
  226. agno/tools/googlesheets.py +20 -5
  227. agno/tools/jira.py +20 -0
  228. agno/tools/knowledge.py +3 -3
  229. agno/tools/mcp/__init__.py +10 -0
  230. agno/tools/mcp/mcp.py +331 -0
  231. agno/tools/mcp/multi_mcp.py +347 -0
  232. agno/tools/mcp/params.py +24 -0
  233. agno/tools/mcp_toolbox.py +284 -0
  234. agno/tools/mem0.py +11 -17
  235. agno/tools/memori.py +1 -53
  236. agno/tools/memory.py +419 -0
  237. agno/tools/models/nebius.py +5 -5
  238. agno/tools/models_labs.py +20 -10
  239. agno/tools/notion.py +204 -0
  240. agno/tools/parallel.py +314 -0
  241. agno/tools/scrapegraph.py +58 -31
  242. agno/tools/searxng.py +2 -2
  243. agno/tools/serper.py +2 -2
  244. agno/tools/slack.py +18 -3
  245. agno/tools/spider.py +2 -2
  246. agno/tools/tavily.py +146 -0
  247. agno/tools/whatsapp.py +1 -1
  248. agno/tools/workflow.py +278 -0
  249. agno/tools/yfinance.py +12 -11
  250. agno/utils/agent.py +820 -0
  251. agno/utils/audio.py +27 -0
  252. agno/utils/common.py +90 -1
  253. agno/utils/events.py +217 -2
  254. agno/utils/gemini.py +180 -22
  255. agno/utils/hooks.py +57 -0
  256. agno/utils/http.py +111 -0
  257. agno/utils/knowledge.py +12 -5
  258. agno/utils/log.py +1 -0
  259. agno/utils/mcp.py +92 -2
  260. agno/utils/media.py +188 -10
  261. agno/utils/merge_dict.py +22 -1
  262. agno/utils/message.py +60 -0
  263. agno/utils/models/claude.py +40 -11
  264. agno/utils/print_response/agent.py +105 -21
  265. agno/utils/print_response/team.py +103 -38
  266. agno/utils/print_response/workflow.py +251 -34
  267. agno/utils/reasoning.py +22 -1
  268. agno/utils/serialize.py +32 -0
  269. agno/utils/streamlit.py +16 -10
  270. agno/utils/string.py +41 -0
  271. agno/utils/team.py +98 -9
  272. agno/utils/tools.py +1 -1
  273. agno/vectordb/base.py +23 -4
  274. agno/vectordb/cassandra/cassandra.py +65 -9
  275. agno/vectordb/chroma/chromadb.py +182 -38
  276. agno/vectordb/clickhouse/clickhousedb.py +64 -11
  277. agno/vectordb/couchbase/couchbase.py +105 -10
  278. agno/vectordb/lancedb/lance_db.py +124 -133
  279. agno/vectordb/langchaindb/langchaindb.py +25 -7
  280. agno/vectordb/lightrag/lightrag.py +17 -3
  281. agno/vectordb/llamaindex/__init__.py +3 -0
  282. agno/vectordb/llamaindex/llamaindexdb.py +46 -7
  283. agno/vectordb/milvus/milvus.py +126 -9
  284. agno/vectordb/mongodb/__init__.py +7 -1
  285. agno/vectordb/mongodb/mongodb.py +112 -7
  286. agno/vectordb/pgvector/pgvector.py +142 -21
  287. agno/vectordb/pineconedb/pineconedb.py +80 -8
  288. agno/vectordb/qdrant/qdrant.py +125 -39
  289. agno/vectordb/redis/__init__.py +9 -0
  290. agno/vectordb/redis/redisdb.py +694 -0
  291. agno/vectordb/singlestore/singlestore.py +111 -25
  292. agno/vectordb/surrealdb/surrealdb.py +31 -5
  293. agno/vectordb/upstashdb/upstashdb.py +76 -8
  294. agno/vectordb/weaviate/weaviate.py +86 -15
  295. agno/workflow/__init__.py +2 -0
  296. agno/workflow/agent.py +299 -0
  297. agno/workflow/condition.py +112 -18
  298. agno/workflow/loop.py +69 -10
  299. agno/workflow/parallel.py +266 -118
  300. agno/workflow/router.py +110 -17
  301. agno/workflow/step.py +638 -129
  302. agno/workflow/steps.py +65 -6
  303. agno/workflow/types.py +61 -23
  304. agno/workflow/workflow.py +2085 -272
  305. {agno-2.0.1.dist-info → agno-2.3.0.dist-info}/METADATA +182 -58
  306. agno-2.3.0.dist-info/RECORD +577 -0
  307. agno/knowledge/reader/url_reader.py +0 -128
  308. agno/tools/googlesearch.py +0 -98
  309. agno/tools/mcp.py +0 -610
  310. agno/utils/models/aws_claude.py +0 -170
  311. agno-2.0.1.dist-info/RECORD +0 -515
  312. {agno-2.0.1.dist-info → agno-2.3.0.dist-info}/WHEEL +0 -0
  313. {agno-2.0.1.dist-info → agno-2.3.0.dist-info}/licenses/LICENSE +0 -0
  314. {agno-2.0.1.dist-info → agno-2.3.0.dist-info}/top_level.txt +0 -0
@@ -1,128 +0,0 @@
1
- from io import BytesIO
2
- from os.path import basename
3
- from pathlib import Path
4
- from typing import List, Optional
5
- from urllib.parse import urlparse
6
-
7
- import httpx
8
-
9
- from agno.knowledge.chunking.fixed import FixedSizeChunking
10
- from agno.knowledge.chunking.strategy import ChunkingStrategy, ChunkingStrategyType
11
- from agno.knowledge.document.base import Document
12
- from agno.knowledge.reader.base import Reader
13
- from agno.knowledge.reader.csv_reader import CSVReader
14
- from agno.knowledge.reader.pdf_reader import PDFReader
15
- from agno.knowledge.types import ContentType
16
- from agno.utils.http import async_fetch_with_retry, fetch_with_retry
17
- from agno.utils.log import log_debug
18
-
19
-
20
- class URLReader(Reader):
21
- """Reader for general URL content"""
22
-
23
- def __init__(
24
- self, chunking_strategy: Optional[ChunkingStrategy] = FixedSizeChunking(), proxy: Optional[str] = None, **kwargs
25
- ):
26
- super().__init__(chunking_strategy=chunking_strategy, **kwargs)
27
- self.proxy = proxy
28
-
29
- @classmethod
30
- def get_supported_chunking_strategies(self) -> List[ChunkingStrategyType]:
31
- """Get the list of supported chunking strategies for URL readers."""
32
- return [
33
- ChunkingStrategyType.FIXED_SIZE_CHUNKER,
34
- ChunkingStrategyType.AGENTIC_CHUNKER,
35
- ChunkingStrategyType.DOCUMENT_CHUNKER,
36
- ChunkingStrategyType.RECURSIVE_CHUNKER,
37
- ChunkingStrategyType.SEMANTIC_CHUNKER,
38
- ]
39
-
40
- @classmethod
41
- def get_supported_content_types(self) -> List[ContentType]:
42
- return [ContentType.URL]
43
-
44
- def read(
45
- self, url: str, id: Optional[str] = None, name: Optional[str] = None, password: Optional[str] = None
46
- ) -> List[Document]:
47
- if not url:
48
- raise ValueError("No url provided")
49
-
50
- log_debug(f"Reading: {url}")
51
-
52
- # Retry the request up to 3 times with exponential backoff
53
- response = fetch_with_retry(url, proxy=self.proxy)
54
-
55
- documents = self._create_documents(
56
- url=url, text=response.text, content=response.content, id=id, name=name, password=password
57
- )
58
-
59
- if not self.chunk:
60
- return documents
61
-
62
- chunked_documents = []
63
- for document in documents:
64
- chunked_documents.append(self.chunk_document(document))
65
- return [doc for sublist in chunked_documents for doc in sublist]
66
-
67
- async def async_read(
68
- self, url: str, id: Optional[str] = None, name: Optional[str] = None, password: Optional[str] = None
69
- ) -> List[Document]:
70
- """Async version of read method"""
71
- if not url:
72
- raise ValueError("No url provided")
73
-
74
- log_debug(f"Reading async: {url}")
75
- client_args = {"proxy": self.proxy} if self.proxy else {}
76
- async with httpx.AsyncClient(**client_args) as client: # type: ignore
77
- response = await async_fetch_with_retry(url, client=client)
78
-
79
- documents = self._create_documents(
80
- url=url, text=response.text, content=response.content, id=id, name=name, password=password
81
- )
82
-
83
- if not self.chunk:
84
- return documents
85
-
86
- return await self.chunk_documents_async(documents)
87
-
88
- def _create_documents(
89
- self,
90
- url: str,
91
- text: str,
92
- content: bytes,
93
- id: Optional[str] = None,
94
- name: Optional[str] = None,
95
- password: Optional[str] = None,
96
- ) -> List[Document]:
97
- """Helper method to create a document from URL content"""
98
-
99
- # Determine file extension from URL
100
- parsed_url = urlparse(url)
101
- url_path = Path(parsed_url.path) # type: ignore
102
- file_extension = url_path.suffix.lower()
103
-
104
- # Read the document using the appropriate reader
105
- if file_extension == ".csv":
106
- filename = basename(parsed_url.path) or "data.csv"
107
- return CSVReader().read(file=BytesIO(content), name=filename)
108
- elif file_extension == ".pdf":
109
- if password:
110
- return PDFReader().read(pdf=BytesIO(content), name=name, password=password)
111
- else:
112
- return PDFReader().read(pdf=BytesIO(content), name=name)
113
- else:
114
- doc_name = name or parsed_url.path.strip("/").replace("/", "_").replace(" ", "_")
115
- if not doc_name:
116
- doc_name = parsed_url.netloc
117
- if not doc_name:
118
- doc_name = url
119
-
120
- return [
121
- Document(
122
- name=doc_name,
123
- id=id or doc_name,
124
- meta_data={"url": url},
125
- content=text,
126
- size=len(text),
127
- )
128
- ]
@@ -1,98 +0,0 @@
1
- import json
2
- from typing import Any, Dict, List, Optional
3
-
4
- from agno.tools import Toolkit
5
- from agno.utils.log import log_debug
6
-
7
- try:
8
- from googlesearch import search
9
- except ImportError:
10
- raise ImportError("`googlesearch-python` not installed. Please install using `pip install googlesearch-python`")
11
-
12
- try:
13
- from pycountry import pycountry
14
- except ImportError:
15
- raise ImportError("`pycountry` not installed. Please install using `pip install pycountry`")
16
-
17
-
18
- class GoogleSearchTools(Toolkit):
19
- """
20
- GoogleSearch is a Python library for searching Google easily.
21
- It uses requests and BeautifulSoup4 to scrape Google.
22
-
23
- Args:
24
- fixed_max_results (Optional[int]): A fixed number of maximum results.
25
- fixed_language (Optional[str]): Language of the search results.
26
- headers (Optional[Any]): Custom headers for the request.
27
- proxy (Optional[str]): Proxy settings for the request.
28
- timeout (Optional[int]): Timeout for the request, default is 10 seconds.
29
- cache_results (bool): Enable caching of search results.
30
- cache_ttl (int): Time-to-live for cached results in seconds.
31
- cache_dir (Optional[str]): Directory to store cache files.
32
- enable_google_search (bool): Enable Google search.
33
- all (bool): Enable all tools.
34
- """
35
-
36
- def __init__(
37
- self,
38
- fixed_max_results: Optional[int] = None,
39
- fixed_language: Optional[str] = None,
40
- headers: Optional[Any] = None,
41
- proxy: Optional[str] = None,
42
- timeout: Optional[int] = 10,
43
- enable_google_search: bool = True,
44
- all: bool = False,
45
- **kwargs,
46
- ):
47
- self.fixed_max_results: Optional[int] = fixed_max_results
48
- self.fixed_language: Optional[str] = fixed_language
49
- self.headers: Optional[Any] = headers
50
- self.proxy: Optional[str] = proxy
51
- self.timeout: Optional[int] = timeout
52
-
53
- tools = []
54
- if all or enable_google_search:
55
- tools.append(self.google_search)
56
-
57
- super().__init__(name="google_search_tools", tools=tools, **kwargs)
58
-
59
- def google_search(self, query: str, max_results: int = 5, language: str = "en") -> str:
60
- """
61
- Use this function to search Google for a specified query.
62
-
63
- Args:
64
- query (str): The query to search for.
65
- max_results (int, optional): The maximum number of results to return. Default is 5.
66
- language (str, optional): The language of the search results. Default is "en".
67
-
68
- Returns:
69
- str: A JSON formatted string containing the search results.
70
- """
71
- max_results = self.fixed_max_results or max_results
72
- language = self.fixed_language or language
73
-
74
- # Resolve language to ISO 639-1 code if needed
75
- if len(language) != 2:
76
- _language = pycountry.languages.lookup(language)
77
- if _language:
78
- language = _language.alpha_2
79
- else:
80
- language = "en"
81
-
82
- log_debug(f"Searching Google [{language}] for: {query}")
83
-
84
- # Perform Google search using the googlesearch-python package
85
- results = list(search(query, num=max_results, lang=language))
86
-
87
- # Collect the search results
88
- res: List[Dict[str, str]] = []
89
- for result in results:
90
- res.append(
91
- {
92
- "title": result.title,
93
- "url": result.url,
94
- "description": result.description,
95
- }
96
- )
97
-
98
- return json.dumps(res, indent=2)