CLOUD DEVELOPMENT / microsoft
Azure AI Search for Python
Create vector-capable indexes and combine keyword, vector and semantic queries.
“Azure AI Search SDK for Python. Use for vector search, hybrid search, semantic ranking, indexing, and skillsets. Triggers: "azure-search-documents", "SearchClient", "SearchIndexClient", "vector search", "hybrid search", "semantic search". ”
01 / THE REASONING
Why this made the selection.
- New code is told to use DefaultAzureCredential. An API key is only for a deployment that has not moved to Entra yet.
- Suggesters have to exist when the index is created. The skill says they cannot be added later.
- The definition covers field/profile wiring, separate index/query clients and hybrid queries. The setup helper constructs an index and calls create_or_update_index; no index was created.
- Build a search schema aligned with the embedding dimension
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/plugins/azure-sdk-python/skills/azure-search-documents-py/SKILL.md
- .github/plugins/azure-sdk-python/skills/azure-search-documents-py/scripts/setup_vector_index.py
- LICENSE
- README.md
Our findings
- The script uses DefaultAzureCredential and requires AZURE_SEARCH_ENDPOINT. That is a write to the search service, not a local file.
- API keys remain in the skill only as a legacy path. The script itself does not read AZURE_SEARCH_API_KEY.
- It does not add a suggester to an index that already exists, and it does not upload or query documents.
- The definition covers field/profile wiring, separate index/query clients and hybrid queries. The setup helper constructs an index and calls create_or_update_index; no index was created.
Not established by this review
- The resource was not executed and its tools were not called.
- setup_vector_index.py was not run.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add microsoft/skills/.github/plugins/azure-sdk-python/skills/azure-search-documents-pyRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-search-documents-py- Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Install both search and identity dependencies, configure index/data roles and choose actual embedding dimensions.
- Validate field capabilities, semantic configuration and per-document indexing results before evaluating query quality.
Before you start
- Python, matching Azure SDK packages and azure-identity
- Authorized Azure resources and operation-specific roles
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-search-documents-py/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: install
- MIT licence ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: license
- .github/plugins/azure-sdk-python/skills/azure-search-documents-py/scripts/setup_vector_index.py ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-search-documents-py/scripts/setup_vector_index.py
Supports: review, limitations, access, install
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-search-documents-py/SKILL.md
Supports: upstreamDescription, bestFor, review.reviewedAt, review.notTested