Add voice agent routing callout to streaming quickstart#782
Open
agalyanmann wants to merge 1 commit intomainfrom
Open
Add voice agent routing callout to streaming quickstart#782agalyanmann wants to merge 1 commit intomainfrom
agalyanmann wants to merge 1 commit intomainfrom
Conversation
Evaluators building voice agents follow the streaming quickstart, use generic defaults, and get suboptimal results. This adds a prominent tip after the Overview section directing them to the Voice Agent Best Practices guide for optimized model selection, prompting, and turn detection configuration. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
agalyanmann
pushed a commit
that referenced
this pull request
Mar 18, 2026
Route healthcare/medical scribe builders to the Medical Scribe Best Practices guide from the three pages they are most likely to land on: the async getting-started quickstart, the models overview (Universal-3 Pro section), and the pre-recorded evals guide. Also adds a section on domain-specific evaluation beyond WER, since medical scribe customers often evaluate based on user preference rate and readability rather than word error rate alone. Follows the same <Tip> callout pattern used for voice agent routing in PRs #782 and #783. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
<Tip>callout after the Overview section in the streaming quickstart (transcribe-streaming-audio.mdx) directing voice agent builders to the Voice Agent Best Practices guide.Evidence
Multiple evaluators (voice agent companies) followed the streaming quickstart with generic defaults and abandoned testing after poor out-of-box results. The voice-agent-best-practices page exists and is comprehensive but is not discoverable from the getting-started flow.
Test plan
<Tip>renders correctly on the docs site/docs/voice-agent-best-practicesresolves🤖 Generated with Claude Code