CrewAI review

# tools.py holds the shared web_search and read_page functions over Geekflare's APIs,
# common.py the model name, OpenRouter key, system prompt and task.
from crewai import LLM, Agent, Crew, Task
from crewai.tools import tool

import tools
from common import KEY, MODEL, SYSTEM


@tool("web_search")
def web_search(query: str) -> str:
    """Search the web. Returns the top 5 results as 'title | url | snippet' lines."""
    return tools.web_search(query)


@tool("read_page")
def read_page(url: str) -> str:
    """Read a web page as Markdown, cut to 6,000 characters."""
    return tools.read_page(url)


llm = LLM(model=f"openrouter/{MODEL}", api_key=KEY, temperature=0, max_tokens=1024)
researcher = Agent(role="Researcher", goal="Answer the question with cited facts", backstory=SYSTEM,
                   tools=[web_search, read_page], llm=llm, max_iter=8, verbose=False)


def run(task: str) -> str:
    t = Task(description=task, expected_output="A short cited answer", agent=researcher)
    return str(Crew(agents=[researcher], tasks=[t], verbose=False).kickoff())