Skip to content

Commit bba13ed

Browse files
committed
Minor updates to improve Acrolinx score
1 parent 754a613 commit bba13ed

File tree

3 files changed

+12
-12
lines changed

3 files changed

+12
-12
lines changed

articles/cognitive-services/openai/concepts/models.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,7 @@ Similar to text search embeddings, there are two types: one for embedding code s
118118
|---|---|
119119
| Code search and relevance | code-search-ada-code-001, <br> code-search-ada-text-001, <br> code-search-babbage-code-001, <br> code-search-babbage-text-001 |
120120

121-
When using our embedding models, please keep in mind their limitations and risks.
121+
When using our embedding models, keep in mind their limitations and risks.
122122

123123
## Finding the right model
124124

articles/cognitive-services/openai/how-to/embeddings.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ An embedding is a special format of data representation that can be easily utili
2020

2121
## How to get embeddings
2222

23-
To obtain an embedding vector for a piece of text we make a request to the embeddings endpoint as shown in the following code snippets:
23+
To obtain an embedding vector for a piece of text, we make a request to the embeddings endpoint as shown in the following code snippets:
2424

2525
```console
2626
curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings?api-version=2022-06-01-preview\
@@ -33,19 +33,19 @@ curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYM
3333

3434
### Verify inputs don't exceed the maximum length
3535

36-
The maximum length of input text for our embedding models are 2048 tokens (approximately equivalent to around 2-3 pages of text). You should verify that your inputs don't exceed this limit before making a request.
36+
The maximum length of input text for our embedding models is 2048 tokens (equivalent to around 2-3 pages of text). You should verify that your inputs don't exceed this limit before making a request.
3737

3838
### Choose the best model for your task
3939

40-
For the search models you can obtain embeddings in two ways. The `<search_model>-doc` model is used for longer pieces of text (to be searched over) and the `<search_model>-query` model is used for shorter pieces of text, typically queries or class labels in zero shot classification. You can read more about all of the Embeddings models in our [Models](../concepts/models.md) guide.
40+
For the search models, you can obtain embeddings in two ways. The `<search_model>-doc` model is used for longer pieces of text (to be searched over) and the `<search_model>-query` model is used for shorter pieces of text, typically queries or class labels in zero shot classification. You can read more about all of the Embeddings models in our [Models](../concepts/models.md) guide.
4141

4242
### Replace newlines with a single space
4343

44-
Unless you are embedding code, we suggest replacing newlines (\n) in your input with a single space, as we have observed inferior results when newlines are present.
44+
Unless you're embedding code, we suggest replacing newlines (\n) in your input with a single space, as we have observed inferior results when newlines are present.
4545

4646
## Limitations & risks
4747

48-
Our embedding models may be unreliable or pose social risks in certain cases, and may cause harm in the absence of mitigations. Please review our Responsible AI content for more information on how to approach their use responsibly.
48+
Our embedding models may be unreliable or pose social risks in certain cases, and may cause harm in the absence of mitigations. Review our Responsible AI content for more information on how to approach their use responsibly.
4949

5050
## Next steps
5151

articles/cognitive-services/openai/includes/studio.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ keywords:
1414
## Prerequisites
1515

1616
- An Azure subscription - <a href="https://azure.microsoft.com/free/cognitive-services" target="_blank">Create one for free</a>
17-
- Access granted to service in the desired Azure subscription. This service is currently invite only. You can fill out a new use case request here: <a href="https://aka.ms/oai/access" target="_blank">https://aka.ms/oai/access</a>
18-
- An Azure OpenAI Service resource with a model deployed. If you don't have a resource/model the process is documented in our [resource deployment guide](../how-to/create-resource.md)
17+
- Access granted to service in the desired Azure subscription. Currently, this service is available only by invitation. You can fill out a new use case request here: <a href="https://aka.ms/oai/access" target="_blank">https://aka.ms/oai/access</a>
18+
- An Azure OpenAI Service resource with a model deployed. If you don't have a resource/model, the process is documented in our [resource deployment guide](../how-to/create-resource.md)
1919

2020
## Go to the Azure OpenAI Studio
2121

@@ -27,22 +27,22 @@ You'll first land on our main page for the Azure OpenAI Studio and from here you
2727

2828
:::image type="content" source="../media/quickstarts/studio-start.png" alt-text="Screenshot of the landing page of the Azure OpenAI Studio with sections highlighted." lightbox="../media/quickstarts/studio-start.png":::
2929

30-
- Resources without a deployment will be prompted to create one. This is required to be able to inference with your models
30+
- Resources without a deployment will be prompted to create one. A deployment is required to be able to inference with your models
3131
- Get started with a few simple examples that demonstrate the capabilities of the service
3232
- Navigate to different parts of the Studio including the **Playground** for experimentation and our fine-tuning workflow
3333
- Find quick links to other helpful resources like documentation and community forums
3434

35-
From here, select the **create new deployment** button in the banner at the top. If you don't see this, you already have a deployment and can proceed to the 'playground' step.
35+
From here, select the **create new deployment** button in the banner at the top. If you don't see this button, you already have a deployment and can proceed to the [Playground](#playground) step.
3636

3737
## Deployments
3838

39-
Before you can generate text or inference, you need to deploy a model. This is done by clicking the **create new deployment** on the deployments page. From here you can select from one of our many available models. For getting started we recommend `text-davinci-002` for users in South Central and `text-davinci-001` for users in West Europe (`text-davinci-002` isn't available in this region).
39+
Before you can generate text or inference, you need to deploy a model by clicking the **create new deployment** button on the deployments page. From here you can select from one of our many available models. For getting started we recommend selecting the `text-davinci-002` model.
4040

4141
Once this is complete, select the 'Playground' button on the left nav to start experimenting.
4242

4343
## Playground
4444

45-
The best way to start exploring completions is through our Playground. It's simply a text box where you can submit a prompt to generate a completion. From this page you can easily iterate and experiment with the capabilities. The following is an overview of the features available to you on this page:
45+
The best way to start exploring completions is through our Playground. It's simply a text box where you can submit a prompt to generate a completion. From this page, you can easily iterate and experiment with the capabilities. The following list is an overview of the features available to you on this page:
4646

4747
:::image type="content" source="../media/quickstarts/playground-load.png" alt-text="Screenshot of the playground page of the Azure OpenAI Studio with sections highlighted." lightbox="../media/quickstarts/playground-load.png":::
4848

0 commit comments

Comments
 (0)