​
BraveSearchTool

​
描述

此工具旨在利用 Brave Search API 执行网页搜索。它允许您使用指定的查询搜索互联网并检索相关结果。该工具支持自定义结果数量和特定国家/地区的搜索。

​
安装

要将此工具集成到您的项目中，请遵循下面的安装说明

pip install 'crewai[tools]'

​
入门步骤

为了有效使用 BraveSearchTool，请遵循以下步骤

  1. 软件包安装：确认您的 Python 环境中已安装 crewai[tools] 软件包。
  2. API 密钥获取：通过在 Brave Search API 注册来获取 Brave Search API 密钥。
  3. 环境配置：将您获取的 API 密钥存储在名为 BRAVE_API_KEY 的环境变量中，以便工具可以使用它。

​
示例

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

代码
from crewai_tools import BraveSearchTool

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

# Execute a search
results = tool.run(search_query="CrewAI agent framework")
print(results)

​
参数

BraveSearchTool 接受以下参数

  • search_query：必填。您用于搜索互联网的搜索查询。
  • country：可选。指定搜索结果的国家/地区。默认为空字符串。
  • n_results：可选。要返回的搜索结果数量。默认为 10。
  • save_file：可选。是否将搜索结果保存到文件。默认为 False。

​
带参数的示例

这是一个演示如何使用附加参数的工具示例

代码
from crewai_tools import BraveSearchTool

# Initialize the tool with custom parameters
tool = BraveSearchTool(
    country="US",
    n_results=5,
    save_file=True
)

# Execute a search
results = tool.run(search_query="Latest AI developments")
print(results)

​
智能体集成示例

以下是如何将 BraveSearchTool 与 CrewAI 智能体集成

代码
from crewai import Agent
from crewai.project import agent
from crewai_tools import BraveSearchTool

# Initialize the tool
brave_search_tool = BraveSearchTool()

# Define an agent with the BraveSearchTool
@agent
def researcher(self) -> Agent:
    return Agent(
        config=self.agents_config["researcher"],
        allow_delegation=False,
        tools=[brave_search_tool]
    )

​
结论

通过将 BraveSearchTool 集成到 Python 项目中，用户可以直接从其应用程序执行实时的相关互联网搜索。该工具为强大的 Brave Search API 提供了一个简单的接口，使以编程方式检索和处理搜索结果变得容易。遵循提供的设置和使用指南，将此工具集成到项目中变得简单直观。