Skip to content

Update AssemblyAI skill: drop gemini-3-flash-preview, spoken-digit tool pattern trap, granular location PII policies#18

Open
dlange-aai wants to merge 1 commit into
update-assemblyai-skill-2026-07-06from
update-assemblyai-skill-2026-07-10
Open

Update AssemblyAI skill: drop gemini-3-flash-preview, spoken-digit tool pattern trap, granular location PII policies#18
dlange-aai wants to merge 1 commit into
update-assemblyai-skill-2026-07-06from
update-assemblyai-skill-2026-07-10

Conversation

@dlange-aai

Copy link
Copy Markdown
Collaborator

Summary

Incremental docs-sync update against the latest assemblyai-docs spec, covering changes landed after the 2026-07-06 run (PR #17).

Stacked on #17. This PR's base is update-assemblyai-skill-2026-07-06 (PR #17, still open), which heavily edits all three of these files. Basing on that branch keeps this diff limited to the genuinely new changes and avoids merge conflicts. If #17 merges first, retarget this PR to main — the changes apply cleanly.

Changes

  • LLM Gateway (references/llm-gateway.md): remove the retired gemini-3-flash-preview model row. It was removed from the available-models list in the spec (assemblyai-docs #198, 2026-07-07). The rest of the model list already matches the current spec.
  • Voice Agents (references/voice-agents.md + a SKILL.md Key Gotcha): document tool parameter pattern/examples hints for spoken digit sequences. The agent's cleanup of spoken input is best-effort — long digit sequences (card/account numbers) often arrive with interior spaces, so an over-strict pattern (^\d{16}$) rejects them and traps the caller in a re-ask loop. Added the recommended pattern + handler-side normalization. Source: assemblyai-docs #208, 2026-07-09.
  • API reference (references/api-reference.md): explain the shape-dependent matching of the granular location_* PII redaction policies (the values were already listed). A combined phrase like Toronto, Canada matches only the broad location, not the granular subtypes; Entity Detection returns only the broad location. Source: assemblyai-docs #201, 2026-07-08.

Reviewed but no change needed

  • Async speech_models default — the OpenAPI default is the single-element ["universal-3-5-pro"], but the user-facing model-selection doc states the effective default is ["universal-3-5-pro", "universal-2"], which is what the skill already says. Accurate.
  • Streaming Multilingual/Turn-Detection feature pages (#206) — documentation reorg of features (language_codes, language_detection, code-switching, 18 languages, three streaming models) that the skill already covers accurately. No new API surface.
  • nano legacy speech_model removal (#196) — the skill never referenced nano.
  • Vercel AI SDK integration page (#199) — a community-maintained third-party provider; out of scope for the skill's core API coverage.
  • Assorted link/accessibility/FAQ/doc-reorg commits — cosmetic.

…git tool pattern trap + granular location PII policies

- LLM Gateway: drop retired gemini-3-flash-preview model (removed from spec #198)
- Voice Agents: document tool parameter pattern/examples hints for spoken
  digit sequences and the re-ask-loop trap from over-strict patterns (#208)
- API reference: explain shape-dependent matching of granular location_*
  PII redaction policies; Entity Detection only returns broad location (#201)
- SKILL.md: add Key Gotcha for spoken-digit tool pattern trap
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