Skip to content

Commit 3b5cbd0

Browse files
authored
Merge pull request #273759 from aahill/oyd-fixes
updating db tab
2 parents d172e7a + ee20b8d commit 3b5cbd0

File tree

2 files changed

+28
-45
lines changed

2 files changed

+28
-45
lines changed

articles/ai-services/openai/concepts/use-your-data.md

Lines changed: 28 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -62,59 +62,15 @@ The [Integrated Vector Database in vCore-based Azure Cosmos DB for MongoDB](/azu
6262

6363
For some data sources such as uploading files from your local machine (preview) or data contained in a blob storage account (preview), Azure AI Search is used. When you choose the following data sources, your data is ingested into an Azure AI Search index.
6464

65-
>[!TIP]
66-
>If you use Azure Cosmos DB (except for its vCore-based API for MongoDB), you may be eligible for the [Azure AI Advantage offer](/azure/cosmos-db/ai-advantage), which provides the equivalent of up to $6,000 in Azure Cosmos DB throughput credits.
67-
68-
|Data source | Description |
65+
|Data ingested through Azure AI Search | Description |
6966
|---------|---------|
7067
| [Azure AI Search](/azure/search/search-what-is-azure-search) | Use an existing Azure AI Search index with Azure OpenAI On Your Data. |
71-
| [Azure Cosmos DB](/azure/cosmos-db/introduction) | Azure Cosmos DB's API for Postgres and vCore-based API for MongoDB offer natively integrated vector indexing; therefore, they don't require Azure AI Search. However, its other APIs do require Azure AI Search for vector indexing. Azure Cosmos DB for NoSQL's natively integrated vector database debuts in mid-2024. |
7268
|Upload files (preview) | Upload files from your local machine to be stored in an Azure Blob Storage database, and ingested into Azure AI Search. |
7369
|URL/Web address (preview) | Web content from the URLs is stored in Azure Blob Storage. |
7470
|Azure Blob Storage (preview) | Upload files from Azure Blob Storage to be ingested into an Azure AI Search index. |
7571

7672
:::image type="content" source="../media/use-your-data/azure-databases-and-ai-search.png" lightbox="../media/use-your-data/azure-databases-and-ai-search.png" alt-text="Diagram of vector indexing services.":::
7773

78-
# [Vector Database in Azure Cosmos DB for MongoDB](#tab/mongo-db)
79-
80-
### Prerequisites
81-
* [vCore-based Azure Cosmos DB for MongoDB](/azure/cosmos-db/mongodb/vcore/introduction) account
82-
* A deployed [embedding model](../concepts/understand-embeddings.md)
83-
84-
### Limitations
85-
* Only vCore-based Azure Cosmos DB for MongoDB is supported.
86-
* The search type is limited to [Integrated Vector Database in Azure Cosmos DB for MongoDB](/azure/cosmos-db/mongodb/vcore/vector-search) with an Azure OpenAI embedding model.
87-
* This implementation works best on unstructured and spatial data.
88-
89-
90-
### Data preparation
91-
92-
Use the script provided on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts#data-preparation) to prepare your data.
93-
94-
<!--### Add your data source in Azure OpenAI Studio
95-
96-
To add vCore-based Azure Cosmos DB for MongoDB as a data source, you'll need an existing Azure Cosmos DB for MongoDB index containing your data, and a deployed Azure OpenAI Ada embeddings model that will be used for vector search.
97-
98-
1. In the [Azure OpenAI portal](https://oai.azure.com/portal) chat playground, select **Add your data**. In the panel that appears, select ** vCore-based Azure Cosmos DB for MongoDB** as the data source.
99-
1. Select your Azure subscription and database account, then connect to your Azure Cosmos DB account by providing your Azure Cosmos DB account username and password.
100-
101-
:::image type="content" source="../media/use-your-data/add-mongo-data-source.png" alt-text="A screenshot showing the screen for adding Mongo DB as a data source in Azure OpenAI Studio." lightbox="../media/use-your-data/add-mongo-data-source.png":::
102-
103-
1. **Select Database**. In the dropdown menus, select the database name, database collection, and index name that you want to use as your data source. Select the embedding model deployment you would like to use for vector search on this data source, and acknowledge that you'll incur charges for using vector search. Then select **Next**.
104-
105-
:::image type="content" source="../media/use-your-data/select-mongo-database.png" alt-text="A screenshot showing the screen for adding Mongo DB settings in Azure OpenAI Studio." lightbox="../media/use-your-data/select-mongo-database.png":::
106-
-->
107-
108-
### Index field mapping
109-
110-
When you add your vCore-based Azure Cosmos DB for MongoDB data source, you can specify data fields to properly map your data for retrieval.
111-
112-
* Content data (required): One or more provided fields to be used to ground the model on your data. For multiple fields, separate the values with commas, with no spaces.
113-
* File name/title/URL: Used to display more information when a document is referenced in the chat.
114-
* Vector fields (required): Select the field in your database that contains the vectors.
115-
116-
:::image type="content" source="../media/use-your-data/mongo-index-mapping.png" alt-text="A screenshot showing the index field mapping options for Mongo DB." lightbox="../media/use-your-data/mongo-index-mapping.png":::
117-
11874
# [Azure AI Search](#tab/ai-search)
11975

12076
You might want to consider using an Azure AI Search index when you either want to:
@@ -179,6 +135,33 @@ If you want to implement additional value-based criteria for query execution, yo
179135

180136
[!INCLUDE [ai-search-ingestion](../includes/ai-search-ingestion.md)]
181137

138+
139+
# [Vector Database in Azure Cosmos DB for MongoDB](#tab/mongo-db)
140+
141+
### Prerequisites
142+
* [vCore-based Azure Cosmos DB for MongoDB](/azure/cosmos-db/mongodb/vcore/introduction) account
143+
* A deployed [embedding model](../concepts/understand-embeddings.md)
144+
145+
### Limitations
146+
* Only vCore-based Azure Cosmos DB for MongoDB is supported.
147+
* The search type is limited to [Integrated Vector Database in Azure Cosmos DB for MongoDB](/azure/cosmos-db/mongodb/vcore/vector-search) with an Azure OpenAI embedding model.
148+
* This implementation works best on unstructured and spatial data.
149+
150+
151+
### Data preparation
152+
153+
Use the script provided on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts#data-preparation) to prepare your data.
154+
155+
### Index field mapping
156+
157+
When you add your vCore-based Azure Cosmos DB for MongoDB data source, you can specify data fields to properly map your data for retrieval.
158+
159+
* Content data (required): One or more provided fields to be used to ground the model on your data. For multiple fields, separate the values with commas, with no spaces.
160+
* File name/title/URL: Used to display more information when a document is referenced in the chat.
161+
* Vector fields (required): Select the field in your database that contains the vectors.
162+
163+
:::image type="content" source="../media/use-your-data/mongo-index-mapping.png" alt-text="A screenshot showing the index field mapping options for Mongo DB." lightbox="../media/use-your-data/mongo-index-mapping.png":::
164+
182165
# [Azure Blob Storage (preview)](#tab/blob-storage)
183166

184167
You might want to use Azure Blob Storage as a data source if you want to connect to existing Azure Blob Storage and use files stored in your containers.
248 KB
Loading

0 commit comments

Comments
 (0)