​
SerperDevTool

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

​
描述

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

​
安装

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

pip install 'crewai[tools]'

​
示例

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

Code
from crewai_tools import SerperDevTool

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

​
入门步骤

要有效使用SerperDevTool，请按照以下步骤操作：

  1. 包安装：确认crewai[tools]包已安装在您的Python环境中。
  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 上找到。

​
带参数的示例

以下是一个示例，展示了如何使用带有额外参数的工具：

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

这个页面有帮助吗？

Github SearchJSON RAG Search