prev i

Author: yuantao-wang

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

@@ -383,40 +383,8 @@ You can send a streaming request using the `stream` parameter, allowing data to
 
 #### Conversation history for better results
 
-When you chat with a model, providing a history of the chat will help the model return higher quality results. 
+When you chat with a model, providing a history of the chat will help the model return higher quality results. You don't need to include the [`context` property](../references/on-your-data.md#context) of the assistant messages since 2024. See [example from the API reference](../references/on-your-data.md#examples).
 
-```json
-{
-    "dataSources": [
-        {
-            "type": "AzureCognitiveSearch",
-            "parameters": {
-                "endpoint": "'$AZURE_AI_SEARCH_ENDPOINT'",
-                "key": "'$AZURE_AI_SEARCH_API_KEY'",
-                "indexName": "'$AZURE_AI_SEARCH_INDEX'"
-            }
-        }
-    ],
-    "messages": [
-        {
-            "role": "user",
-            "content": "What are the differences between Azure Machine Learning and Azure AI services?"
-        },
-        {
-            "role": "tool",
-            "content": "{\"citations\": [{\"content\": \"title: Azure AI services and Machine Learning\\ntitleSuffix: Azure AI services\\ndescription: Learn where Azure AI services fits in with other Azure offerings for machine learning.\\nAzure AI services and machine learning\\nAzure AI services provides machine learning capabilities to solve general problems such as...\\n \"articles\\\\cognitive-services\\\\cognitive-services-and-machine-learning.md\", \"url\": null, \"metadata\": {\"chunking\": \"orignal document size=1018. Scores=0.32200050354003906 and 1.2880020141601562.Org Highlight count=115.\"}, \"chunk_id\": \"0\"}], \"intent\": \"[\\\"What are the differences between Azure Machine Learning and Azure AI services?\\\"]\"}"
-        },
-        {
-            "role": "assistant",
-            "content": " \nAzure Machine Learning is a product and service tailored for data scientists to build, train, and deploy machine learning models [doc1]..."
-        },
-        {
-            "role": "user",
-            "content": "How do I use Azure machine learning?"
-        }
-    ]
-}
-```
 
 ## Token usage estimation for Azure OpenAI On Your Data
 

articles/ai-services/openai/references/on-your-data.md

@@ -41,7 +41,6 @@ The request body inherits the same schema of chat completions API request. This
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
-| `messages` | [ChatMessage](#chat-message)[] | True | The array of messages to generate chat completions for, in the chat format. The [request chat message](#chat-message) has a `context` property, which is added for Azure OpenAI On Your Data.|
 | `data_sources` | [DataSource](#data-source)[] | True | The configuration entries for Azure OpenAI On Your Data. There must be exactly one element in the array. If `data_sources` is not provided, the service uses chat completions model directly, and does not use Azure OpenAI On Your Data.|
 
 ## Response body
@@ -50,17 +49,17 @@ The response body inherits the same schema of chat completions API response. The
 
 ## Chat message
 
-In both request and response, when the chat message `role` is `assistant`, the chat message schema inherits from the chat completions assistant chat message, and is extended with the property `context`.
+The response assistant message schema inherits from the chat completions assistant [chat message](../reference.md#chatmessage), and is extended with the property `context`.
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
-| `context` | [Context](#context) | False | Represents the incremental steps performed by the Azure OpenAI On Your Data while processing the request, including the detected search intent and the retrieved documents. |
+| `context` | [Context](#context) | False | Represents the incremental steps performed by the Azure OpenAI On Your Data while processing the request, including the retrieved documents. |
 
 ## Context
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
-| `citations` | [Citation](#citation)[] | False | The data source retrieval result, used to generate the assistant message in the response.|
-| `intent` | string | False | The detected intent from the chat history, used to pass to the next turn to carry over the context.|
+| `citations` | [Citation](#citation)[] | False | The data source retrieval result, used to generate the assistant message in the response. Clients can render references from the citations. |
+| `intent` | string | False | The detected intent from the chat history. This is deprecated. |
 
 ## Citation
 
@@ -84,7 +83,7 @@ This list shows the supported data sources.
 
 ## Examples
 
-This example shows how to pass context with conversation history for better results.
+This example shows how to pass conversation history for better results.
 
 Prerequisites:
 * Configure the role assignments from Azure OpenAI system assigned managed identity to Azure search service. Required roles: `Search Index Data Reader`, `Search Service Contributor`.
@@ -131,9 +130,6 @@ completion = client.chat.completions.create(
         {
             "role": "assistant",
             "content": "DRI stands for Directly Responsible Individual of a service. Which service are you asking about?",
-            "context": {
-                "intent": "[\"Who is DRI?\", \"What is the meaning of DRI?\", \"Define DRI\"]"
-            }
         },
         {
             "role": "user",