Apify

本指南演示了如何在 Agno 框架中集成和使用 Apify Actor，以增强 AI Agent 的网络抓取、爬取、数据提取和网络自动化功能。

什么是 Apify？

Apify 是一个提供以下服务的平台：

• 为 AI Agent 提供数据收集服务，专注于从社交媒体、搜索引擎、在线地图、电子商务网站、旅游门户或常规网站提取数据
• 一个包含各种数据任务的现成 Actor（专用工具）的市场
• 运行和变现我们自己 AI Agent 的基础设施

前提条件

1. 注册一个 Apify 账户
2. 获取您的 Apify API 令牌（可从 Apify 获取）
3. 安装所需包：

pip install agno apify-client

基本用法

Agno 框架让集成 Apify Actor 到您的 Agent 中变得十分简单。以下是一个简单的示例：

from agno.agent import Agent
from agno.tools.apify import ApifyTools

# 创建一个包含 ApifyTools 的 Agent
agent = Agent(
    tools=[
        ApifyTools(
            actors=["apify/rag-web-browser"],  # 指定要使用的 Apify Actor，如果需要，可使用多个
            apify_api_token="your_apify_api_key"  # 或者设置 APIFY_API_TOKEN 环境变量
        )
    ],
    show_tool_calls=True,
    markdown=True
)

# 使用 Agent 获取网站内容
agent.print_response("What information can you find on https://docs.agno.com/introduction ?", markdown=True)

可用的 Apify 工具

您可以轻松地将任何 Apify Actor 集成作为工具。以下是一些示例：

1. RAG Web Browser

RAG Web Browser Actor 专为 AI 和 LLM 应用而设计。它会搜索查询的网页或处理 URL，然后清理和格式化内容供您的 Agent 使用。此工具默认启用。

from agno.agent import Agent
from agno.tools.apify import ApifyTools

agent = Agent(
    tools=[
        ApifyTools(actors=["apify/rag-web-browser"])
    ],
    show_tool_calls=True,
    markdown=True
)

# 搜索信息并处理结果
agent.print_response("What are the latest developments in large language models?", markdown=True)

2. Website Content Crawler

此工具使用 Apify 的 Website Content Crawler Actor 来提取网站的文本内容，非常适合 RAG 应用。

from agno.agent import Agent
from agno.tools.apify import ApifyTools

agent = Agent(
    tools=[
        ApifyTools(actors=["apify/website-content-crawler"])
    ],
    markdown=True
)

# 让 Agent 处理网页内容
agent.print_response("Summarize the content from https://docs.agno.com/introduction", markdown=True)

3. Google Places Crawler

Google Places Crawler 从 Google Maps 和 Google Places 提取有关企业的数据。

from agno.agent import Agent
from agno.tools.apify import ApifyTools

agent = Agent(
    tools=[
        ApifyTools(actors=["compass/crawler-google-places"])
    ],
    show_tool_calls=True
)

# 查找特定位置的企业信息
agent.print_response("What are the top-rated restaurants in San Francisco?", markdown=True)
agent.print_response("Find coffee shops in Prague", markdown=True)

示例场景

RAG Web Browser + Google Places Crawler

此示例结合了网络搜索和本地企业数据，以提供关于主题的全面信息：

from agno.agent import Agent
from agno.tools.apify import ApifyTools

agent = Agent(
    tools=[
        ApifyTools(actors=[
            "apify/rag-web-browser",
            "compass/crawler-google-places"
        ])
    ],
    show_tool_calls=True
)

# 获取一般信息和本地商家信息
agent.print_response(
    """
    我下个月要去东京旅行。
    1. 研究最佳旅行时间和主要景点
    2. 在新宿附近找一家评价好的寿司餐厅
    根据这些信息整理一份全面的旅行指南。
    """,
    markdown=True
)

Toolkit 参数

参数	类型	默认值	描述
apify_api_token	str	None	Apify API 令牌（或通过 APIFY_API_TOKEN 环境变量设置）
actors	str 或 List[str]	None	单个 Actor ID 或要注册的 Actor ID 列表

开发者资源

• 查看 Tools
• 查看 Cookbook

资源

• Apify Actor 文档
• Apify Store - 浏览可用 Actor
• 如何在 Apify 上构建和变现 AI Agent