Skip to content

docs: add Serply search toolkit - #766

Open
googio wants to merge 1 commit into
agno-agi:mainfrom
googio:docs/add-serply-search-toolkit
Open

googio wants to merge 1 commit into
agno-agi:mainfrom
googio:docs/add-serply-search-toolkit

Conversation

@googio

@googio googio commented Sep 14, 2026

Copy link
Copy Markdown

Description

This is the companion docs PR @kausmeows asked for when the SDK toolkit merged:

thanks for adding this!

@googio would you also be open to add corresponding docs pr here- https://github.com/agno-agi/docs ?

(agno-agi/agno#9780, 2026-08-26)

SerplyTools shipped in that PR and examples/tools/serply-tools.mdx already exists here, but the toolkit reference page was never added. Serply is currently the only entry in the Tools > Search group without one; the other 22 all have a tools/toolkits/search/<name>.mdx.

Changes:

  • tools/toolkits/search/serply.mdx (new). Structured like its nearest sibling serper.mdx: Prerequisites, Example, Toolkit Params, Toolkit Functions, Developer Resources.
  • docs.json (one line). Added to the Tools > Search group, alphabetically between serper and sofya.

The param and function tables are read off libs/agno/agno/tools/serply.py at the agno SHA this repo's CI pins (9dd8f80), not written from memory. One behaviour is worth calling out because it differs from the neighbouring pages: search_news and search_scholar default to False on SerplyTools, where SerperTools defaults everything on. The page shows the flag that turns them on instead of implying all three tools are live out of the box.

No redirect entry was added. The integrations/toolkits/search/* redirects are legacy path migrations, and the newest toolkits (seltz, scavio, sofya) have none. Serply never existed at the old path.

Type of Change

  • Bug fix (errors, broken links, outdated info)
  • New content
  • Content improvement
  • Other: ____

Related Issues/PRs (if applicable)

Checklist

  • Content is accurate and up-to-date
  • All links tested and working
  • Code examples verified (if applicable)
  • Deterministic scripts pass for the affected examples, imports, installs, and references
  • OpenAPI JSON and YAML were updated together and scripts/make_openapi.py --check passes (if applicable)
  • mint broken-links -t false and mint validate -t false pass
  • Spelling and grammar checked
  • Screenshots updated (if applicable)

What was run

Check Result
mint validate -t false build validation passed
mint broken-links -t false no broken links found
python3 scripts/check_install_coverage.py --json --limit 0 exit 0, offender_pages 0, missing_requirements_total 0
python3 scripts/check_imports.py exit 0, 584 statements, 449 OK, 135 dependency-only, 0 real failures
python3 scripts/reference_drift.py exit 0 (the UNPARSEABLE lines it reports are pre-existing and in unrelated files)

check_imports.py resolving from agno.tools.serply import SerplyTools is the one that matters here, and it does: both libs/agno/agno/tools/serply.py and cookbook/91_tools/serply_tools.py exist at the pinned SHA.

Two boxes left unticked on purpose rather than guessed at:

  • OpenAPI. No route or schema changed, so scripts/make_openapi.py --check has nothing to say about this diff.
  • scripts/examples_sync/*. I did not run the sync chain. It regenerates examples/** and merge_nav.py operates only on the Examples tab of docs.json; this PR adds a page under tools/toolkits/search/ and touches the Tools tab, so the chain has no input from it and the git diff --exit-code that follows it should stay clean. Flagging it so a maintainer can confirm rather than take my word for it.

Disclosure

I work on Serply. The page documents the toolkit as it is implemented in agno today and adds no vendor claims. The Developer Resources link to serply.io/docs mirrors what valyu.mdx and parallel.mdx already do for their own APIs. Happy to drop it if you would rather the page stayed link-free.

Adds tools/toolkits/search/serply.mdx and its docs.json nav entry. Params
and functions are read off libs/agno/agno/tools/serply.py at the agno SHA
this repo's CI pins. Companion to agno-agi/agno#9780.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant