Introduction
So, you've set up a powerful knowledge base using Azure AI Foundry, and now you have a fresh batch of documents—PDF reports, Word docs, text files—that you need to add. How do you get this new information seamlessly into your index so your AI applications can start using it?
This guide walks you through the different methods to add documents to your knowledge base index within the Azure AI Foundry portal. Whether you prefer a direct upload, connecting to cloud storage, or using the broader Azure Portal, we've got you covered.
Method 1: Using the Azure AI Foundry Portal (Recommended)
This is the most straightforward method, designed specifically for AI Foundry workflows. It's perfect for quick updates and managing your data sources directly.
-
Go to Azure AI Foundry
- Navigate to https://ai.azure.com.
- Sign in and select your project (e.g.,
project1478).
-
Navigate to Your Index
- Click on Data or Indexes from the left-hand sidebar.
- You should see your existing knowledge base index listed here.
-
Add a Data Source
- Click on + New Index or Add data source.
- Choose your source type from the options:
- Azure Blob Storage: Ideal for uploading files (PDF, Word, TXT, etc.) in bulk.
- Azure Data Lake: For large-scale data lakes.
- Upload files: The quickest way for a handful of documents via direct upload.
-
Configure Indexing
- Select your search service (e.g.,
aifoundry1478search). - Choose the existing index (e.g.,
knowledge-base) or create a new one. - Configure chunking and processing options (the defaults are usually optimal to start).
- Select your search service (e.g.,
Method 2: Using the Azure Portal (Search Service)
If you're more comfortable in the main Azure Portal or need access to advanced data sources, this method is for you.
-
Go to Azure Portal
- Open the Azure Portal.
- Search for your Azure AI Search service (e.g.,
aifoundry1478search).
-
Import Data
- Within your search service, click on Import data at the top of the overview page.
- Choose your data source:
- Azure Blob Storage
- Azure SQL Database
- Azure Cosmos DB
- Upload a JSON or CSV file
-
Configure the Index
- Select your existing
knowledge-baseindex. - Map the fields from your source data to the index fields (e.g.,
id,title,content,category).
- Select your existing
-
Create and Run the Indexer
- Create an indexer, which is the process that pulls the data.
- You can set a schedule (e.g., run once, hourly, daily) for recurring updates.
Method 3: Upload Files to Blob Storage (The "Set and Forget" Method)
This is an excellent method for automating document ingestion, especially if you regularly add files to a designated cloud folder.
-
Upload Files to Azure Blob Storage
- Go to your storage account (e.g.,
aifoundry1478storage). - Create a container (if needed), such as
documents. - Upload your PDF, Word, and other documents to this container.
- Go to your storage account (e.g.,
-
Connect in AI Foundry Portal
- Back in the AI Foundry portal, go to Data → + Add data.
- Select Azure Blob Storage and connect to your storage account.
- Select the
documentscontainer you just used. - AI Foundry will automatically handle the chunking and indexing of all files in that container.
Quick Reference: Direct Upload Cheat Sheet
For a super fast, one-time upload, follow these steps:
| Step | Action |
|---|---|
| 1 | Go to https://ai.azure.com → Your project |
| 2 | Click Indexes or Data |
| 3 | Click + New index |
| 4 | Select Upload files |
| 5 | Drag & drop your PDF, Word, or TXT files directly into the browser |
| 6 | Configure search settings (or use defaults) |
| 7 | Click Create and let the platform index your content! |
Conclusion
Adding documents to your Azure AI Foundry knowledge base is a flexible process. For most users, Method 1 (AI Foundry Portal) is the quickest and most intuitive. If you're building an automated pipeline, Method 3 (Blob Storage) is the way to go.
By following these steps, you can easily keep your knowledge base current and powerful, ensuring your AI applications have access to the most relevant and up-to-date information.
Happy indexing
