Skip to content

docs: update for pipecat PR #4533#856

Open
markbackman wants to merge 1 commit into
mainfrom
docs/pr-4533
Open

docs: update for pipecat PR #4533#856
markbackman wants to merge 1 commit into
mainfrom
docs/pr-4533

Conversation

@markbackman
Copy link
Copy Markdown
Contributor

Automated documentation update for pipecat PR #4533.

Changes

Updated all realtime (speech-to-speech) service documentation pages to clarify user turn frame behavior:

Services updated

  • OpenAI Realtime (api-reference/server/services/s2s/openai.mdx)

    • Added note that it emits UserStartedSpeakingFrame / UserStoppedSpeakingFrame from server-side VAD
    • Instructions about using with realtime_service_mode=True
    • Warning about not using local VAD without disabling server-side turn detection
    • References to example files
  • Gemini Live (api-reference/server/services/s2s/gemini-live.mdx)

    • Added note that it does NOT emit user turn frames
    • Instructions about using with realtime_service_mode=True
    • Reference to locally-driven-turns example
  • Ultravox (api-reference/server/services/s2s/ultravox.mdx)

    • Added note that it does NOT emit user turn frames
    • Instructions about using with realtime_service_mode=True
    • Instructions about local VAD configuration
  • Grok Realtime (api-reference/server/services/s2s/grok.mdx)

    • Added note that it emits user turn frames from server-side VAD
    • Instructions about using with realtime_service_mode=True
    • Instructions about disabling server-side VAD when using local VAD
  • Inworld Realtime (api-reference/server/services/s2s/inworld.mdx)

    • Added note that it emits user turn frames from server-side VAD
    • Instructions about using with realtime_service_mode=True
    • Reference to locally-driven-turns example
  • AWS Nova Sonic (api-reference/server/services/s2s/aws.mdx)

    • Added note that it does NOT emit user turn frames
    • Instructions about using with realtime_service_mode=True
    • Instructions about local VAD configuration

Summary

All changes are additions to the Notes sections of each service page. The updates help users understand:

  1. Whether they need to set up local turn detection
  2. How to properly configure LLMContextAggregatorPair for realtime services
  3. Which example files demonstrate the correct patterns

Gaps identified

None - all relevant service documentation pages have been updated.

Updated documentation for all realtime (s2s) services to clarify:
- Whether each service emits UserStartedSpeakingFrame/UserStoppedSpeakingFrame
- How to use with LLMContextAggregatorPair(..., realtime_service_mode=True)
- How to handle local VAD configuration when needed
- References to relevant example files

Services that emit turn frames:
- OpenAI Realtime
- Grok Realtime
- Inworld Realtime

Services that do NOT emit turn frames:
- Gemini Live
- Ultravox
- AWS Nova Sonic

Corresponds to pipecat PR #4533
@markbackman markbackman added auto-docs Automated documentation update from pipecat source changes pipecat labels May 29, 2026
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 29, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
daily 🟢 Ready View Preview May 29, 2026, 5:13 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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

Labels

auto-docs Automated documentation update from pipecat source changes pipecat

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant