From 174005488afbcdab70a35aab036bcd7afcaed013 Mon Sep 17 00:00:00 2001 From: John Sanders Date: Tue, 30 May 2023 16:02:15 -0700 Subject: [PATCH 1/8] Updated FAQ with common failures in README.md --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index e01dc36b2f..14c569190e 100644 --- a/README.md +++ b/README.md @@ -124,3 +124,10 @@ Once in the web app: If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237 If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. + +The three most common reasons this sample fails are: +1. The subscription (SubID) doesn't have access to the Azure OpenAI service. Please ensure the subID used in the access request proces, is the one you're coding with aka.ms/oai/access +2. You're attempting to create resources in regions not suported by Azure OpenAI (most commonly East US 2, instead of East US), or where the model you'retrying to use isn't enabled. See this matrix for what models are available in what regions aka.ms/oai/models +3. You've exceeded a quota, most often number of resources per region. See this link for quota nad limits aka.ms/oai/quotas +4. You've run the sample multipe times, and tried to delete the resources you've been creating, but are forgetting to hard delete them (Azure keeps resources for 48 hours unless you pruge from soft delete). +5. From 8dc27e0ec018a476c9b33f5568d7d7c01d9ab535 Mon Sep 17 00:00:00 2001 From: John Sanders Date: Tue, 30 May 2023 16:04:38 -0700 Subject: [PATCH 2/8] Update README.md with FAQs failure reasons --- README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 14c569190e..0658029201 100644 --- a/README.md +++ b/README.md @@ -125,9 +125,8 @@ If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backe If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. -The three most common reasons this sample fails are: +The most common reasons this sample fails are: 1. The subscription (SubID) doesn't have access to the Azure OpenAI service. Please ensure the subID used in the access request proces, is the one you're coding with aka.ms/oai/access 2. You're attempting to create resources in regions not suported by Azure OpenAI (most commonly East US 2, instead of East US), or where the model you'retrying to use isn't enabled. See this matrix for what models are available in what regions aka.ms/oai/models 3. You've exceeded a quota, most often number of resources per region. See this link for quota nad limits aka.ms/oai/quotas -4. You've run the sample multipe times, and tried to delete the resources you've been creating, but are forgetting to hard delete them (Azure keeps resources for 48 hours unless you pruge from soft delete). -5. +4. You've run the sample multipe times, and tried to delete the resources you've been creating, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) From 91bf774e7956cf33d926073d5e321fec0ffb0a66 Mon Sep 17 00:00:00 2001 From: John Sanders Date: Tue, 30 May 2023 18:40:07 -0700 Subject: [PATCH 3/8] Updated FAQ in README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 0658029201..151a9d3355 100644 --- a/README.md +++ b/README.md @@ -126,7 +126,7 @@ If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backe If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. The most common reasons this sample fails are: -1. The subscription (SubID) doesn't have access to the Azure OpenAI service. Please ensure the subID used in the access request proces, is the one you're coding with aka.ms/oai/access -2. You're attempting to create resources in regions not suported by Azure OpenAI (most commonly East US 2, instead of East US), or where the model you'retrying to use isn't enabled. See this matrix for what models are available in what regions aka.ms/oai/models -3. You've exceeded a quota, most often number of resources per region. See this link for quota nad limits aka.ms/oai/quotas -4. You've run the sample multipe times, and tried to delete the resources you've been creating, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) +1. The subscription (SubID) doesn't have access to the Azure OpenAI service. Please ensure the subID used in the access request process, is the one you're coding with aka.ms/oai/access +2. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions aka.ms/oai/models +3. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits aka.ms/oai/quotas +4. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) From 9f0d721bb78eee807d25381a9ee6ef5ffdaa6dc8 Mon Sep 17 00:00:00 2001 From: John Sanders Date: Thu, 1 Jun 2023 14:59:28 -0700 Subject: [PATCH 4/8] Updated FAQ in README.md --- README.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 151a9d3355..2a70c4d4c7 100644 --- a/README.md +++ b/README.md @@ -120,13 +120,10 @@ Once in the web app: ***Answer***: Chunking allows us to limit the amount of information we send to OpenAI due to token limits. By breaking up the content, it allows us to easily find potential chunks of text that we can inject into OpenAI. The method of chunking we use leverages a sliding window of text such that sentences that end one chunk will start the next. This allows us to reduce the chance of losing the context of the text. ### Troubleshooting - -If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237 - -If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. - The most common reasons this sample fails are: -1. The subscription (SubID) doesn't have access to the Azure OpenAI service. Please ensure the subID used in the access request process, is the one you're coding with aka.ms/oai/access -2. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions aka.ms/oai/models -3. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits aka.ms/oai/quotas +1. The subscription (AZURE_SUBSCRIPTION_ID) doesn't have access to the Azure OpenAI service. Please ensure the AZURE_SUBSCRIPTION_ID used in the access request process, is the one you're coding with aka.ms/oai/access +2. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/concepts/models#model-summary-table-and-region-availability) +3. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https:/aka.ms/oai/quotas](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits) 4. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) +1. If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237 +1. If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. From b1c91cd4628470a499d836392f9ed024d8750dc0 Mon Sep 17 00:00:00 2001 From: Anthony Shaw Date: Thu, 29 Jun 2023 14:08:09 +1000 Subject: [PATCH 5/8] Update readme with some markdown styling --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 2a70c4d4c7..866a5bbdf7 100644 --- a/README.md +++ b/README.md @@ -120,10 +120,17 @@ Once in the web app: ***Answer***: Chunking allows us to limit the amount of information we send to OpenAI due to token limits. By breaking up the content, it allows us to easily find potential chunks of text that we can inject into OpenAI. The method of chunking we use leverages a sliding window of text such that sentences that end one chunk will start the next. This allows us to reduce the chance of losing the context of the text. ### Troubleshooting + The most common reasons this sample fails are: -1. The subscription (AZURE_SUBSCRIPTION_ID) doesn't have access to the Azure OpenAI service. Please ensure the AZURE_SUBSCRIPTION_ID used in the access request process, is the one you're coding with aka.ms/oai/access -2. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/concepts/models#model-summary-table-and-region-availability) -3. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https:/aka.ms/oai/quotas](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits) -4. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) + +1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure the `AZURE_SUBSCRIPTION_ID` used in the access request process, is the one you're coding with aka.ms/oai/access + +1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/concepts/models#model-summary-table-and-region-availability) + +1. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https:/aka.ms/oai/quotas](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits) + +1. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) + 1. If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237 -1. If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. + +1. If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. From b53514d6a08294f43ad018d850c6039b0c8dd4de Mon Sep 17 00:00:00 2001 From: Anthony Shaw Date: Thu, 29 Jun 2023 14:11:03 +1000 Subject: [PATCH 6/8] Update links --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 866a5bbdf7..88718cf032 100644 --- a/README.md +++ b/README.md @@ -123,14 +123,14 @@ Once in the web app: The most common reasons this sample fails are: -1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure the `AZURE_SUBSCRIPTION_ID` used in the access request process, is the one you're coding with aka.ms/oai/access +1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure the `AZURE_SUBSCRIPTION_ID` used in the access request process, is the one you're coding with aka.ms/oai/access. -1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/concepts/models#model-summary-table-and-region-availability) +1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix for what models are available in what regions [https://aka.ms/oai/models](https://aka.ms/oai/models). -1. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https:/aka.ms/oai/quotas](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits) +1. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits [https://aka.ms/oai/quotas](https://aka.ms/oai/quotas). -1. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource) +1. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article: [https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal](https://learn.microsoft.com/en-us/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource). -1. If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: https://github.com/Azure/azure-dev/issues/1237 +1. If you see this error while running `azd deploy`: `read /tmp/azd1992237260/backend_env/lib64: is a directory`, then delete the `./app/backend/backend_env folder` and re-run the `azd deploy` command. This issue is being tracked here: [#1237](https://github.com/Azure/azure-dev/issues/1237). 1. If the web app fails to deploy and you receive a '404 Not Found' message in your browser, run 'azd deploy'. From 68c94c791ba02d147c1e5d316bd1ec6fde926692 Mon Sep 17 00:00:00 2001 From: Pamela Fox Date: Thu, 20 Jul 2023 07:12:08 -0700 Subject: [PATCH 7/8] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3b7605238e..9e7620768d 100644 --- a/README.md +++ b/README.md @@ -144,13 +144,13 @@ To upload more PDFs, put them in the data/ folder and run `./scripts/prepdocs.sh Here are the most common failure scenarios and solutions: -1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure the `AZURE_SUBSCRIPTION_ID` used in the access request process is the one you're coding with aka.ms/oai/access. +1. The subscription (`AZURE_SUBSCRIPTION_ID`) doesn't have access to the Azure OpenAI service. Please ensure `AZURE_SUBSCRIPTION_ID` matches the ID specified in the [OpenAI access request process](https://aka.ms/oai/access). -1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2, instead of East US), or where the model you're trying to use isn't enabled. See this matrix of which models are available in which regions: [https://aka.ms/oai/models](https://aka.ms/oai/models) +1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2 instead of East US), or where the model you're trying to use isn't enabled. See [this matrix of model availability](https://aka.ms/oai/models). -1. You've exceeded a quota, most often number of resources per region. See this link for quotas and limits: [https://aka.ms/oai/quotas](https://aka.ms/oai/quotas) +1. You've exceeded a quota, most often number of resources per region. See [this article on quotas and limits](https://aka.ms/oai/quotas) -1. You've run the sample multiple times, and deleted the resources you've been creating each time, but are forgetting to purge them (Azure keeps resources for 48 hours unless you purge from soft delete). So you're getting same resource name not allowed conflicts. See this article [about purging resources](https://learn.microsoft.com/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource). +1. You're getting "same resource name not allowed" conflicts. That's likely because you've run the sample multiple times and deleted the resources you've been creating each time, but are forgetting to purge them. Azure keeps resources for 48 hours unless you purge from soft delete. See [this article on purging resources](https://learn.microsoft.com/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource). -1. The web app fails to deploy and you receive a '404 Not Found' message in your browser. First, try running 'azd deploy'. If you still encounter errors with the deployed app, consult these [tips for debugging Flask app deployments](http://blog.pamelafox.org/2023/06/tips-for-debugging-flask-deployments-to.html) +1. After running `azd up` and visiting the website, you see a '404 Not Found' in the browser. First, try running `azd deploy`. If you still encounter errors with the deployed app, consult these [tips for debugging Flask app deployments](http://blog.pamelafox.org/2023/06/tips-for-debugging-flask-deployments-to.html) and file an issue if the error logs don't help you resolve the issue. From 567f52b35e6f95e6f9aa29d99125bafcdc1e7cda Mon Sep 17 00:00:00 2001 From: Pamela Fox Date: Thu, 20 Jul 2023 07:13:23 -0700 Subject: [PATCH 8/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9e7620768d..f0a92e066a 100644 --- a/README.md +++ b/README.md @@ -148,7 +148,7 @@ Here are the most common failure scenarios and solutions: 1. You're attempting to create resources in regions not enabled for Azure OpenAI (e.g. East US 2 instead of East US), or where the model you're trying to use isn't enabled. See [this matrix of model availability](https://aka.ms/oai/models). -1. You've exceeded a quota, most often number of resources per region. See [this article on quotas and limits](https://aka.ms/oai/quotas) +1. You've exceeded a quota, most often number of resources per region. See [this article on quotas and limits](https://aka.ms/oai/quotas). 1. You're getting "same resource name not allowed" conflicts. That's likely because you've run the sample multiple times and deleted the resources you've been creating each time, but are forgetting to purge them. Azure keeps resources for 48 hours unless you purge from soft delete. See [this article on purging resources](https://learn.microsoft.com/azure/cognitive-services/manage-resources?tabs=azure-portal#purge-a-deleted-resource).