跳转到主要内容

​
LinkupSearchTool

​
描述

LinkupSearchTool 提供了查询Linkup API以获取上下文信息并检索结构化结果的能力。该工具非常适合通过Linkup的最新可靠信息来丰富工作流程，允许代理在其任务期间访问相关数据。

​
安装

要使用此工具，您需要安装Linkup SDK 
uv add linkup-sdk

​
开始步骤

要有效使用LinkupSearchTool，请遵循以下步骤
  1. API密钥：获取Linkup API密钥。
  2. 环境设置：使用API密钥设置您的环境。
  3. 安装SDK：使用上述命令安装Linkup SDK。

​
示例

以下示例演示了如何初始化工具并在代理中使用它
代码
from crewai_tools import LinkupSearchTool
from crewai import Agent
import os

# Initialize the tool with your API key
linkup_tool = LinkupSearchTool(api_key=os.getenv("LINKUP_API_KEY"))

# Define an agent that uses the tool
@agent
def researcher(self) -> Agent:
    '''
    This agent uses the LinkupSearchTool to retrieve contextual information
    from the Linkup API.
    '''
    return Agent(
        config=self.agents_config["researcher"],
        tools=[linkup_tool]
    )

​
参数

LinkupSearchTool 接受以下参数

​
构造函数参数

  • api_key：必填。您的Linkup API密钥。

​
运行参数

  • query：必填。搜索词或短语。
  • depth：可选。搜索深度。默认为“standard”。
  • output_type：可选。输出类型。默认为“searchResults”。

​
高级用法

您可以自定义搜索参数以获得更具体的结果
代码
# Perform a search with custom parameters
results = linkup_tool.run(
    query="Women Nobel Prize Physics",
    depth="deep",
    output_type="searchResults"
)

​
返回格式

该工具以以下格式返回结果 
{
  "success": true,
  "results": [
    {
      "name": "Result Title",
      "url": "https://example.com/result",
      "content": "Content of the result..."
    },
    // Additional results...
  ]
}
如果发生错误，响应将是 
{
  "success": false,
  "error": "Error message"
}

​
错误处理

该工具能够优雅地处理API错误并提供结构化反馈。如果API请求失败，该工具将返回一个字典，其中包含success: false和错误消息。

​
结论

LinkupSearchTool 提供了一种无缝方式，将Linkup的上下文信息检索功能集成到您的CrewAI代理中。通过利用此工具，代理可以访问相关和最新的信息，以增强其决策和任务执行。