Skip to content

Commit 50126c2

Browse files
committed
init
1 parent 7a8b13c commit 50126c2

File tree

8 files changed

+29
-96
lines changed

8 files changed

+29
-96
lines changed

articles/machine-learning/prompt-flow/get-started-prompt-flow.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,6 @@ This article walks you through the main user journey of using Prompt flow in Azu
2626
> Prompt flow is **not supported** in the workspace which has data isolation enabled. The enableDataIsolation flag can only be set at the workspace creation phase and can't be updated.
2727
>
2828
>Prompt flow is **not supported** in the project workspace which was created with a workspace hub. The workspace hub is a private preview feature.
29-
>
30-
>Prompt flow is **not supported** in workspaces that enable managed VNet. Managed VNet is a private preview feature.
31-
>
32-
>Prompt flow is **not supported** if you secure your Azure AI services account(Azure openAI, Azure cognitive search, Azure content safety) with virtual networks. If you want to use these as connection in prompt flow please allow access from all networks.
3329
3430
In your Azure Machine Learning workspace, you can enable Prompt flow by turning on **Build AI solutions with Prompt flow** in the **Manage preview features** panel.
3531

articles/machine-learning/prompt-flow/how-to-create-manage-runtime.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,6 @@ Go to runtime detail page and select update button at the top. You can change ne
108108
> [!NOTE]
109109
> If you used a custom environment, you need to rebuild it using latest prompt flow image first, and then update your runtime with the new custom environment.
110110
111-
## Troubleshooting guide for runtime
112111

113112
### Common issues
114113

articles/machine-learning/prompt-flow/how-to-customize-environment-runtime.md

