Merge pull request #271877 from adishachar/adishachar/add-content-to-ga

v-shils · web-flow · commit 9da5d518f562 · 2024-05-07T11:36:29.000-07:00
updates and fixes before GA in service level
diff --git a/articles/azure-health-insights/TOC.yml b/articles/azure-health-insights/TOC.yml
@@ -6,12 +6,12 @@ items:
   items:
     - name: About Azure AI Health Insights
       href: overview.md
+    - name: Radiology Insights 
+      href: ./radiology-insights/index.yml   
     - name: OncoPhenotype
       href: ./oncophenotype/index.yml
     - name: Trial Matcher 
       href: ./trial-matcher/index.yml    
-    - name: Radiology Insights 
-      href: ./radiology-insights/index.yml   
 - name: Quickstarts
   expanded: true
   items:
diff --git a/articles/azure-health-insights/configure-containers.md b/articles/azure-health-insights/configure-containers.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: how-to
-ms.date: 03/14/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/deploy-portal.md b/articles/azure-health-insights/deploy-portal.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
@@ -16,7 +16,7 @@ ms.author: behoorne
 
 In this quickstart, you learn how to deploy Azure AI Health Insights using the Azure portal.
 
-Once deployment is complete, you can use the Azure portal to navigate to the newly created Azure AI Health Insights, and retrieve the needed details  such your service URL, keys and manage your access controls.
+Once deployment is complete, you can use the Azure portal to navigate to the newly created Azure AI Health Insights, and retrieve the needed details such your service URL, keys and manage your access controls.
 
 ## Deploy Azure AI Health Insights
 
@@ -33,9 +33,25 @@ Once deployment is complete, you can use the Azure portal to navigate to the new
     - **Region**: Select an Azure location, such as West Europe.
     - **Name**: Enter an Azure AI services account name.
     - **Pricing tier**: Select your pricing tier.
