Skip to content

Tavily integration example#197

Open
lakshyaag-tavily wants to merge 4 commits intocartesia-ai:mainfrom
lakshyaag-tavily:feat/tavily-sdk-example
Open

Tavily integration example#197
lakshyaag-tavily wants to merge 4 commits intocartesia-ai:mainfrom
lakshyaag-tavily:feat/tavily-sdk-example

Conversation

@lakshyaag-tavily
Copy link
Copy Markdown

@lakshyaag-tavily lakshyaag-tavily commented Apr 7, 2026

What does this PR do?

Adds a new example integration under example_integrations/tavily/ that demonstrates a voice agent capable of real-time web research using the Tavily API.

The agent exposes two @loopback_tools:

  • web_search — Calls Tavily's async search API (fast depth, 5 results) for low-latency, voice-friendly web lookups with configurable time-range filtering.
  • web_extract — Extracts full page content from a URL via Tavily's extract API, useful when search snippets aren't sufficient to answer a question.

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation
  • Other: ___________

Testing

How did you test this?

Checklist

  • I have read the contributing guidelines
  • I have added tests that prove my fix is effective or that my feature works
  • I have formatted my code with make format

Note

Low Risk
Adds a new, self-contained example integration and dependencies; no changes to core runtime or security-sensitive logic. Main risk is dependency/version compatibility for the new example.

Overview
Adds a new example_integrations/tavily/ example that demonstrates a voice agent performing real-time web research via Tavily.

The example includes two new @loopback_tools (web_search with optional time_range and web_extract with 3k-char truncation), wires them into an LlmAgent/VoiceAgentApp with a voice-optimized system prompt, and documents setup/run instructions. It also introduces a dedicated pyproject.toml with the required Tavily/Line SDK dependencies and a tavily-search script entry point.

Reviewed by Cursor Bugbot for commit 2e87093. Bugbot is set up for automated code reviews on this repo. Configure here.

- Introduced main.py for handling voice interactions and web searches using Tavily API.
- Added web_search and web_extract tools for real-time information retrieval and content extraction.
- Created README.md for setup instructions and usage details.
- Added pyproject.toml for project metadata and dependencies.
- Included cartesia.toml for configuration settings.
@lakshyaag-tavily lakshyaag-tavily marked this pull request as ready for review April 7, 2026 16:19
Comment thread example_integrations/tavily/main.py Outdated
Comment thread example_integrations/tavily/main.py Outdated
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 2e87093. Configure here.

Comment thread example_integrations/tavily/main.py
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