跳转到主要内容

​
SerperDevTool

​
描述

此工具旨在针对指定查询，在互联网上对文本内容进行语义搜索。它利用 serper.dev API 来获取并显示基于用户提供查询的最相关搜索结果。

​
安装

要有效使用 SerperDevTool，请遵循以下步骤：
  1. 安装包：确认您的 Python 环境中已安装 crewai[tools] 包。
  2. 获取 API 密钥：在 https://serper.dev/ 获取一个 serper.dev API 密钥（提供免费套餐）。
  3. 配置环境：将您获得的 API 密钥存储在一个名为 SERPER_API_KEY 的环境变量中，以便工具使用。
要将此工具整合到您的项目中，请遵循以下安装说明： 
pip install 'crewai[tools]'

​
示例

以下示例演示了如何初始化该工具并使用给定查询执行搜索：
代码
from crewai_tools import SerperDevTool

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

​
参数

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 项目中，用户能够直接从他们的应用程序中进行实时、相关的互联网搜索。更新后的参数允许更定制化和本地化的搜索结果。通过遵守提供的设置和使用指南，将此工具集成到项目中将变得简化和直接。
⌘我