All skills
microsoft avatar

/azure-ai

@b3c238e
by microsoftmicrosoft/skills3.1k stars
351

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

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

This session only. Nothing lands on disk.

referencessdkazure-ai-translation-ts.md

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

Azure Translation — TypeScript SDK Quick Reference

Condensed from azure-ai-translation-ts. Full patterns (document translation, batch SAS, transliterate) in the azure-ai-translation-ts plugin skill if installed.

Install

npm install @azure-rest/ai-translation-text @azure/identity

Quick Start

import TextTranslationClient, { TranslatorCredential, isUnexpected } from "@azure-rest/ai-translation-text";
const credential: TranslatorCredential = { key: process.env.TRANSLATOR_SUBSCRIPTION_KEY!, region: process.env.TRANSLATOR_REGION! };
const client = TextTranslationClient(process.env.TRANSLATOR_ENDPOINT!, credential);

Non-Obvious Patterns

  • REST client — TextTranslationClient is a function, not a class
  • Translate via client.path("/translate").post({ body: { inputs: [...] } })
  • Document translation: separate package @azure-rest/ai-translation-document
  • Batch docs require SAS URLs for source/target blob containers

Best Practices

  1. Auto-detect source — omit language parameter to auto-detect
  2. Batch requests — translate multiple texts in one call for efficiency
  3. Use SAS tokens — for document translation, use time-limited SAS URLs
  4. Handle errors — always check isUnexpected(response) before accessing body
  5. Regional endpoints — use regional endpoints for lower latency

Source: SKILL.md on GitHub

1 warning16d4 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill consists entirely of documentation, architectural quick references, and SDK code samples for Azure AI Services. It does not include any executable code or unexpected behavioral patterns. Security best practices, such as employing managed identities and avoiding hardcoded credentials, are actively promoted within the references.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    15/15 files flagged

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

Last checked against GitHub 20 hours ago.

Activeupdated 2 months ago
metadata
{
  "author": "Microsoft",
  "version": "1.2.1"
}

README badge

README badge for microsoft/skills/azure-ai