Add new tool examples

[aniketmaurya]

• Introduced multiple new example scripts demonstrating the usage of various tools (CalculatorTool, ExaSearchTool, FetchTool, GitTool, GitHubTool, GmailTool, LinkedInScraperTool, PostgreSQLTool, ScrapeGraphAI, ShellTool, SlackTool, TimezoneTool, WeatherTool, WebSearchTool) for end-to-end Agentor functionality.
• Each example includes environment setup instructions and showcases specific tool capabilities.

Greptile Overview

Greptile Summary

This PR adds a new examples/tools/ set of end-to-end scripts demonstrating how to instantiate individual tools, attach them to an Agentor instance, run a prompt, and print result.final_output. It also tweaks AGENTS.md to remove the Copilot-specific title.

These examples sit alongside the existing examples/ content and are intended as runnable reference snippets for tool integrations (web fetching/search, Git/GitHub, Gmail/Slack, PostgreSQL, ScrapeGraphAI, etc.), with brief environment-variable and extras-install guidance in examples/tools/README.md.

Confidence Score: 4/5

• Mostly safe to merge, but one example script is broken as written.
• Changes are limited to documentation/examples; the only definite must-fix is the ScrapeGraphAI example’s prompt not providing the required user_prompt argument for the smartscraper capability, which makes that end-to-end example fail at runtime.
• examples/tools/scrapegraphai.py

Important Files Changed

Filename	Overview
AGENTS.md	Simplified top-level title from Copilot-specific to generic "Agentor"; no functional impact.
examples/tools/README.md	Adds README listing tool example scripts and optional extras install/run instructions.
examples/tools/calculator.py	Adds CalculatorTool end-to-end example wiring Agentor -> tool -> run -> print final output.
examples/tools/exa_search.py	Adds ExaSearchTool example; validates EXA_API_KEY env var before running.
examples/tools/fetch.py	Adds FetchTool example demonstrating fetch_url usage and summarization prompt.
examples/tools/git.py	Adds GitTool example using GIT_REPO_PATH env var in a natural-language prompt.
examples/tools/github.py	Adds GitHubTool example; requires GITHUB_TOKEN and prompts to summarize issue #1.
examples/tools/gmail.py	Adds GmailTool example using GOOGLE_USER_CREDENTIALS path and a recent-messages query.
examples/tools/linkedin_scraper.py	Adds LinkedInScraperTool example requiring BRIGHT_DATA_API_KEY and scraping a profile URL.
examples/tools/postgresql.py	Adds PostgreSQLTool example requiring POSTGRES_DSN and listing public schema tables.
examples/tools/scrapegraphai.py	Adds ScrapeGraphAI example, but prompt likely omits required smartscraper user_prompt argument (runtime failure).
examples/tools/shell.py	Adds ShellTool example running pwd and ls via the agent.
examples/tools/slack.py	Adds SlackTool example requiring SLACK_BOT_TOKEN and listing channels.
examples/tools/timezone.py	Adds TimezoneTool example requesting current time in multiple timezones.
examples/tools/weather.py	Adds GetWeatherTool example requiring WEATHER_API_KEY and asking for London weather.
examples/tools/web_search.py	Adds WebSearchTool example requesting recent MCP updates.

Sequence Diagram

sequenceDiagram
  participant User
  participant Example as examples/tools/*.py
  participant Agent as Agentor
  participant Tool as Tool (e.g., FetchTool/GitHubTool/...)

  User->>Example: Run example script
  Example->>Agent: Instantiate Agentor(name, model, tools, instructions)
  Example->>Agent: agent.run(prompt)
  Agent->>Tool: Invoke tool capability based on prompt
  Tool-->>Agent: Return tool output
  Agent-->>Example: result.final_output
  Example-->>User: print(result.final_output)

  Note over Example,Tool: ScrapeGraphAI example currently omits required user_prompt arg for smartscraper

Loading

[greptile-apps]

_{16 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}