OpenAI Agents SDK + SerpKite

from serpkite import SerpKite, SerpKiteError

sk = SerpKite()  # reads SERPKITE_API_KEY


def serpkite_search(query: str, country: str = "us", num: int = 10) -> str:
    """Google search via SerpKite. Returns the results page as compact Markdown."""
    try:
        # format="markdown" returns a str: results, People Also Ask, related searches
        return sk.search(query, country=country, num=num, format="markdown")
    except SerpKiteError as e:
        return f"Search failed: {e.message}"


from agents import Agent, Runner, function_tool


@function_tool
def google_search(query: str, country: str = "us") -> str:
    """Search Google for current information. Returns the top results with links, People Also Ask and related searches as Markdown. Use for recent events, facts and anything after your training cutoff.

    Args:
        query: What to search for.
        country: Two-letter country code, e.g. us, gb, de.
    """
    return serpkite_search(query, country)


agent = Agent(
    name="Researcher",
    instructions="Search the web before answering. Cite the URLs you used.",
    tools=[google_search],
)

result = Runner.run_sync(agent, "What's new in the latest Postgres release?")
print(result.final_output)