Linkup 搜索工具

LinkupSearchTool

描述

LinkupSearchTool 提供了查询 Linkup API 获取上下文信息并返回结构化结果的能力。该工具非常适合将最新且可靠的 Linkup 信息纳入工作流，让智能体在执行任务时访问相关数据。

安装

要使用该工具，你需要安装 Linkup SDK：

uv add linkup-sdk

入门步骤

要有效使用 LinkupSearchTool，请按以下步骤进行：

1. API Key：获取一个 Linkup API key。
2. 环境配置：使用该 API key 设置你的环境。
3. 安装 SDK：使用上面的命令安装 Linkup SDK。

示例

下面的示例演示如何初始化该工具并在智能体中使用它：

from crewai_tools import LinkupSearchTool
from crewai import Agent
import os

# 使用你的 API key 初始化工具
linkup_tool = LinkupSearchTool(api_key=os.getenv("LINKUP_API_KEY"))

# 定义一个使用该工具的智能体
@agent
def researcher(self) -> Agent:
    '''
    该智能体使用 LinkupSearchTool 从 Linkup API 检索上下文信息。
    '''
    return Agent(
        config=self.agents_config["researcher"],
        tools=[linkup_tool]
    )

参数

LinkupSearchTool 接受以下参数：

构造参数

• api_key：必需。你的 Linkup API key。

运行参数

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

高级用法

你可以通过自定义参数获得更具体的结果：

# 使用自定义参数执行搜索
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 智能体中提供了便捷方式。通过使用该工具，智能体可以访问相关且最新的信息，从而增强决策和任务执行能力。