Skip to main content

Agno Integration

Integrate Apify with Agno to power AI agents with web scraping, automation, and data insights.

What is Agno?​

Agno is an open-source framework for building intelligent AI agents. It provides a flexible architecture to create agents with custom tools, enabling seamless integration with external services like Apify for tasks such as web scraping, data extraction and automation.

Agno documentation

Check out the Agno documentation for more details on building AI agents.

How to use Apify with Agno​

This guide shows how to integrate Apify Actors with Agno to empower your AI agents with real-time web data. We'll use the RAG Web Browser Actor to fetch web content and the Google Places Crawler Actor to extract location-based data. It is very easy to use with any other Actor by just passing the name of the Actor. See and choose from thousands of Actors in the Apify Store.

Prerequisites​

Alternative LLM providers

While our examples use OpenAI, Agno supports other LLM providers as well. You'll need to adjust the environment variables and configuration according to your chosen provider. Check out the Agno models documentation for details on supported providers and configuration.

  • Python environment: Ensure Python is installed (version 3.8+ recommended).
  • Required packages: Install the following dependencies in your terminal:
pip install agno apify-client

Basic integration example​

Start by setting up an Agno agent with Apify tools. This example uses the RAG Web Browser Actor to extract content from a specific URL.

import os

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

os.environ["APIFY_API_TOKEN"] = "YOUR_APIFY_API_TOKEN"  # Replace with your Apify API token
os.environ["OPENAI_API_KEY"] = "YOUR_OPENAI_API_KEY"  # Replace with your OpenAI API key

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

# Fetch and display web content
agent.print_response("Extract key details from https://docs.agno.com/introduction", markdown=True)

Running this code will scrape the specified URL and return formatted content your agent can use.

Advanced scenario: Travel planning agent​

Combine multiple Apify Actors to create a powerful travel planning agent. This example uses the RAG Web Browser and Google Places Crawler to gather travel insights and local business data.

import os

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

os.environ["APIFY_API_TOKEN"] = "YOUR_APIFY_API_TOKEN"  # Replace with your Apify API token
os.environ["OPENAI_API_KEY"] = "YOUR_OPENAI_API_KEY"  # Replace with your OpenAI API key

# Create a travel planning agent
agent = Agent(
    name="Travel Planner",
    instructions=[
        "You are a travel planning assistant. Use web data and location insights to provide detailed travel recommendations."
    ],
    tools=[
        ApifyTools(
            actors=[
                "apify/rag-web-browser",           # For general web research
                "compass/crawler-google-places"    # For location-based data
            ]
        )
    ],
    show_tool_calls=True,
    markdown=True
)

# Plan a trip to Tokyo
agent.print_response(
    """
    I'm traveling to Tokyo next month.
    1. Research the best time to visit and top attractions.
    2. Find a highly rated sushi restaurant near Shinjuku.
    Compile a travel guide with this information.
    """,
    markdown=True
)

This agent will fetch travel-related data and restaurant recommendations, providing a comprehensive travel guide:

  1. Use the RAG Web Browser to research Tokyo travel details.
  2. Use the Google Places Crawler to find a top sushi restaurant.
  3. Combine the results into a comprehensive guide.
Apify Store

Browse the Apify Store to find additional Actors for tasks like social media scraping, e-commerce data extraction, or news aggregation.

Available Apify tools​

Agno supports any Apify Actor via the ApifyTools class. You can specify a single Actor ID or a list of Actor IDs to register multiple tools for your agent at once.

Configuration options​

apify_api_token (string, default: None) : Apify API token (or set via APIFY_API_TOKEN environment variable)

actors (string or List[string], default: None) : Single Actor ID or list of Actor IDs to register

Resources​