Index of every page on this site: llms.txt
All skills
microsoft avatar

/azure-ai

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
Run it yourself

Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary.

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

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencessearchindex-and-query-diagnostics.md

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

Azure AI Search index, vector/hybrid query and indexer diagnostics

For classic Azure AI Search (Microsoft.Search/searchServices) index schemas, vector/hybrid/semantic queries, indexer/skillset errors and Azure Monitor logs. Route Foundry IQ knowledge bases and connectors to foundry-iq, and generic Foundry agent creation to microsoft-foundry.

Workflow

  1. Classify: schema/query (400, unexpected hybrid/semantic results), indexer/skillset (failed items, enrichment auth) or throttling (503/429). Never ask for admin/query keys or echo query values.

  2. For an index JSON (search_index_get, REST or IaC) or query payload, check node --version (Node.js 22+). Without Node (don't install it unasked), read the JSON and check one top-level Edm.String key field plus each table row in step 3, without echoing query text, filter literals or vectors. Otherwise run the local schema/query validator:

    node "<skill-directory>/scripts/validate-search-schema.mjs" --index "<index.json>" --query "<query.json>"
    & node "<skill-directory>\scripts\validate-search-schema.mjs" --index "<index.json>" --query "<query.json>"

    Bash and PowerShell launchers use exit codes 0 report/--help, 1 file/JSON error, 2 usage error, 3 Node 22+ missing.

  3. Verify common schema, query and operational failure modes:

Symptom Public contract check
Vector query 400 or ignored Vector field must use Collection(Edm.Single) (or narrow Half/Int16/SByte, or Byte with vectorEncoding: "packedBit", whose dimensions count bits so queries send ceil(dimensions/8) bytes), searchable: true, positive dimensions matching the embedding model output, and a valid vectorSearchProfile -> algorithm. kind: "text" vector queries require an integrated vectorizer on the profile.
Semantic query 400 queryType: "semantic" requires a semanticConfiguration (or defaultConfiguration) whose prioritized content/keyword fields exist and have searchable: true.
$filter / orderby / facets / select 400 Referenced fields must not disable filterable, sortable, facetable or retrievable (hidden: false). REST defaults omitted attributes by type: simple fields are filterable, facetable (not GeographyPoint) and retrievable; only single-valued fields are sortable; vector fields are none of these. Azure SDK field classes have no defaults.
Indexer/skillset failures Inspect indexer status (lastResult.status, errors[], warnings[] with key, name, statusCode). Verify data-source RBAC, skillset AI Services identity/key attachment and projection target field mappings.
503 / 429 throttling Queries and indexing share replicas/partitions; heavy indexing or replica changes raise dropped queries.
  1. For permitted live checks, prefer azure__search (search_service_list, search_index_get, search_index_query) and keyless RBAC (Search Index Data Reader / Search Service Contributor). When diagnostic settings export to Log Analytics, check AzureMetrics (ThrottledSearchQueriesPercentage, SearchLatency, SearchQueriesPerSecond, DocumentsProcessedCount, SkillExecutionCount, IndexVectorUsage) and AzureDiagnostics (Category == "OperationLogs", OperationName, ResultType, ResultSignature, DurationMs). Absent logs are not proof of zero traffic.

Sources

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning11d4 checks · Risk SAFE
  • Gen Agent Trust Hub11d

    This skill provides tools and guidance for developing and troubleshooting Azure AI services. It includes a local diagnostic script for analyzing Speech SDK logs with robust safety controls, along with comprehensive references for official Azure SDKs and secure authentication practices.

  • Socket11d

    No alerts

  • Snyk11d

    Risk: LOW · No issues

  • Runlayer9mo

    15/15 files flagged

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

Last checked against GitHub yesterday.

Activeupdated 2 days ago
metadata
{
  "author": "Microsoft",
  "version": "1.2.6"
}

README badge

README badge for microsoft/skills/azure-ai