+    - **New/Existing Language resource**: Choose if to create a new Language resource or provide an existing one.
+    - **Language resource name**: Enter the Language resource name.
+    - **Language resource pricing tier**: Select your Language resource pricing tier.
 
      [ ![Screenshot of how to create new Azure AI services account.](media/create-health-insights.png)](media/create-health-insights.png#lightbox)
 
+It is necessary to associate an Azure AI Language resource with the Health Insights resource, to enable the use of Text Analytics for Health by the Health Insights AI models. 
+When a Language resource is associated with a Health Insights resource, a couple of things happen in the background, in order to allow the Health Insights resource access to the Language resource:
+ - A system assigned managed identity is enabled for the Health Insights resource.
+ - A role assignment of 'Cognitive Services User' scoped for the Language resource is added to the Health Insights resource's identity.
+
+It is important not to change or delete these assignments. 
+Any of the following actions may disrupt the required access to the associated Language resource and cause API request failures: 
+- Deleting the Language resource.
+- Disabling the Health Insights resource system assigned managed identity.
+- Removing the Health Insights resource 'Cognitive Services User' role from the Language resource. 
+
+
+
 5. Navigate to your newly created service.
     
     [ ![Screenshot of the Overview of Azure AI services account.](media/created-health-insights.png)](media/created-health-insights.png#lightbox)
diff --git a/articles/azure-health-insights/index.yml b/articles/azure-health-insights/index.yml
@@ -4,12 +4,12 @@ title: Azure AI Health Insights
 summary: Azure AI Health Insights
 metadata:
   title: Azure AI Health Insights
-  description: this article contains documentation regarding the different Health Decision Models from Health A.I.
+  description: This article contains documentation regarding the different Health Decision Models of Azure Health Insights
   ms.service: Azure AI Health Insights
   ms.topic: landing-page 
   author: iBoonZ
   ms.author: behoorne
-  ms.date: 01/26/2023
+  ms.date: 05/05/2024
 
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | tutorial | overview | quickstart | reference | sample | tutorial | video | whats-new 
@@ -31,22 +31,22 @@ landingContent:
             url: use-containers.md
           - text: How to configure the containers 
             url: configure-containers.md
-  - title: OncoPhenotype
+  - title: Radiology Insights
     linkLists:
       - linkListType: overview
         links:
-          - text: About OncoPhenotype
-            url: oncophenotype/overview.md
+          - text: About Radiology Insights
+            url: radiology-insights/overview.md
       - linkListType: concept
         links:
           - text: Model configuration
-            url: oncophenotype/model-configuration.md
+            url: radiology-insights/model-configuration.md
           - text: Inference information
-            url: oncophenotype/inferences.md    
+            url: radiology-insights/inferences.md
       - linkListType: quickstart
         links:
           - text: Get started
-            url: oncophenotype/get-started.md
+            url: radiology-insights/get-started.md
   - title: Trial Matcher
     linkLists:
       - linkListType: overview
@@ -65,19 +65,19 @@ landingContent:
         links:
           - text: Get started
             url: trial-matcher/get-started.md
-  - title: Radiology Insights
+  - title: OncoPhenotype
     linkLists:
       - linkListType: overview
         links:
-          - text: About Radiology Insights
-            url: radiology-insights/overview.md
+          - text: About OncoPhenotype
+            url: oncophenotype/overview.md
       - linkListType: concept
         links:
           - text: Model configuration
-            url: radiology-insights/model-configuration.md
+            url: oncophenotype/model-configuration.md
           - text: Inference information
-            url: radiology-insights/inferences.md
+            url: oncophenotype/inferences.md    
       - linkListType: quickstart
         links:
           - text: Get started
-            url: radiology-insights/get-started.md
+            url: oncophenotype/get-started.md
diff --git a/articles/azure-health-insights/media/create-health-insights.png b/articles/azure-health-insights/media/create-health-insights.png
diff --git a/articles/azure-health-insights/oncophenotype/get-started.md b/articles/azure-health-insights/oncophenotype/get-started.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: quickstart
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/oncophenotype/index.yml b/articles/azure-health-insights/oncophenotype/index.yml
@@ -11,7 +11,7 @@ metadata:
   ms.topic: landing-page 
   author: iBoonZ
   ms.author: behoorne
-  ms.date: 01/26/2023
+  ms.date: 05/05/2024
 
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | tutorial | overview | quickstart | reference | sample | tutorial | video | whats-new 
diff --git a/articles/azure-health-insights/oncophenotype/inferences.md b/articles/azure-health-insights/oncophenotype/inferences.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/oncophenotype/model-configuration.md b/articles/azure-health-insights/oncophenotype/model-configuration.md
@@ -7,14 +7,18 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
 
 # Onco-Phenotype model configuration
 
-To interact with the Onco-Phenotype model, you can provide several model configurations parameters that modify the outcome of the responses.
+To interact with the Onco-Phenotype model, you can provide several model configurations parameters that modify the outcome of the responses and reflects the preferences of the user.
+
+> [!NOTE]
+> The examples in this article are based on API version: 2023-03-01-preview. For a specific API version, please follow the reference to the REST API to see full description of each API version.
+
 
 > [!IMPORTANT]
 > Model configuration is applied to ALL the patients within a request.
@@ -47,7 +51,7 @@ If a case is found in the provided clinical documents and the model is able to f
 
 ### With case finding 
 
-The following example represents a case finding. The ```checkForCancerCase``` has been set to ```true``` and ```includeEvidence``` has been set to ```false```. Meaning the model checks for a cancer case but not include the evidence.
+The following example represents a case finding. The ```checkForCancerCase``` is set to ```true``` and ```includeEvidence``` is set to ```false```. Meaning the model checks for a cancer case but not include the evidence.
 
 Request that contains a case:
 ```json
@@ -196,7 +200,7 @@ false               | No evidence is returned
 
 ## Evidence example
 
-The following example represents a case finding. The ```checkForCancerCase``` has been set to ```true``` and ```includeEvidence``` has been set to ```true```. Meaning the model checks for a cancer case and include the evidence.
+The following example represents a case finding. The ```checkForCancerCase``` is set to ```true``` and ```includeEvidence``` is set to ```true```. Meaning the model checks for a cancer case and include the evidence.
 
 Request that contains a case:
 ```json 
diff --git a/articles/azure-health-insights/oncophenotype/overview.md b/articles/azure-health-insights/oncophenotype/overview.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/oncophenotype/patient-info.md b/articles/azure-health-insights/oncophenotype/patient-info.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
@@ -22,6 +22,9 @@ The payload should contain a ```patients``` section with one or more objects whe
 
 In this example, the Onco-Phenotype model receives patient information in the form of unstructured clinical notes.
 
+> [!NOTE]
+> The examples in this article are based on API version: 2023-03-01-preview. For a specific API version, please follow the reference to the REST API to see full description of each API version.
+
 ```json
 {
   "configuration": {
diff --git a/articles/azure-health-insights/oncophenotype/support-and-help.md b/articles/azure-health-insights/oncophenotype/support-and-help.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/oncophenotype/transparency-note.md b/articles/azure-health-insights/oncophenotype/transparency-note.md
@@ -5,7 +5,7 @@ services: azure-health-insights
 author: psanapathi
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 04/11/2023
+ms.date: 05/05/2024
 ms.author: prsanapa
 ---
 
diff --git a/articles/azure-health-insights/overview.md b/articles/azure-health-insights/overview.md
@@ -7,13 +7,13 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
-# What is Azure AI Health Insights (Preview)?
+# What is Azure AI Health Insights?
 
-Azure AI Health Insights is a Cognitive Service providing an API that serves insight models, which perform analysis and provide inferences to be used by a human. The models can receive input in different modalities, and return insight inferences including evidence as a result, for key high value scenarios in the health domain
+Azure AI Health Insights is an Azure AI service providing an API that serves insight models, which perform analysis to support a human decision. The AI models receive patient data input in different modalities, and return insight inferences including evidence as a result, for key high value scenarios in the health domain.
 
 > [!IMPORTANT] 
 > Azure AI Health Insights is a capability provided “AS IS” and “WITH ALL FAULTS.” Azure AI Health Insights isn't intended or made available for use as a medical device, clinical support, diagnostic tool, or other technology intended to be used in the diagnosis, cure, mitigation, treatment, or prevention of disease or other conditions, and no license or right is granted by Microsoft to use this capability for such purposes. This capability isn't designed or intended to be implemented or deployed as a substitute for professional medical advice or healthcare opinion, diagnosis, treatment, or the clinical judgment of a healthcare professional, and should not be used as such. The customer is solely responsible for any use of Azure AI Health Insights. 
@@ -31,12 +31,11 @@ The [Trial Matcher](./trial-matcher/overview.md) model receives patients' data a
 
 The [Onco-Phenotype](./oncophenotype/overview.md) receives clinical records of oncology patients and outputs cancer staging, such as  **clinical stage TNM** categories and **pathologic stage TNM categories** as well as **tumor site** and **histology**.
 
-The [Radiology Insights](./radiology-insights/overview.md) model receives patients' radiology report and provides quality checks with feedback on errors and mismatches to ensure critical findings are surfaced and presented using the full context of a radiology report. In addition, follow-up recommendations and clinical findings with measurements documented by the radiologist are flagged.
+The [Radiology Insights](./radiology-insights/overview.md) model receives patients' radiology report and provides quality checks with feedback on errors and mismatches. The Radiology Insights model ensures critical findings are surfaced and presented using the full context of a radiology report. In addition, the model is highlighting follow-up recommendations and clinical findings with measurements documented by the radiologist.
 
 ## Architecture
 
-![Diagram that shows Azure AI Health Insights architecture.](media/architecture.png) 
-    [ ![Diagram that shows Azure AI Health Insights architecture.](media/architecture.png)](media/architecture.png#lightbox)
+[ ![Diagram that shows Azure AI Health Insights architecture.](media/architecture.png)](media/architecture.png#lightbox)
 
 Azure AI Health Insights service receives patient data in different modalities, such as unstructured healthcare data, FHIR resources or specific JSON format data. In addition, the service receives a model configuration, such as ```includeEvidence``` parameter. 
 With these input patient data and configuration, the service can run the data through the selected health insights AI model, such as Trial Matcher, Onco-Phenotype or Radiology Insights.  
@@ -46,7 +45,7 @@ With these input patient data and configuration, the service can run the data th
 Review the following information to learn how to deploy Azure AI Health Insights and to learn additional information about each of the models:
 
 >[!div class="nextstepaction"]
-> [Deploy Azure AI Health Insights](deploy-portal.md) 
+> [Deploy Azure AI Health Insights using Azure portal](deploy-portal.md) 
 
 >[!div class="nextstepaction"]
 > [Onco-Phenotype](oncophenotype/overview.md) 
diff --git a/articles/azure-health-insights/responsible-ai/data-privacy-security.md b/articles/azure-health-insights/responsible-ai/data-privacy-security.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/26/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/trial-matcher/faq.md b/articles/azure-health-insights/trial-matcher/faq.md
@@ -7,14 +7,14 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
 
 # Trial Matcher frequently asked questions
 
-You’ll find answers to commonly asked questions about Trial Matcher, part of Azure AI Health Insights service, in this article
+You find answers to commonly asked questions about Trial Matcher, part of Azure AI Health Insights service, in this article.
 
 ## Is there a workaround for patients whose clinical documents exceed the # characters limit?
 Unfortunately, we don't support patients with clinical documents that exceed # characters limit. You might try excluding the progress notes.
diff --git a/articles/azure-health-insights/trial-matcher/get-started.md b/articles/azure-health-insights/trial-matcher/get-started.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: quickstart
-ms.date: 01/27/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/trial-matcher/inferences.md b/articles/azure-health-insights/trial-matcher/inferences.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
@@ -18,7 +18,8 @@ ms.author: behoorne
 The result of the Trial Matcher model includes a list of inferences made regarding the patient. For each trial that was queried for the patient, the model returns an indication of whether the patient appears eligible or ineligible for the trial. If the model concluded the patient is ineligible for a trial, it also provides a piece of evidence to support its conclusion (unless the ```evidence``` flag was set to false). 
 
 > [!NOTE] 
-> The examples below are based on API version: 2023-03-01-preview.
+> The examples in this article are based on API version: 2023-03-01-preview. There might be changes between
+API versions. For a specific API version, please use the reference to the REST API to see full description.
 
 ## Example model result
 ```json
diff --git a/articles/azure-health-insights/trial-matcher/integration-and-responsible-use.md b/articles/azure-health-insights/trial-matcher/integration-and-responsible-use.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 01/27/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
diff --git a/articles/azure-health-insights/trial-matcher/model-configuration.md b/articles/azure-health-insights/trial-matcher/model-configuration.md
@@ -7,7 +7,7 @@ author: iBoonZ
 manager: urieinav
 ms.service: azure-health-insights
 ms.topic: overview
-ms.date: 02/02/2023
+ms.date: 05/05/2024
 ms.author: behoorne
 ---
 
@@ -21,7 +21,8 @@ When you're matching patients to trials, you can define a list of filters to que
 - Specifying multiple values for the same filter category results in a trial set that is a union of the two sets.
 
 > [!NOTE]
-> The examples below are based on API version: 2023-03-01-preview. 
+> The examples in this article are based on API version: 2023-03-01-preview. There might be changes between
+API versions. For a specific API version, please use the reference to the REST API to see full description. 
 
 In the following configuration, the model queries trials that are in recruitment status ```recruiting``` or ```not yet recruiting```.
 
@@ -32,7 +33,7 @@ In the following configuration, the model queries trials that are in recruitment
 
 - Specifying multiple filter categories results in a trial set that is the combination of the sets.
 In the following case, only trials for diabetes that are recruiting in Illinois are queried.
-Leaving a category empty will not limit the trials by that category.
+Leaving a category empty is not limiting the trials by that category.
 
 ```json
 "registryFilters": [
@@ -91,7 +92,7 @@ Evidence is an indication of whether the model’s output should include evidenc
 ## Verbose
 Verbose is an indication of whether the model should return trial information. The default value is false. If set to True, the model returns trial information including ```Title```, ```Phase```, ```Type```, ```Recruitment status```, ```Sponsors```, ```Contacts```, and ```Facilities```.
 
-If you use [gradual matching](./trial-matcher-modes.md), it’s typically used in the last stage of the qualification process, before displaying trial results
+If you use [gradual matching](./trial-matcher-modes.md), verbose is used typically in the last stage of the qualification process, before displaying trial results.
 
 
 ```json
diff --git a/articles/azure-health-insights/trial-matcher/overview.md b/articles/azure-health-insights/trial-matcher/overview.md
diff --git a/articles/azure-health-insights/trial-matcher/patient-info.md b/articles/azure-health-insights/trial-matcher/patient-info.md
diff --git a/articles/azure-health-insights/trial-matcher/support-and-help.md b/articles/azure-health-insights/trial-matcher/support-and-help.md
diff --git a/articles/azure-health-insights/trial-matcher/transparency-note.md b/articles/azure-health-insights/trial-matcher/transparency-note.md
diff --git a/articles/azure-health-insights/trial-matcher/trial-matcher-modes.md b/articles/azure-health-insights/trial-matcher/trial-matcher-modes.md
diff --git a/articles/azure-health-insights/use-containers.md b/articles/azure-health-insights/use-containers.md
