Here’s a copy-paste portal lab for Azure AI Search that gets you from zero to a working searchable index using Blob Storage + the Azure portal.
This follows Microsoft’s current portal flow: create a search service, upload sample data to Blob Storage, run the Import data wizard, let it create the data source, index, and indexer, and then test queries in the portal. The wizard also supports keyword, RAG, and multimodal RAG scenarios, and the vector quickstart uses integrated vectorization for chunking and embeddings. (Microsoft Learn)
What you’ll build
Blob Storage ↓Import data wizard ↓Data source + Index + Indexer ↓Search Explorer
Azure AI Search queries run over content loaded into a search index, and the portal wizard can create the ingestion pieces for supported sources like Blob Storage. (Microsoft Learn)
Portal lab: basic keyword search
1. Create the Azure AI Search service
In the Azure portal:
- Search for Azure AI Search
- Click Create
- Choose:
- Subscription
- Resource group
- Service name
- Region
- Pricing tier
Microsoft’s portal guide says you create the service directly in the portal and choose region and tier there. (Microsoft Learn)
2. Create a storage container
In Azure portal:
- Open Storage accounts
- Create or open one
- Go to Data storage → Containers
- Create a container
Microsoft’s full-text portal quickstart uses a sample container named hotels-sample-data. (Microsoft Learn)
Suggested container name:
search-lab-data
3. Upload sample documents
Upload a few .json, .txt, or .pdf files to the container.
Good starter options:
- product descriptions
- FAQ files
- policy text
- hotel/sample catalog style JSON
The portal quickstart supports using your own files, not only Microsoft’s sample data. (Microsoft Learn)
4. Open the Import data wizard
In your Azure AI Search resource:
- Go to Overview
- Click Import data
Microsoft’s portal quickstart uses this exact entry point. (Microsoft Learn)
5. Choose the data source
Select:
- Azure Blob Storage
Then provide:
- Storage subscription
- Storage account
- Container name
Azure AI Search supports a pull/indexer model for supported sources like Blob Storage. (Microsoft Learn)
6. Choose search type
For the first run, select:
Keyword search
Microsoft’s full-text portal quickstart uses Keyword search as the basic first lab. (Microsoft Learn)
7. Configure the index
The wizard will infer fields from your documents and create an index.
Typical fields look like this:
id key, retrievablecontent searchable, retrievabletitle searchable, filterable, retrievablecategory filterable, facetable, retrievablelastUpdated sortable, filterable, retrievable
In Azure AI Search, each document needs a unique key field in the index. (Microsoft Learn)
A simple example index shape:
{ "name": "docs-index", "fields": [ { "name": "id", "type": "Edm.String", "key": true, "searchable": false }, { "name": "title", "type": "Edm.String", "searchable": true }, { "name": "content", "type": "Edm.String", "searchable": true }, { "name": "category", "type": "Edm.String", "filterable": true, "facetable": true } ]}
8. Create and run the indexer
Let the wizard create an indexer and run it.
The indexer is what pulls data from Blob Storage into the search index. Azure documents indexers as the automated ingestion mechanism for supported data sources. (Microsoft Learn)
9. Test in Search Explorer
After indexing finishes:
- Open Indexes
- Select your index
- Open Search Explorer
Try queries like:
loaninterest ratepolicysupport
Azure AI Search supports full-text querying over the indexed documents once content is loaded. (Microsoft Learn)
What got created
You should now have:
- Search service
- Data source
- Index
- Indexer
- Indexed documents you can query in the portal
That is the standard Azure AI Search portal pattern for supported data sources. (Microsoft Learn)
Recommended field choices
When the wizard shows fields, a good rule is:
id→ keytitle→ searchablecontent→ searchablecategory→ filterable/facetable- dates → sortable/filterable
That gives you a useful first search app without overcomplicating the schema. The key-field requirement is mandatory in Azure AI Search indexes. (Microsoft Learn)
Upgrade path: vector + RAG lab
Once the keyword lab works, do a second run using the vector wizard.
Use:
- Import data
- choose the vector/RAG path
- let the wizard chunk content and vectorize it
Microsoft’s vector portal quickstart says the wizard can chunk your content and call an embedding model to vectorize chunks at indexing and query time. (Microsoft Learn)
For production, hybrid search is usually better than vector-only because Azure AI Search can run full-text and vector queries in parallel and merge results. (Microsoft Learn)
Fast troubleshooting
If indexing fails, the usual causes are:
- Blob container access/config is wrong
- unsupported or malformed files
- index schema/key field problems
- service can’t access the data source
Microsoft’s ingestion docs and Q&A guidance both point to data-source access and ingestion errors as common causes. (Microsoft Learn)
Best next step
After this lab, the most useful next exercise is:
- repeat it with the vector quickstart
- compare keyword search vs hybrid/vector search
- then connect it to Azure OpenAI for a RAG chatbot. (Microsoft Learn)