​
SerperDevTool

我们仍在努力改进工具，因此未来可能会出现意外的行为或更改。

​
描述

此工具旨在对文本内容中的指定查询进行语义搜索。它利用 serper.dev API 根据用户提供的查询获取并显示最相关的搜索结果。

​
安装

要将此工具集成到您的项目中，请按照下面的安装说明进行操作

pip install 'crewai[tools]'

​
示例

以下示例演示了如何初始化工具并使用给定查询执行搜索

代码
from crewai_tools import SerperDevTool

# Initialize the tool for internet searching capabilities
tool = SerperDevTool()

​
入门步骤

为了有效使用 SerperDevTool，请按照以下步骤操作

  1. 软件包安装：确认您的 Python 环境中已安装 crewai[tools] 软件包。
  2. API 密钥获取：在 serper.dev 注册免费账户以获取 serper.dev API 密钥。
  3. 环境配置：将获取的 API 密钥存储在名为 SERPER_API_KEY 的环境变量中，以便工具使用。

​
参数

SerperDevTool 带有多个将传递给 API 的参数

  • search_url：搜索 API 的 URL 端点。（默认为 https://google.serper.dev/search）

  • country：可选。指定搜索结果的国家/地区。

  • location：可选。指定搜索结果的位置。

  • locale：可选。指定搜索结果的语言环境。

  • n_results：返回的搜索结果数量。默认为 10。

country、location、locale 和 search_url 的值可以在 Serper Playground 上找到。

​
带参数的示例

这里有一个示例，演示了如何使用附加参数来使用该工具

代码
from crewai_tools import SerperDevTool

tool = SerperDevTool(
    search_url="https://google.serper.dev/scholar",
    n_results=2,
)

print(tool.run(search_query="ChatGPT"))

# Using Tool: Search the internet

# Search results: Title: Role of chat gpt in public health
# Link: https://link.springer.com/article/10.1007/s10439-023-03172-7
# Snippet: … ChatGPT in public health. In this overview, we will examine the potential uses of ChatGPT in
# ---
# Title: Potential use of chat gpt in global warming
# Link: https://link.springer.com/article/10.1007/s10439-023-03171-8
# Snippet: … as ChatGPT, have the potential to play a critical role in advancing our understanding of climate
# ---
代码
from crewai_tools import SerperDevTool

tool = SerperDevTool(
    country="fr",
    locale="fr",
    location="Paris, Paris, Ile-de-France, France",
    n_results=2,
)

print(tool.run(search_query="Jeux Olympiques"))

# Using Tool: Search the internet

# Search results: Title: Jeux Olympiques de Paris 2024 - Actualités, calendriers, résultats
# Link: https://olympics.com/fr/paris-2024
# Snippet: Quels sont les sports présents aux Jeux Olympiques de Paris 2024 ? · Athlétisme · Aviron · Badminton · Basketball · Basketball 3x3 · Boxe · Breaking · Canoë ...
# ---
# Title: Billetterie Officielle de Paris 2024 - Jeux Olympiques et Paralympiques
# Link: https://tickets.paris2024.org/
# Snippet: Achetez vos billets exclusivement sur le site officiel de la billetterie de Paris 2024 pour participer au plus grand événement sportif au monde.
# ---

​
结论

通过将 SerperDevTool 集成到 Python 项目中，用户可以直接从其应用程序执行实时、相关的互联网搜索。更新后的参数允许进行更定制化和本地化的搜索结果。遵循提供的设置和使用指南，将此工具集成到项目中将变得简化和直接。