Azure AISearch – Indexing

Required Azure Role

Either one of these built-in roles (or a custom role with equivalent permissions):

  • Owner — full access including role assignments
  • Contributor — manage resources (no role assignments)

If role assignment is needed with Contributor, also grant User Access Administrator.

Azure Administration Tools / Interface

This guide uses the Azure Portal and a manual creation process.

Create and Manage Steps (Azure Portal)

  1. Click Import and vectorize data.
  1. Select Azure Blob Storage as the data source and choose the storage account created previously.
  1. Select the RAG scenario for indexing.
  1. Open the RAG scenario and configure the highlighted parameters.
  1. On Vectorize your text, select your Azure OpenAI resource and choose the deployment text-embedding-ada-002. Pick authentication as API key or User assigned identity (define the identity if used).
  1. On Vectorize and enrich your images, leave defaults (current data scope has no images).
  1. In Advanced settings, enable Semantic ranker. Keep index fields as-is for now. Set an indexing schedule to match repository usage (e.g., every 10 minutes for busy repos, daily for low-change repos).
  1. Review configuration and click Create.
  1. Open the created Index and copy the Index name and Semantic configuration for use by OpenAI Chat Completions. Define these values in the Repository Administrator and the Azure App Service (bot backend).
  1. Go to the Indexer to verify run status and adjust scheduling or trigger manual runs as needed.