You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/search/knowledge-store-projection-example-long.md
+11-8Lines changed: 11 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,22 +7,22 @@ manager: nitinme
7
7
author: HeidiSteen
8
8
ms.author: heidist
9
9
ms.service: azure-ai-search
10
-
ms.topic: conceptual
11
-
ms.date: 06/17/2025
10
+
ms.topic: concept-article
11
+
ms.date: 07/28/2025
12
12
ms.custom:
13
13
- ignite-2023
14
14
- sfi-ropc-nochange
15
15
---
16
16
17
-
# Detailed example of shapes and projections in a knowledge store
17
+
# Example of shapes and projections in a knowledge store
18
18
19
-
This article provides a detailed example that supplements [high-level concepts](knowledge-store-projection-overview.md) and [syntax-based articles](knowledge-store-projections-examples.md) by walking you through the shaping and projection steps required for fully expressing the output of a rich skillset in a [knowledge store](knowledge-store-concept-intro.md).
19
+
This article provides a detailed example that supplements [high-level concepts](knowledge-store-projection-overview.md) and [syntax-based articles](knowledge-store-projections-examples.md) by walking you through the shaping and projection steps required for fully expressing the output of a rich skillset in a [knowledge store](knowledge-store-concept-intro.md) in Azure Storage.
20
20
21
-
If your application requirements call for multiple skills and projections, this example can give you a better idea of how shapes and projections intersect.
21
+
If your application requirements call for multiple skills and projections, this example can give you a better idea of how shapes and projections interact.
22
22
23
23
## Set up sample data
24
24
25
-
Sample documents aren't included with the Projections collection, but the [AI enrichment demo data files](https://github.com/Azure-Samples/azure-search-sample-data/tree/main/ai-enrichment-mixed-media) contain text and images that work with the projections described in this example.
25
+
Sample documents aren't included with the Projections collection, but the [AI enrichment demo data files](https://github.com/Azure-Samples/azure-search-sample-data/tree/main/ai-enrichment-mixed-media) contain text and images that work with the projections described in this example. If you use this sample data, you can skip step that [attaches an Azure AI multi-service account](cognitive-search-attach-cognitive-services.md) because you stay under the daily indexer limit for free enrichments.
26
26
27
27
Create a blob container in Azure Storage and upload all 14 items.
28
28
@@ -39,7 +39,7 @@ Pay close attention to skill outputs (targetNames). Outputs written to the enric
39
39
```json
40
40
{
41
41
"name": "projections-demo-ss",
42
-
"description": "Skillset that enriches blob data found in "merged_content". The enrichment granularity is a document.",
42
+
"description": "Skillset that enriches blob data found in the merged_content field. The enrichment granularity is a document.",
"description": "An Azure AI services resource in the same region as Search.",
185
-
"key": "<Azure AI services All-in-ONE KEY>"
185
+
"key": ""
186
186
},
187
187
"knowledgeStore": null
188
188
}
189
189
```
190
190
191
+
> [!NOTE]
192
+
> Under `"cognitiveServices"`, the key field is unspecified because the indexer can use an Azure AI multi-service account in the same region as your search service and process up to 20 transactions daily at no charge. The sample data for this example stays under the 20 transaction limit.
193
+
191
194
## Example Shaper skill
192
195
193
196
A [Shaper skill](cognitive-search-skill-shaper.md) is a utility for working with existing enriched content instead of creating new enriched content. Adding a Shaper to a skillset lets you create a custom shape that you can project into table or blob storage. Without a custom shape, projections are limited to referencing a single node (one projection per output), which isn't suitable for tables. Creating a custom shape aggregates various elements into a new logical whole that can be projected as a single table, or sliced and distributed across a collection of tables.
0 commit comments