Add better Apify integration with examples (agno-agi#2566)

## Description

- **Summary of changes**: This PR refactors the ApifyTools class
replacing the previous custom implementation.
    - Implemented dynamic registration of any Apify Actor as a function
- Added support for multiple actors through a single ApifyTools instance
    - Added comprehensive error handling and logging
- Improved documentation with examples and configuration instructions
- **Related issues**: This update is connected with
[PR#183](agno-agi/agno-docs#183) in docs repo.
- **Motivation and context**: The previous implementation only supported
two hardcoded Apify actors (website-content-crawler and web-scraper).
The new implementation allows users to utilize any of the 4000+ actors
from the Apify ecosystem without modifying the core code. This
significantly expands the tool's capabilities for web data extraction
tasks.
- **Environment or dependencies**:
    -  langchain-apify: Required for ApifyActorsTool integration
    - apify-client: Required for direct API interactions
- Now requires an APIFY_API_TOKEN environment variable or explicit API
token parameter
- **Impact on metrics**: 
    - Increased flexibility with support for any Apify Actor
    - Improved documentation and error handling
- Reduced code maintenance burden by leveraging LangChain's Actor
interface
- Better user experience through expanded examples in the demo script

Fixes # (issue)

---

## Type of change

Please check the options that are relevant:

- [x] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Model update (Addition or modification of models)
- [x] Other (please describe): Add better examples and start better
integration with Apify. This update is connected with PR#183 in docs
repo.

---

## Checklist

- [x] Adherence to standards: Code complies with Agno’s style guidelines
and best practices.
- [x] Formatting and validation: You have run `./scripts/format.sh` and
`./scripts/validate.sh` to ensure code is formatted and linted.
- [x] Self-review completed: A thorough review has been performed by the
contributor(s).
- [x] Documentation: Docstrings and comments have been added or updated
for any complex logic.
- [x] Examples and guides: Relevant cookbook examples have been included
or updated (if applicable).
- [x] Tested in a clean environment: Changes have been tested in a clean
environment to confirm expected behavior.
- [ ] Tests (optional): Tests have been added or updated to cover any
new or changed functionality.

---

## Additional Notes

Include any deployment notes, performance implications, security
considerations, or other relevant information (e.g., screenshots or logs
if applicable).

---------

Co-authored-by: Jakub Kopecký <[email protected]>
Co-authored-by: Jiří Spilka <[email protected]>
Co-authored-by: Priti <[email protected]>
Co-authored-by: Dirk Brand <[email protected]>
Co-authored-by: Ondřej Hlava <[email protected]>

Author: 6 people

cookbook/tools/apify_tools.py

@@ -1,5 +1,82 @@
 from agno.agent import Agent
 from agno.tools.apify import ApifyTools
 
-agent = Agent(tools=[ApifyTools()], show_tool_calls=True)
-agent.print_response("Tell me about https://docs.agno.com/introduction", markdown=True)
+# Apify Tools Demonstration Script
+"""
+This script showcases the power of web scraping and data extraction using Apify's Actors (serverless tools). 
+The Apify ecosystem has 4000+ pre-built Actors for almost any web data extraction need!
+
+---
+Configuration Instructions:
+1. Install required dependencies:
+   pip install agno langchain-apify apify-client
+
+2. Set the APIFY_API_TOKEN environment variable:
+   Add a .env file with APIFY_API_TOKEN=your_apify_api_key
+---
+
+Tip: Check out the Apify Store (https://apify.com/store) to find tools for almost any web scraping or data extraction task.
+"""
+
+# Create an Apify Tools agent with versatile capabilities
+agent = Agent(
+    name="Web Insights Explorer",
+    instructions=[
+        "You are a sophisticated web research assistant capable of extracting insights from various online sources. "
+        "Use the available tools for your tasks to gather accurate, well-structured information."
+    ],
+    tools=[
+        ApifyTools(
+            actors=[
+                "apify/rag-web-browser",
+                "compass/crawler-google-places",
+                "clockworks/free-tiktok-scraper",
+            ]
+        )
+    ],
+    show_tool_calls=True,
+    markdown=True,
+)
+
+
+def demonstrate_tools():
+    print("Apify Tools Exploration 🔍")
+
+    # RAG Web Search Demonstrations
+    print("\n1.1 🕵️ RAG Web Search Scenarios:")
+    prompt = "Research the latest AI ethics guidelines from top tech companies. Compile a summary from at least 3 different sources comparing their approaches using RAG Web Browser."
+    agent.print_response(prompt, show_full_reasoning=True)
+
+    print("\n1.2 🕵️ RAG Web Search Scenarios:")
+    prompt = "Carefully extract the key introduction details from https://docs.agno.com/introduction"  #  Extract content from specific website
+    agent.print_response(prompt)
+
+    # Google Places Demonstration
+    print("\n2. Google Places Crawler:")
+    prompt = "Find the top 5 highest-rated coffee shops in San Francisco with detailed information about each location"
+    agent.print_response(prompt)
+
+    # Tiktok Scraper Demonstration
+    print("\n3. Tiktok Profile Analysis:")
+    prompt = "Analyze two profiles on Tiktok that lately added #AI (hashtag AI), extracting their statistics and recent content trends"
+    agent.print_response(prompt)
+
+
+if __name__ == "__main__":
+    demonstrate_tools()
+
+"""
+Want to add a new tool? It's easy!
+- Browse Apify Store
+- Find an Actor that matches your needs
+- Add a new method to ApifyTools following the existing pattern
+- Register the method in the __init__
+
+Examples of potential tools:
+- YouTube video info scraper
+- Twitter/X profile analyzer
+- Product price trackers
+- Job board crawlers
+- News article extractors
+- And SO MUCH MORE!
+"""