Skip to content

Commit 614d421

Browse files
committed
acrolinx fixes
1 parent 556c8ee commit 614d421

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

articles/ai-services/openai/how-to/on-your-data-best-practices.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -74,11 +74,11 @@ If you aren't seeing the correct document chunks in step 1, then you need to dig
7474

7575
1. It's possible that your index fields are not correctly mapped, meaning retrieval might not work well. This is particularly relevant if you're using a pre-existing data source (you did not create the index using the Studio or offline scripts available on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts). For more information on mapping index fields, see the [how-to article](../concepts/use-your-data.md?tabs=ai-search#index-field-mapping).
7676

77-
1. It's possible that the intent generation step is not working well. In the API response, check the `intents` fields in the `tool` message.
77+
1. It's possible that the intent generation step isn't working well. In the API response, check the `intents` fields in the `tool` message.
7878

79-
- Some models are known to not work very well for intent generation. For example, if you're using the GPT-35-turbo-1106 model version, consider using a later model, such as gpt-35-turbo (0125) or GPT-4-1106-preview.
79+
- Some models are known to not work well for intent generation. For example, if you're using the GPT-35-turbo-1106 model version, consider using a later model, such as gpt-35-turbo (0125) or GPT-4-1106-preview.
8080

81-
1. Do you have semi-structured data in your documents, such as a lot of tables? There might be an **ingestion issue**. Your data might need special handling during ingestion.
81+
1. Do you have semi-structured data in your documents, such as numerous tables? There might be an **ingestion issue**. Your data might need special handling during ingestion.
8282
- If the file format is PDF, we offer optimized ingestion for tables using the offline scripts available on [GitHub](https://github.com/microsoft/sample-app-aoai-chatGPT/tree/main/scripts). to use the scripts, you need to have a [Document Intelligence](../../document-intelligence/overview.md) resource and use the `Layout` [model](../../document-intelligence/concept-layout.md). You can also:
8383
- Adjust your chunk size to make sure your largest table fits within the specified [chunk size](../concepts/use-your-data.md#chunk-size-preview).
8484

@@ -88,15 +88,15 @@ If you aren't seeing the correct document chunks in step 1, then you need to dig
8888

8989
## Frequently encountered issues
9090

91-
**Issue 1**: _The model responds with "The requested information is not present in the retrieved documents. Please try a different query or topic" even though that's not the case._
91+
**Issue 1**: _The model responds with "The requested information isn't present in the retrieved documents. Please try a different query or topic" even though that's not the case._
9292

9393
See [Step 3](#step-3-check-the-rest-of-the-funnel) in the above debugging process.
9494

95-
**Issue 2**: _The response is from my data, but it is not relevant/correct in the context of the question._
95+
**Issue 2**: _The response is from my data, but it isn't relevant/correct in the context of the question._
9696

9797
See the debugging process starting at [Step 1](#step-1-check-for-retrieval-issues).
9898

99-
**Issue 3**: _The role information / system message is not being followed by the model._
99+
**Issue 3**: _The role information / system message isn't being followed by the model._
100100

101101
- Instructions in the role information might contradict with our [Responsible AI guidelines](/legal/cognitive-services/openai/overview?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext), in which case it won't likely be followed.
102102

@@ -126,7 +126,7 @@ See the debugging process starting at [Step 1](#step-1-check-for-retrieval-issue
126126
- Consider increasing `strictness`.
127127
- Add the following instruction in your role information / system message:
128128
- _"You are also allowed to respond to questions based on the retrieved documents."_
129-
- The `inscope` parameter is not a hard switch, but setting it to `true` encourages the model to stay restricted.
129+
- The `inscope` parameter isn't a hard switch, but setting it to `true` encourages the model to stay restricted.
130130

131131
**Issue 7**: _The response is correct but occasionally missing document references/citations._
132132
- Consider upgrading to a GPT-4 model if you're already not using it. GPT-4 is generally more consistent with citation generation.

0 commit comments

Comments
 (0)