skilld
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.

Ask your Agent

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

This session only. Nothing lands on disk.

referencessdkazure-search-documents-ts.md

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

Azure AI Search — TypeScript SDK Quick Reference

Condensed from azure-search-documents-ts. Full patterns (semantic config, vector profiles, autocomplete) in the azure-search-documents-ts plugin skill if installed.

Install

npm install @azure/search-documents @azure/identity

Quick Start

import { SearchClient, SearchIndexClient, SearchIndexerClient } from "@azure/search-documents";
const searchClient = new SearchClient(endpoint, indexName, credential);

Non-Obvious Patterns

  • Vector search uses vectorSearchOptions.queries array with kind: "vector"
  • Semantic search requires queryType: "semantic" + semanticSearchOptions
  • Batch ops: searchClient.indexDocuments({ actions: [{ upload: doc }, { delete: doc }] })

Best Practices

  1. Use hybrid search — combine vector + text for best results
  2. Enable semantic ranking — improves relevance for natural language queries
  3. Batch document uploads — use uploadDocuments with arrays, not single docs
  4. Use filters for security — implement document-level security with filters
  5. Index incrementally — use mergeOrUploadDocuments for updates
  6. Monitor query performance — use includeTotalCount: true sparingly in production

Source: SKILL.md on GitHub

Third-party checks

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

Provenance

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

Capability

metadata
{
  "author": "Microsoft",
  "version": "1.2.1"
}

Topics

README badge

README badge for microsoft/skills/azure-ai