AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

azure-ai

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.

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read microsoft--azure-ai at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 16

references/sdk/azure-ai-translation-ts.md

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