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-search-documents-py.md

Azure AI Search — Python SDK Quick Reference

Condensed from azure-search-documents-py. Full patterns (agentic retrieval, integrated vectorization, skillsets) in the azure-search-documents-py plugin skill if installed.

Install

pip install azure-search-documents azure-identity

Quick Start

from azure.search.documents import SearchClient
from azure.search.documents.indexes import SearchIndexClient, SearchIndexerClient
from azure.search.documents.models import VectorizedQuery

Non-Obvious Patterns

  • SearchIndexingBufferedSender for batch uploads with auto-batching/retries
  • Vector field type: Collection(Edm.Single) with vector_search_dimensions + vector_search_profile_name
  • Async client: from azure.search.documents.aio import SearchClient
  • KnowledgeBaseRetrievalClient for agentic retrieval with LLM-powered Q&A

Best Practices

  1. Use hybrid search for best relevance combining vector and keyword
  2. Enable semantic ranking for natural language queries
  3. Index in batches of 100-1000 documents for efficiency
  4. Use filters to narrow results before ranking
  5. Configure vector dimensions to match your embedding model
  6. Use HNSW algorithm for large-scale vector search
  7. Create suggesters at index creation time (cannot add later)
  8. Use SearchIndexingBufferedSender for batch uploads
  9. Always define semantic configuration for agentic retrieval indexes
  10. Use create_or_update_index for idempotent index creation
  11. Close clients with context managers or explicit close()