跳转到主要内容

​
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 项目中，用户可以直接从其应用程序中进行实时、相关的互联网搜索。更新后的参数允许更自定义和本地化的搜索结果。遵循提供的设置和使用指南，将此工具集成到项目中将变得简单明了。