Lines changed: 0 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -174,87 +174,6 @@ Follow [this document to add custom application](../how-to-create-compute-instan
174174

175175
:::image type="content" source="./media/how-to-customize-environment-runtime/runtime-creation-add-custom-application-ui.png" alt-text="Screenshot of compute showing custom applications. " lightbox = "./media/how-to-customize-environment-runtime/runtime-creation-add-custom-application-ui.png":::
176176

177-
## Create managed online deployment that can be used as Prompt flow runtime (deprecated)
178-
179-
> [!IMPORTANT]
180-
> Managed online endpoint/deployment as runtime is **deprecated**. Please use [Migrate guide for managed online endpoint/deployment runtime](./migrate-managed-inference-runtime.md).
181-
182-
### Create managed online deployment that can be used as Prompt flow runtime via CLI v2
183-
184-
Learn more about [deploy and score a machine learning model by using an online endpoint](../how-to-deploy-online-endpoints.md)
185-
186-
#### Create managed online endpoint
187-
188-
To define a managed online endpoint, you can use the following yaml template. Make sure to replace the `ENDPOINT_NAME` with the desired name for your endpoint.
189-
190-
```yaml
191-
$schema: https://azuremlschemas.azureedge.net/latest/managedOnlineEndpoint.schema.json
192-
name: <ENDPOINT_NAME>
193-
description: this is a sample promptflow endpoint
194-
auth_mode: key
195-
```
196-
197-
Use following CLI command `az ml online-endpoint create -f <yaml_file> -g <resource_group> -w <workspace_name>` to create managed online endpoint. To learn more, see [Deploy and score a machine learning model by using an online endpoint](../how-to-deploy-online-endpoints.md).
198-
199-
#### Create Prompt flow runtime image config file
200-
201-
To configure your Prompt flow runtime, place the following config file in your model folder. This config file provides the necessary information for the runtime to work properly.
202-
203-
For the `mt_service_endpoint` parameter, follow this format: `https://<region>.api.azureml.ms`. For example, if your region is eastus, then your service endpoint should be `https://eastus.api.azureml.ms`
204-
205-
```yaml
206-
storage:
207-
storage_account: <WORKSPACE_LINKED_STORAGE>
208-
deployment:
209-
subscription_id: <SUB_ID>
210-
resource_group: <RG_NAME>
211-
workspace_name: <WORKSPACE_NAME>
212-
endpoint_name: <ENDPOINT_NAME>
213-
deployment_name: blue
214-
mt_service_endpoint: <PROMPT_FLOW_SERVICE_ENDPOINT>
215-
```
216-
217-
#### Create managed online endpoint
218-
219-
You need to replace the following placeholders with your own values:
220-
221-
- `ENDPOINT_NAME`: the name of the endpoint you created in the previous step
222-
- `PRT_CONFIG_FILE`: the name of the config file that contains the port and runtime settings. Include the parent model folder name, for example, if model folder name is `model`, then the config file name should be `model/config.yaml`.
223-
- `IMAGE_NAME` to name of your own image, for example: `mcr.microsoft.com/azureml/promptflow/promptflow-runtime:<newest_version>`, you can also follow [Customize environment with docker context for runtime](#customize-environment-with-docker-context-for-runtime) to create your own environment.
224-
225-
```yaml
226-
$schema: https://azuremlschemas.azureedge.net/latest/managedOnlineDeployment.schema.json
227-
name: blue
228-
endpoint_name: <ENDPOINT_NAME>
229-
type: managed
230-
model:
231-
path: ./
232-
type: custom_model
233-
instance_count: 1
234-
# 4core, 32GB
235-
instance_type: Standard_E4s_v3
236-
request_settings:
237-
max_concurrent_requests_per_instance: 10
238-
request_timeout_ms: 90000
239-
environment_variables:
240-
PRT_CONFIG_FILE: <PRT_CONFIG_FILE>
241-
environment:
242-
name: promptflow-runtime
243-
image: <IMAGE_NAME>
244-
inference_config:
245-
liveness_route:
246-
port: 8080
247-
path: /health
248-
readiness_route:
249-
port: 8080
250-
path: /health
251-
scoring_route:
252-
port: 8080
253-
path: /score
254-
255-
```
256-
257-
Use following CLI command `az ml online-deployment create -f <yaml_file> -g <resource_group> -w <workspace_name>` to create managed online deployment that can be used as a Prompt flow runtime.
258177

259178
## Next steps
260179

articles/machine-learning/prompt-flow/how-to-deploy-for-real-time-inference.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,11 @@ If you didn't complete the tutorial, you need to build a flow. Testing the flow
4545

4646
We'll use the sample flow **Web Classification** as example to show how to deploy the flow. This sample flow is a standard flow. Deploying chat flows is similar. Evaluation flow doesn't support deployment.
4747

48+
## Define the environment used by deployment
49+
When you deploy prompt flow to managed online endpoint in UI. You need define the environment used by this flow. By default, it will use the latest prompt image version. You can specify extra packages you needed in `requirements.txt`. You can find `requirements.txt` in the root folder of your flow folder, which is system generated file.
50+
51+
:::image type="content" source="./media/how-to-deploy-for-real-time-inference/requirements-text.png" alt-text="Screenshot of Web requiremnts-text. " lightbox = "./media/how-to-deploy-for-real-time-inference/requirements-text.png":::
52+
4853
## Create an online endpoint
4954

5055
Now that you have built a flow and tested it properly, it's time to create your online endpoint for real-time inference.

articles/machine-learning/prompt-flow/how-to-secure-prompt-flow.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -54,10 +54,12 @@ Workspace managed virtual network is the recommended way to support network isol
5454
5555
:::image type="content" source="./media/how-to-secure-prompt-flow/outbound-rule-non-azure-resources.png" alt-text="Screenshot of user defined outbound rule for non Azure resource." lightbox = "./media/how-to-secure-prompt-flow/outbound-rule-non-azure-resources.png":::
5656
57+
4. In workspace which enable managed VNet, you can only deployment to managed online endpoint. You can follow [Secure your managed online endpoints with network isolation](../how-to-secure-kubernetes-inferencing-environment.md) to secure your managed online endpoint.
5758
## Secure prompt flow use your own virtual network
5859
5960
- To set up Azure Machine Learning related resources as private, see [Secure workspace resources](../how-to-secure-workspace-vnet.md).
6061
- Meanwhile, you can follow [private Azure Cognitive Services](../../ai-services/cognitive-services-virtual-networks.md) to make them as private.
62+
- If you want to deploy prompt flow in workspace which secured by your own virtual network, you can deploy it to AKS cluster which is in the same virtual network. You can follow [Secure your RAG workflows with network isolation](../how-to-secure-rag-workflows.md) to secure your AKS cluster.
6163
- You can either create private endpoint to the same virtual network or leverage virtual network peering to make them communicate with each other.
6264
6365
## Limitations
@@ -66,15 +68,10 @@ Workspace managed virtual network is the recommended way to support network isol
6668
- Workspace hub / lean workspace and AI studio don't support bring your own virtual network.
6769
- Managed online endpoint only supports workspace managed virtual network. If you want to use your own virtual network, you may need one workspace for prompt flow authoring with your virtual network and another workspace for prompt flow deployment using managed online endpoint with workspace managed virtual network.
6870
69-
## FAQ
70-
71-
### Why I can't create or upgrade my flow when I disable public network access of storage account?
72-
Prompt flow rely on fileshare to store snapshot of flow. Prompt flow didn't support private storage account now. Here are some workarounds you can try:
73-
- Make the storage account as public access enabled if there is no security concern.
74-
- If you are only use UI to authoring promptflow, you can add following flights (flight=PromptFlowCodeFirst=false) to use our old UI.
75-
- You can use our CLI/SDK to authoring promptflow, CLI/SDK authong didn't rely on fileshare. See [Integrate Prompt Flow with LLM-based application DevOps ](how-to-integrate-with-llm-app-devops.md).
76-
7771
## Next steps
7872
7973
- [Secure workspace resources](../how-to-secure-workspace-vnet.md)
80-
- [Workspace managed network isolation](../how-to-managed-network.md)
74+
- [Workspace managed network isolation](../how-to-managed-network.md)
75+
- [Secure Azure Kubernetes Service inferencing environment](../how-to-secure-online-endpoint.md)
76+
- [Secure your managed online endpoints with network isolation](../how-to-secure-kubernetes-inferencing-environment.md)
77+
- [Secure your RAG workflows with network isolation](../how-to-secure-rag-workflows.md)
65.2 KB
Loading
61.9 KB
Loading

articles/machine-learning/prompt-flow/tools-reference/troubleshoot-guidance.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,4 +41,21 @@ To resolve the issue, you have two options:
4141

4242
- **Option 2**
4343
- Update your runtime to latest version.
44-
- Remove the old tool and re-create a new tool.
44+
- Remove the old tool and re-create a new tool.
45+
46+
## Why I can't create or upgrade my flow when I disable public network access of storage account?
47+
Prompt flow rely on fileshare to store snapshot of flow. Prompt flow didn't support private storage account now. Here are some workarounds you can try:
48+
- Make the storage account as public access enabled if there is no security concern.
49+
- If you are only using UI to authoring promptflow, you can add following flights (flight=PromptFlowCodeFirst=false) to use our old UI.
50+
- You can use our CLI/SDK to authoring promptflow, CLI/SDK authong didn't rely on fileshare. See [Integrate Prompt Flow with LLM-based application DevOps ](../how-to-integrate-with-llm-app-devops.md).
51+
52+
53+
## Why I can't upgrade my old flow?
54+
Prompt flow rely on fileshare to store snapshot of flow. If fileshare have some issue, you may encounter this issue. Here are some workarounds you can try:
55+
- If you are using private storage account, please see [Why I can't create or upgrade my flow when I disable public network access of storage account?](#why-i-cant-create-or-upgrade-my-flow-when-i-disable-public-network-access-of-storage-account)
56+
- If the storage account is enabled public access, please check whether there are datastore named `workspaceworkingdirectory` in your workspace, it should be fileshare type.
57+
![workspaceworkingdirectory](../media/faq/workingdirectory.png)
58+
- If you didn't get this datastore, you need add it in your workspace.
59+
- Create fileshare with name `code-391ff5ac-6576-460f-ba4d-7e03433c68b6`
60+
- Create data store with name `workspaceworkingdirectory` . See [Create datastores](../../how-to-datastore.md)
61+
- If you have `workspaceworkingdirectory` datastore but its type is `blob` instead of `fileshare`, please create new workspace and use storage didn't enable hierarchical namespaces ADLS Gen2 as workspace default storage account. See [Create workspace](../../how-to-manage-workspace.md#create-a-workspace)

0 commit comments

Comments
 (0)