Skip to content

Update AssemblyAI skill: universal-3-5-pro across the board (streaming + async), Speech Understanding summarization/action items, Voice Agent BYO LLM + webhooks#17

Open
dlange-aai wants to merge 2 commits into
mainfrom
update-assemblyai-skill-2026-07-06
Open

Update AssemblyAI skill: universal-3-5-pro across the board (streaming + async), Speech Understanding summarization/action items, Voice Agent BYO LLM + webhooks#17
dlange-aai wants to merge 2 commits into
mainfrom
update-assemblyai-skill-2026-07-06

Conversation

@dlange-aai

@dlange-aai dlange-aai commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Automated docs-sync run (2026-07-06), plus a follow-up repositioning. Compared the current skill against the AssemblyAI docs/spec and applied targeted updates.

universal-3-5-pro is now the model to use across the board

It is GA for both realtime/streaming and pre-recorded/async, and is the default on each. The spec updates confirm this:

  • Async speech_models now defaults to ["universal-3-5-pro", "universal-2"] and the enum accepts only those two — universal-3-pro was removed from the pre-recorded model list/enum (superseded), mirroring the u3-rt-pro removal on streaming.
  • Reframed the Models section to lead with universal-3-5-pro everywhere; dropped the Universal-3 Pro row and the stale "opt-in / enum still lists universal-3-pro" async caveat.
  • Retargeted the U3-Pro-family async params (temperature, remove_audio_tags, language_codes), Medical Mode, and Translation to Universal-3.5 Pro; updated the Python SDK speech_models example; noted the speech_model_used response field.

Streaming (references/streaming.md, SKILL.md)

  • u3-rt-pro removed from the streaming model picker and speech_model spec enum (docs PR #177). Enum now lists only universal-3-5-pro, universal-streaming-english, universal-streaming-multilingual. Reframed as legacy and updated every "universal-3-5-pro / u3-rt-pro" annotation.
  • language_codes (plural, list) is the real language-steering connection param (docs PR #170); removed the inaccurate singular language_code input param.
  • Opus input (docs PR #182): encoding now accepts opus and ogg_opus (sample_rate ignored for Opus).
  • Corrected defaults: prompt/agent_context ≤1750 chars; previous_context_n_turns default 5 (0–100); vad_threshold 0.2/0.5; interruption_delay mode-dependent + fixed 256ms; max_speakers hard cap (docs PR #180).

Speech Understanding (references/speech-understanding.md, SKILL.md)

  • Added native Summarization (summary_type + effort) and Action Items (include_decisions + effort) under speech_understanding.request.<feature> (docs PRs #171, #176).
  • Clarified that top-level summarization/auto_chapters stay deprecated; these are the modern replacements (or the LLM Gateway).

Voice Agents (references/voice-agents.md, references/api-reference.md, SKILL.md)

  • Bring your own LLM (docs PR #172): llm field on stored agents (OpenAI-compatible; base_url/model/api_key; one entry; streamed; [] reverts to managed; can target the LLM Gateway).
  • Voice Agent Webhooks API: new /v1/webhook-subscriptions endpoints.
  • HTTP tool headers shape change (docs PR #151): list of {name, value} (write) / {name, last_set_at} (read), not a dict; values never returned. Fixed the stale "***" masking claim.
  • Input languages corrected to the 18 Universal-3.5 Pro Streaming languages (docs PR #168) — was 6.

Only information clearly documented in the spec was changed; existing structure and style preserved. The untracked local evals/ dir is out of scope.

…arization/action items, streaming language_codes/Opus, Voice Agent BYO LLM + webhooks

Sync the skill with AssemblyAI docs/spec changes since the last update:

Streaming:
- u3-rt-pro (Universal-3 Pro Streaming) removed from the model picker and
  the streaming spec speech_model enum (July 2026); reframed as legacy and
  superseded by universal-3-5-pro. Enum now: universal-3-5-pro,
  universal-streaming-english, universal-streaming-multilingual.
- Replace the (nonexistent) singular language_code input param with the
  actual language_codes (plural, list) steering param.
- Add opus / ogg_opus encodings (sample_rate ignored for Opus).
- Correct defaults: prompt/agent_context <=1750 chars,
  previous_context_n_turns default 5 (range 0-100), vad_threshold 0.2/0.5,
  interruption_delay mode-dependent + fixed 256ms; max_speakers hard cap.

Speech Understanding:
- Add native summarization (summary_type + effort) and action_items
  (include_decisions + effort) features under speech_understanding.request.
- Clarify that top-level summarization/auto_chapters stay deprecated; these
  are the modern replacements (or the LLM Gateway).

Voice Agents:
- Add Bring-your-own-LLM (llm field on stored agents; OpenAI-compatible).
- Add Voice Agent Webhooks API (/v1/webhook-subscriptions).
- HTTP tool headers are now a list of {name,value} (not a dict); reads
  return name + last_set_at only (not masked "***").
- Correct input languages to the 18 Universal-3.5 Pro Streaming languages.
…ing + async)

universal-3-5-pro is now GA for both realtime/streaming and pre-recorded/async
transcription and is the default on each. The async speech_models enum and
default were updated in the spec to ["universal-3-5-pro", "universal-2"], and
universal-3-pro was removed from the pre-recorded model list/enum (superseded).

- SKILL.md: lead the Models section with "universal-3-5-pro across the board";
  drop the Universal-3 Pro row and the stale "opt-in / enum still lists
  universal-3-pro" async caveat; async speech_models now defaults to
  ["universal-3-5-pro", "universal-2"]; note the speech_model_used response field.
- api-reference.md: speech_models default/enum updated; temperature,
  remove_audio_tags, language_codes, and Medical Mode retargeted to
  Universal-3.5 Pro; warning example uses universal-3-5-pro.
- speech-understanding.md: Translation models now Universal-3.5 Pro + Universal-2.
- audio-intelligence.md: Medical Mode pre-recorded model is Universal-3.5 Pro.
- python-sdk.md: speech_models fallback example uses universal-3-5-pro.
@dlange-aai dlange-aai changed the title Update AssemblyAI skill: u3-rt-pro removal, Speech Understanding summarization/action items, streaming language_codes/Opus, Voice Agent BYO LLM + webhooks Update AssemblyAI skill: universal-3-5-pro across the board (streaming + async), Speech Understanding summarization/action items, Voice Agent BYO LLM + webhooks Jul 6, 2026
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