Index of every page on this site: llms.txt
All skills
microsoft avatar

/azure-ai

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
Run it yourself

Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary.

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-ai

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesspeechtranscription-and-audio-preflight.md

≈987 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Speech audio preflight and REST/batch transcription diagnostics

For local audio header validation, Speech endpoint/Entra auth preflight, Fast Transcription (2025-10-15), Batch Transcription (2025-10-15 / 2024-11-15) and Batch Synthesis (2024-04-01). For native Speech SDK text logs, use Speech SDK client diagnostics. Route Microsoft Foundry Voice Agents (kind: voice / azd ai agent) to microsoft-foundry.

Workflow

  1. Confirm which Speech surface the app calls:
Surface Path & tier Key public limits
Realtime STT / TTS WebSocket / short REST (F0/S0) STT: F0 1, S0 100 concurrent (STT + translation shared), diarization <= 240 min. TTS: <= 10 min audio, <= 50 <voice>/<audio> tags, <= 64 KB WS SSML.
Fast Transcription POST /speechtotext/transcriptions:transcribe?api-version=2025-10-15 (S0) Synchronous, < 500 MB, < 5 hours, shares 600 req/min with Batch STT.
Batch Transcription POST /speechtotext/transcriptions:submit?api-version=2025-10-15 (S0) Async (contentContainerUrl or <= 1,000 contentUrls, <= 10,000 blobs/container), <= 1 GB/file, diarization <= 240 min/file, timeToLiveHours 6h..31d.
Batch Synthesis PUT /texttospeech/batchsyntheses/{id}?api-version=2024-04-01 (S0) Payload <= 2 MB, <= 10,000 inputs, ID 3-64 chars ([A-Za-z0-9._-], alnum ends). Destination storage cannot be network-restricted (Long Audio retires 2027-04-01).
  1. Never ask for keys/SAS or paste transcripts/SSML. Check node --version (Node.js 22+). If missing/older, follow audio checks without Node. Otherwise run the local inspector:

    node "<skill-directory>/scripts/inspect-speech-audio.mjs" --file "<local-audio-or-json>" --mode realtime-sdk
    & node "<skill-directory>\scripts\inspect-speech-audio.mjs" --file "<local-audio-or-json>" --mode realtime-sdk

    Modes: realtime-sdk, fast-transcription, batch-transcription, batch-transcription-files, batch-synthesis-job. Bash and PowerShell launchers use exit codes 0 report/--help, 1 file/JSON error, 2 usage error, 3 Node 22+ missing.

  2. Check common failure patterns:

    • SPXERR_INVALID_HEADER/NoMatch on .wav: compressed audio renamed .wav, non-PCM formatTag, missing/empty/truncated data chunk, or leading all-zero PCM.
    • Entra ID / Private Link 401/403: needs customSubdomainName, Cognitive Services Speech Contributor or Speech User, and aad#<resourceId>#<entraToken> on regional SDK hosts. Keys fail when disableLocalAuth: true.
    • Batch Succeeded with missing outputs: List Files has one Transcription per successful input plus a TranscriptionReport, no per-file status. Run batch-transcription-files on the list, then on the downloaded report (failedTranscriptionsCount).
    • REST 429/499/5xx: SDK log analysis does not apply. Keep causes open from status codes; gather UTC times, region/endpoint, concurrency and response headers (no keys). A 429 within quota can occur while the service autoscales.

Sources

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning11d4 checks · Risk SAFE
  • Gen Agent Trust Hub11d

    This skill provides tools and guidance for developing and troubleshooting Azure AI services. It includes a local diagnostic script for analyzing Speech SDK logs with robust safety controls, along with comprehensive references for official Azure SDKs and secure authentication practices.

  • Socket11d

    No alerts

  • Snyk11d

    Risk: LOW · No issues

  • Runlayer9mo

    15/15 files flagged

Signed by skilld at 0d60658. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago
metadata
{
  "author": "Microsoft",
  "version": "1.2.6"
}

README badge

README badge for microsoft/skills/azure-ai