Skip to content

Commit 796fd2f

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents 6008b8d + 18a0d58 commit 796fd2f

24 files changed

+380
-598
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30884,6 +30884,16 @@
3088430884
"redirect_url": "/azure/iot-accelerators/quickstart-connected-factory-deploy",
3088530885
"redirect_document_id": false
3088630886
},
30887+
{
30888+
"source_path": "articles/iot-accelerators/iot-accelerators-connected-factory-sample-walkthrough.md",
30889+
"redirect_url": "/azure/iot-accelerators/iot-accelerators-connected-factory-features",
30890+
"redirect_document_id": false
30891+
},
30892+
{
30893+
"source_path": "articles/iot-accelerators/iot-accelerators-connected-factory-gateway-deployment.md",
30894+
"redirect_url": "/azure/iot-accelerators/iot-accelerators-connected-factory-features",
30895+
"redirect_document_id": false
30896+
},
3088730897
{
3088830898
"source_path": "articles/iot-accelerators/iot-accelerators-predictive-overview.md",
3088930899
"redirect_url": "/azure/iot-accelerators/quickstart-predictive-maintenance-deploy",

articles/aks/coredns-custom.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -190,5 +190,7 @@ To learn more about core network concepts, see [Network concepts for application
190190
[kubectl delete]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#delete
191191
[coredns hosts]: https://coredns.io/plugins/hosts/
192192
193-
<!-- LINKS - external -->
193+
<!-- LINKS - internal -->
194194
[concepts-network]: concepts-network.md
195+
[aks-quickstart-cli]: kubernetes-walkthrough.md
196+
[aks-quickstart-portal]: kubernetes-walkthrough-portal.md

articles/azure-monitor/log-query/cross-workspace-query.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,19 +11,19 @@ ms.service: log-analytics
1111
ms.workload: na
1212
ms.tgt_pltfrm: na
1313
ms.topic: conceptual
14-
ms.date: 11/15/2018
14+
ms.date: 06/05/2019
1515
ms.author: magoedte
1616
---
1717

1818
# Perform cross-resource log queries in Azure Monitor
1919

20-
Previously with Azure Monitor, you could only analyze data from within the current workspace, and it limited your ability to query across multiple workspaces defined in your subscription. Additionally, you could only search telemetry items collected from your web-based application with Application Insights directly in Application Insights or from Visual Studio. This also made it a challenge to natively analyze operational and application data together.
20+
Previously with Azure Monitor, you could only analyze data from within the current workspace, and it limited your ability to query across multiple workspaces defined in your subscription. Additionally, you could only search telemetry items collected from your web-based application with Application Insights directly in Application Insights or from Visual Studio. This also made it a challenge to natively analyze operational and application data together.
2121

22-
Now you can query not only across multiple Log Analytics workspaces, but also data from a specific Application Insights app in the same resource group, another resource group, or another subscription. This provides you with a system-wide view of your data. You can only perform these types of queries in [Log Analytics](portals.md).
22+
Now you can query not only across multiple Log Analytics workspaces, but also data from a specific Application Insights app in the same resource group, another resource group, or another subscription. This provides you with a system-wide view of your data. You can only perform these types of queries in [Log Analytics](portals.md).
2323

2424
## Cross-resource query limits
2525

26-
* The number of Application Insights resources that you can include in a single query is limited to 100.
26+
* The number of Application Insights resources and Log Analytics workspaces that you can include in a single query is limited to 100.
2727
* Cross-resource query is not supported in View Designer. You can Author a query in Log Analytics and pin it to Azure dashboard and [visualize a log search](../../azure-monitor/learn/tutorial-logs-dashboards.md#visualize-a-log-search).
2828
* Cross-resource query in log alerts is supported in the new [scheduledQueryRules API](https://docs.microsoft.com/rest/api/monitor/scheduledqueryrules). By default, Azure Monitor uses the [legacy Log Analytics Alert API](../platform/api-alerts.md) for creating new log alert rules from Azure portal, unless you switch from [legacy Log Alerts API](../platform/alerts-log-api-switch.md#process-of-switching-from-legacy-log-alerts-api). After the switch, the new API becomes the default for new alert rules in Azure portal and it lets you create cross-resource query log alerts rules. You can create cross-resource query log alert rules without making the switch by using the [ARM template for scheduledQueryRules API](../platform/alerts-log.md#log-alert-with-cross-resource-query-using-azure-resource-template) – but this alert rule is manageable though [scheduledQueryRules API](https://docs.microsoft.com/rest/api/monitor/scheduledqueryrules) and not from Azure portal.
2929

articles/cognitive-services/QnAMaker/Concepts/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ QnA Maker allows users to [collaborate](../How-to/collaborate-knowledge-base.md)
108108

109109
## Active learning
110110

111-
[Active learning](../How-to/improve-knowledge-base.md) does the best job of suggesting alternative questions when it has a wide range of quality and quantity of user-based queries. It is important to allow client-applications' user queries to participate in the active learning feedback loop without censorship. Once questions are suggested in the QnA Maker portal, you can **[filter by suggestions](../How-To/improve-knowledge-base.md#add-active-learning-suggestion-to-knowledge-base)** then review and accept or reject those suggestions.
111+
[Active learning](../How-to/improve-knowledge-base.md) does the best job of suggesting alternative questions when it has a wide range of quality and quantity of user-based queries. It is important to allow client-applications' user queries to participate in the active learning feedback loop without censorship. Once questions are suggested in the QnA Maker portal, you can **[filter by suggestions](../How-To/improve-knowledge-base.md)** then review and accept or reject those suggestions.
112112

113113
## Next steps
114114

articles/cognitive-services/QnAMaker/How-To/metadata-generateanswer-usage.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Metadata with GenerateAnswer API - QnA Maker
33
titleSuffix: Azure Cognitive Services
4-
description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer sets. This information can be used to filter results to user queries and to store additional information that can be used in follow-up conversations.
4+
description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer sets. You can filter results to user queries, and store additional information that can be used in follow-up conversations.
55
services: cognitive-services
66
author: tulasim88
77
manager: nitinme
@@ -12,41 +12,41 @@ ms.date: 05/30/2019
1212
ms.author: tulasim
1313
---
1414

15-
# Get a knowledge answer with the GenerateAnswer API and metadata
15+
# Get an answer with the GenerateAnswer API and metadata
1616

17-
To get the predicted answer to a user's question, use the GenerateAnswer API. When you publish a knowledge base, this information to use this API is shown on the publish page. You can also configure the API to filter answers based on metadata tags and test the knowledge base from the endpoint with the test query string parameter.
17+
To get the predicted answer to a user's question, use the GenerateAnswer API. When you publish a knowledge base, you can see information about how to use this API on the **Publish** page. You can also configure the API to filter answers based on metadata tags, and test the knowledge base from the endpoint with the test query string parameter.
1818

19-
QnA Maker lets you add metadata, in the form of key and value pairs, to your question/answer sets. This information can be used to filter results to user queries and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
19+
QnA Maker lets you add metadata, in the form of key and value pairs, to your sets of questions and answers. You can then use this information to filter results to user queries, and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
2020

2121
<a name="qna-entity"></a>
2222

23-
## Storing questions and answers with a QnA Entity
23+
## Store questions and answers with a QnA entity
2424

25-
First it's important to understand how QnA Maker stores the question/answer data. The following illustration shows a QnA entity:
25+
It's important to understand how QnA Maker stores the question and answer data. The following illustration shows a QnA entity:
2626

27-
![QnA Entity](../media/qnamaker-how-to-metadata-usage/qna-entity.png)
27+
![Illustration of a QnA entity](../media/qnamaker-how-to-metadata-usage/qna-entity.png)
2828

29-
Each QnA entity has a unique and persistent ID. The ID can be used to make updates to a particular QnA entity.
29+
Each QnA entity has a unique and persistent ID. You can use the ID to make updates to a particular QnA entity.
3030

3131
<a name="generateanswer-api"></a>
3232

3333
## Get answer predictions with the GenerateAnswer API
3434

35-
You use the GenerateAnswer API in your Bot or application to query your knowledge base with a user question to get the best match from the question/answer sets.
35+
You use the GenerateAnswer API in your bot or application to query your knowledge base with a user question, to get the best match from the question and answer sets.
3636

3737
<a name="generateanswer-endpoint"></a>
3838

3939
## Publish to get GenerateAnswer endpoint
4040

41-
Once you publish your knowledge base, either from the [QnA Maker portal](https://www.qnamaker.ai), or using the [API](https://go.microsoft.com/fwlink/?linkid=2092179), you can get the details of your GenerateAnswer endpoint.
41+
After you publish your knowledge base, either from the [QnA Maker portal](https://www.qnamaker.ai), or by using the [API](https://go.microsoft.com/fwlink/?linkid=2092179), you can get the details of your GenerateAnswer endpoint.
4242

4343
To get your endpoint details:
4444
1. Sign in to [https://www.qnamaker.ai](https://www.qnamaker.ai).
45-
1. In **My knowledge bases**, click on **View Code** for your knowledge base.
46-
![my knowledge bases](../media/qnamaker-how-to-metadata-usage/my-knowledge-bases.png)
45+
1. In **My knowledge bases**, select **View Code** for your knowledge base.
46+
![Screenshot of My knowledge bases](../media/qnamaker-how-to-metadata-usage/my-knowledge-bases.png)
4747
1. Get your GenerateAnswer endpoint details.
4848

49-
![endpoint details](../media/qnamaker-how-to-metadata-usage/view-code.png)
49+
![Screenshot of endpoint details](../media/qnamaker-how-to-metadata-usage/view-code.png)
5050

5151
You can also get your endpoint details from the **Settings** tab of your knowledge base.
5252

@@ -65,10 +65,10 @@ https://{QnA-Maker-endpoint}/knowledgebases/{knowledge-base-ID}/generateAnswer
6565
|HTTP request property|Name|Type|Purpose|
6666
|--|--|--|--|
6767
|URL route parameter|Knowledge base ID|string|The GUID for your knowledge base.|
68-
|URL route parameter|QnAMaker endpoint host|string|The hostname of the endpoint deployed in your Azure subscription. This is available on the Settings page after you publish the knowledge base. |
68+
|URL route parameter|QnAMaker endpoint host|string|The hostname of the endpoint deployed in your Azure subscription. This is available on the **Settings** page after you publish the knowledge base. |
6969
|Header|Content-Type|string|The media type of the body sent to the API. Default value is: ``|
7070
|Header|Authorization|string|Your endpoint key (EndpointKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).|
71-
|Post Body|JSON object|JSON|The question with settings|
71+
|Post Body|JSON object|JSON|The question with settings.|
7272

7373

7474
The JSON body has several settings:
@@ -79,7 +79,7 @@ The JSON body has several settings:
7979
|`top`|optional|integer|The number of ranked results to include in the output. The default value is 1.|
8080
|`userId`|optional|string|A unique ID to identify the user. This ID will be recorded in the chat logs.|
8181
|`scoreThreshold`|optional|integer|Only answers with confidence score above this threshold will be returned. The default value is 0.|
82-
|`isTest`|optional|boolean|If set to true, returns results from `testkb` Search index instead of published index.|
82+
|`isTest`|optional|Boolean|If set to true, returns results from `testkb` Search index instead of published index.|
8383
|`strictFilters`|optional|string|If specified, tells QnA Maker to return only answers that have the specified metadata. Use `none` to indicate response should have no metadata filters. |
8484
|`RankerType`|optional|string|If specified as `QuestionOnly`, tells QnA Maker to search questions only. If not specified, QnA Maker searches questions and answers.
8585

@@ -142,19 +142,19 @@ A successful response returns a status of 200 and a JSON response.
142142

143143
<a name="metadata-example"></a>
144144

145-
## Using metadata allows you to filter answers by custom metadata tags
145+
## Use metadata to filter answers by custom metadata tags
146146

147-
Adding metadata allows you to filter the answers by these metadata tags. Add the metadata column from the **View Options** menu. Add metadata to your knowledge base by clicking on the metadata **+** icon to add a metadata pair. This pair consists of one key and one value.
147+
Adding metadata allows you to filter the answers by these metadata tags. Add the metadata column from the **View Options** menu. Add metadata to your knowledge base by selecting the metadata **+** icon to add a metadata pair. This pair consists of one key and one value.
148148

149-
![add metadata](../media/qnamaker-how-to-metadata-usage/add-metadata.png)
149+
![Screenshot of adding metadata](../media/qnamaker-how-to-metadata-usage/add-metadata.png)
150150

151151
<a name="filter-results-with-strictfilters-for-metadata-tags"></a>
152152

153153
## Filter results with strictFilters for metadata tags
154154

155-
Consider the user question "When does this hotel close?" where the intent is implied for the restaurant "Paradise."
155+
Consider the user question "When does this hotel close?", where the intent is implied for the restaurant "Paradise."
156156

157-
Since results are required only for the restaurant "Paradise", you can set a filter in the GenerateAnswer call on the metadata "Restaurant Name", as follows.
157+
Because results are required only for the restaurant "Paradise", you can set a filter in the GenerateAnswer call on the metadata "Restaurant Name". The following example shows this:
158158

159159
```json
160160
{
@@ -172,7 +172,7 @@ Since results are required only for the restaurant "Paradise", you can set a fil
172172

173173
## Use question and answer results to keep conversation context
174174

175-
The response to the GenerateAnswer contains the corresponding metadata information of the matched question/answer set. This information can be used in your client application to store the context of the previous conversation for use in later conversations.
175+
The response to the GenerateAnswer contains the corresponding metadata information of the matched question and answer set. You can use this information in your client application to store the context of the previous conversation for use in later conversations.
176176

177177
```json
178178
{
@@ -217,7 +217,7 @@ You can search through the published kb, using `isTest=false`, or in the test kb
217217

218218
## Next steps
219219

220-
The publish page also provides information to generate an answer with [Postman](../Quickstarts/get-answer-from-kb-using-postman.md) and [cURL](../Quickstarts/get-answer-from-kb-using-curl.md).
220+
The **Publish** page also provides information to generate an answer with [Postman](../Quickstarts/get-answer-from-kb-using-postman.md) and [cURL](../Quickstarts/get-answer-from-kb-using-curl.md).
221221

222222
> [!div class="nextstepaction"]
223223
> [Create a knowledge base](./create-knowledge-base.md)

0 commit comments

Comments
 (0)