Skip to content

Commit 00703cf

Browse files
committed
adding note, removing screenshot, ai studio mentions
1 parent 061952d commit 00703cf

File tree

1 file changed

+12
-10
lines changed

1 file changed

+12
-10
lines changed

articles/ai-services/openai/how-to/assistants-logic-apps.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ recommendations: false
1414

1515
# Call Azure Logic apps as functions using Azure OpenAI Assistants
1616

17+
> [!NOTE]
18+
> This functionality is currently only available in Azure OpenAI Studio.
19+
1720
[Azure Logic Apps](https://azure.microsoft.com/products/logic-apps) is an integration platform in Azure that allows you to build applications and automation workflows with low code tools enabling developer productivity and faster time to market. By using the visual designer and selecting from hundreds of prebuilt connectors, you can quickly build a workflow that integrates and manages your apps, data, services, and systems.
1821

1922
Azure Logic Apps is fully managed by Microsoft Azure, which frees you from worrying about hosting, scaling, managing, monitoring, and maintaining solutions built with these services. When you use these capabilities to create [serverless](../../../logic-apps/logic-apps-overview.md) apps and solutions, you can just focus on the business logic and functionality. These services automatically scale to meet your needs, make automation workflows faster, and help you build robust cloud apps using little to no code.
@@ -28,7 +31,7 @@ The Assistants playground enumerates and lists all the workflows in your subscri
2831
* [Request trigger](../../../connectors/connectors-native-reqres.md?tabs=consumption): Function calling requires a REST-based API. Logic Apps with a request trigger provides a REST endpoint. Therefore only workflows with a request trigger are supported for function calling.
2932
* Schema: The workflows you want to use for function calling should have a JSON schema describing the inputs and expected outputs. Using Logic Apps you can streamline and provide schema in the trigger, which would be automatically imported as a function definition.
3033

31-
If you already have workflows with above three requirements, you should be able to use them in AI Studio and invoke them via user prompts.
34+
If you already have workflows with above three requirements, you should be able to use them in Azure OpenAI Studio and invoke them via user prompts.
3235
If you do not have existing workflows, you can follow the steps in this article to create them. There are two primary steps:
3336
1. [Create a Logic App on Azure portal](#create-logic-apps-workflows-for-function-calling).
3437
2. [Import your Logic Apps workflows as a function in the Assistants Playground](#import-your-logic-apps-workflows-as-functions).
@@ -47,7 +50,7 @@ Here are the steps to create a new Logic Apps workflow for function calling.
4750
1. After Azure successfully deploys your logic app resource, select **Go to resource**. Or, find and select your logic app resource by typing the name in the Azure search box.
4851
1. Open the Logic Apps workflow in designer. Select Development Tools + Logic app designer. This opens your empty workflow in designer. Or you select Blank Logic App from templates
4952
1. Now you're ready to add one more step in the workflow. A workflow always starts with a single trigger, which specifies the condition to meet before running any subsequent actions in the workflow.
50-
1. Your workflow is required to have a Request trigger to generate a REST endpoint, and a response action to return the response to AI Studio when this workflow is invoked.
53+
1. Your workflow is required to have a Request trigger to generate a REST endpoint, and a response action to return the response to Azure OpenAI Studio when this workflow is invoked.
5154
1. Add a trigger [(Request)](../../../connectors/connectors-native-reqres.md?tabs=consumption)
5255

5356
Select **Add a trigger** and then search for request trigger. Select the **When a HTTP request is received** operation.
@@ -58,7 +61,7 @@ Here are the steps to create a new Logic Apps workflow for function calling.
5861

5962
:::image type="content" source="..\media\how-to\assistants\logic-apps\create-logic-app-2.png" alt-text="A screenshot showing the option to provide a JSON schema." lightbox="..\media\how-to\assistants\logic-apps\create-logic-app-2.png":::
6063

61-
Here is an example of the request schema. You can add a description for your workflow in the comment box. This is imported by AI Studio as the function description.
64+
Here is an example of the request schema. You can add a description for your workflow in the comment box. This is imported by Azure OpenAI Studio as the function description.
6265

6366
:::image type="content" source="..\media\how-to\assistants\logic-apps\create-logic-app-3.png" alt-text="A screenshot showing an example request schema." lightbox="..\media\how-to\assistants\logic-apps\create-logic-app-3.png":::
6467

@@ -74,17 +77,16 @@ Here are the steps to create a new Logic Apps workflow for function calling.
7477

7578
:::image type="content" source="..\media\how-to\assistants\logic-apps\create-logic-app-6.png" alt-text="A screenshot showing the location property." lightbox="..\media\how-to\assistants\logic-apps\create-logic-app-6.png":::
7679

77-
1. Configure the [response](../../../connectors/connectors-native-reqres.md#add-a-response-action). The workflow needs to return the response back to AI Studio. This is done using Response action.
80+
1. Configure the [response](../../../connectors/connectors-native-reqres.md#add-a-response-action). The workflow needs to return the response back to Azure OpenAI Studio . This is done using Response action.
7881

7982
:::image type="content" source="..\media\how-to\assistants\logic-apps\create-logic-app-7.png" alt-text="A screenshot showing the response action." lightbox="..\media\how-to\assistants\logic-apps\create-logic-app-7.png":::
8083

8184
In the response action, you can pick the output from any of the prior steps. You can optionally also provide a JSON schema if you want to return the output in a specific format.
8285

8386
:::image type="content" source="..\media\how-to\assistants\logic-apps\create-logic-app-7.png" alt-text="A screenshot showing the comment box to specify a JSON schema." lightbox="..\media\how-to\assistants\logic-apps\create-logic-app-7.png":::
8487

85-
1. The workflow is now ready. In AI Studio, you can import this function using the **Add function** feature in the Assistants playground.
88+
1. The workflow is now ready. In Azure OpenAI Studio , you can import this function using the **Add function** feature in the Assistants playground.
8689

87-
:::image type="content" source="..\media\how-to\assistants\logic-apps\assistants-playground-add-function.png" alt-text="A screenshot showing the Assistant playground." lightbox="..\media\how-to\assistants\logic-apps\assistants-playground-add-function.png":::
8890

8991
## Import your Logic Apps workflows as functions
9092

@@ -121,11 +123,11 @@ You can confirm the invocation by looking at the logs as well as your [workflow
121123

122124
Azure Logic Apps has connectors to hundreds of line-of-business (LOB) applications and databases including but not limited to: SAP, Salesforce, Oracle, SQL, and more. You can also connect to SaaS applications or your in-house applications hosted in virtual networks. These out of box connectors provide operations to send and receive data in multiple formats. Leveraging these capabilities with Azure OpenAI assistants, you should be able to quickly bring your data for Intelligent Insights powered by Azure OpenAI.
123125

124-
**What happens when a Logic Apps is imported in AI Studio and invoked**
126+
**What happens when a Logic Apps is imported in Azure OpenAI Studio and invoked**
125127

126-
The Logic Apps swagger file is used to populate function definitions. Azure Logic App publishes an OpenAPI 2.0 definition (swagger) for workflows with a request trigger based on [annotations on the workflow](/rest/api/logic/workflows/list-swagger). Users are able to modify the content of this swagger by updating their workflow. AI studio uses this to generate the function definitions that the Assistant requires.
128+
The Logic Apps swagger file is used to populate function definitions. Azure Logic App publishes an OpenAPI 2.0 definition (swagger) for workflows with a request trigger based on [annotations on the workflow](/rest/api/logic/workflows/list-swagger). Users are able to modify the content of this swagger by updating their workflow. Azure OpenAI Studio uses this to generate the function definitions that the Assistant requires.
127129

128-
**How does authentication from AI Studio to Logic Apps work?**
130+
**How does authentication from Azure OpenAI Studio to Logic Apps work?**
129131

130132
Logic Apps supports two primary types of authentications to invoke a request trigger.
131133

@@ -137,7 +139,7 @@ Logic Apps supports two primary types of authentications to invoke a request tri
137139

138140
Logic Apps also supports authentication trigger invocations with Microsoft Entra ID OAuth, where you can specify authentication policies to be used in validating OAuth tokens. For more information, see the [Logic Apps documentation](../../../logic-apps/logic-apps-securing-a-logic-app.md#generate-shared-access-signatures-sas).
139141

140-
When Azure OpenAI Assistants require invoking a Logic App as part of function calling, AI Studio will retrieve the callback URL with the SAS to invoke the workflow.
142+
When Azure OpenAI Assistants require invoking a Logic App as part of function calling, Azure OpenAI Studio will retrieve the callback URL with the SAS to invoke the workflow.
141143

142144
## See also
143145

0 commit comments

Comments
 (0)