Skip to content

Comments

Voice agents: integrations-first overview + Voice SDK page (hide Flow)#209

Open
ArchieMcM234 wants to merge 1 commit intomainfrom
deprecate-flow-integrations
Open

Voice agents: integrations-first overview + Voice SDK page (hide Flow)#209
ArchieMcM234 wants to merge 1 commit intomainfrom
deprecate-flow-integrations

Conversation

@ArchieMcM234
Copy link
Contributor

Summary

This PR refactors the Voice agents docs to make it easier for users to get started via integration partners, while keeping the Voice SDK documentation available in a dedicated page.

What changed

  • Hid “Flow” from the Voice agents sidebar (content remains in the repo; it’s just no longer shown in navigation).
  • Updated the Voice agents overview to be integrations-first, including cards linking to:
    • Vapi
    • LiveKit
    • Pipecat
  • Created a dedicated Voice SDK page by renaming the former Features page to voice-sdk, and expanding it with:
    • Getting started + quickstart
    • Presets overview
    • Custom config examples
    • Full configuration reference

Navigation / IA

Voice agents sidebar is now:

  • Overview
  • Voice SDK

Notes / follow-ups

  • This keeps the SDK docs in-repo for now; we may want to replace parts of the Voice SDK page with a link to the SDK GitHub README in future.
  • I intend to revisit the Voice SDK page next to make it more comprehensive in the mean time (expand coverage, improve structure, and fill remaining gaps).
  • Flow content is intentionally retained but not exposed in navigation.

Testing

  • Verified docs compile locally after updating sidebar doc IDs and internal links.

Files changed

  • docs/docs/voice-agents/overview.mdx
  • docs/docs/voice-agents/sidebar.ts
  • docs/docs/voice-agents/features.mdx -> docs/docs/voice-agents/voice-sdk.mdx
  • docs/sidebars.ts

@vercel
Copy link

vercel bot commented Feb 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 20, 2026 4:52pm

Request Review

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Refactors the Voice agents documentation to emphasize partner integrations as the fastest onboarding path, while preserving and expanding Voice SDK documentation on a dedicated page.

Changes:

  • Reworked the Voice agents overview to be integrations-first and added integration cards (Vapi/LiveKit/Pipecat).
  • Renamed/expanded the former “Features” doc into a dedicated Voice SDK page and updated the Voice agents sidebar accordingly.
  • Adjusted global sidebar ordering to place Voice agents after Text to speech.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
sidebars.ts Reorders the top-level sidebar list to move “Voice agents” below “Text to speech”.
docs/voice-agents/overview.mdx Replaces the overview content with an integrations-first entry point and links to the Voice SDK page.
docs/voice-agents/sidebar.ts Updates the Voice agents sidebar to show only Overview + Voice SDK (hides Flow).
docs/voice-agents/voice-sdk.mdx Introduces a richer Voice SDK landing page (getting started, quickstart, presets, and config guidance).
Comments suppressed due to low confidence (3)

docs/voice-agents/voice-sdk.mdx:10

  • pythonVoiceConfigSerialization is imported but never used in this MDX file. Removing the unused raw import will avoid unnecessary bundling and keeps the page easier to maintain.
    docs/voice-agents/voice-sdk.mdx:101
  • The code sample comment says "interruptable"; the correct spelling is "interruptible".
    docs/voice-agents/voice-sdk.mdx:137
  • The snippet for listing presets references VoiceAgentConfigPreset.list_presets() without showing where VoiceAgentConfigPreset comes from. Consider adding the relevant import (or fully qualifying it) so the example is copy/paste runnable.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant