You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/logic-apps/create-autonomous-agent-workflows.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -675,6 +675,6 @@ For this example, follow these steps:
675
675
## Related content
676
676
677
677
-[AI agentic workflows in Azure Logic Apps](/azure/logic-apps/agent-workflows-concepts)
678
-
-[Lab: Build your first autonomous agent workflow in Azure Logic Apps](https://azure.github.io/logicapps-labs/docs/logicapps-ai-course/build_autonomous_agents/create-first-autonomous-agent)
678
+
-[Lab: Build your first autonomous agentic workflow in Azure Logic Apps](https://azure.github.io/logicapps-labs/docs/logicapps-ai-course/build_autonomous_agents/create-first-autonomous-agent)
679
679
-[Azure Logic Apps limits and configuration](/azure/logic-apps/logic-apps-limits-and-config)
680
680
-[Azure OpenAI Service quotas and limits](/azure/ai-services/openai/quotas-limits)
Copy file name to clipboardExpand all lines: articles/logic-apps/includes/ai-action-parameter-values-runtime.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
ms.service: azure-logic-apps
3
3
ms.author: estfan
4
4
author: ecfan
5
-
ms.date: 11/18/2025
5
+
ms.date: 02/18/2026
6
6
ms.topic: include
7
7
---
8
8
@@ -18,4 +18,4 @@ This section describes the options for how your MCP server sources input paramet
18
18
19
19
- User-provided inputs
20
20
21
-
You specify the parameter values during development. These values are typically hardcoded and stay the same across all interactions between the agent and the end user.
21
+
You specify the parameter values during development. These values are typically hardcoded and stay the same across all interactions between the agent loop and the end user.
Copy file name to clipboardExpand all lines: articles/logic-apps/includes/best-practices-agent-workflows.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,59 +2,59 @@
2
2
ms.service: azure-logic-apps
3
3
ms.author: estfan
4
4
author: ecfan
5
-
ms.date: 10/18/2025
5
+
ms.date: 02/18/2026
6
6
ms.topic: include
7
7
---
8
8
9
-
## Best practices for agents and tools
9
+
## Best practices for agent loops and tools
10
10
11
-
The following sections provide recommendations, best practices, and other guidance that can help you build better agents and tools.
11
+
The following sections provide recommendations, best practices, and other guidance that can help you build better agent loops and tools.
12
12
13
-
### Agents
13
+
### Agent loops
14
14
15
-
The following guidance provides best practices for agents.
15
+
The following guidance provides best practices for agent loops.
16
16
17
-
##### Prototype agents and tools with 'Compose' actions
17
+
##### Prototype agent loops and tools with 'Compose' actions
18
18
19
-
Rather than use actual actions and live connections to prototype your agent and tools, use [**Compose** actions](/azure/logic-apps/logic-apps-perform-data-operations#compose-action) to "mock" or simulate the actual actions. This approach provides the following benefits:
19
+
Rather than use actual actions and live connections to prototype your agent loops and tools, use [**Compose** actions](/azure/logic-apps/logic-apps-perform-data-operations#compose-action) to "mock" or simulate the actual actions. This approach provides the following benefits:
20
20
21
21
-**Compose** actions don't produce side effects, which make these actions useful for ideation, design, and testing.
22
22
23
-
- You can draft and refine agent instructions, prompts, tool names and descriptions plus agent parameters and descriptions - all without having to set up and use live connections.
23
+
- You can draft and refine agent loop instructions, prompts, tool names and descriptions plus agent parameters and descriptions - all without having to set up and use live connections.
24
24
25
-
- When you confirm that your agent and tools work with only the **Compose** actions, you're ready to swap in the actual actions.
25
+
- When you confirm that your agent loop and tools work with only the **Compose** actions, you're ready to swap in the actual actions.
26
26
27
27
- When you switch over to the actual actions, you have to reroute or recreate your agent parameters to work with the actual actions, which might take some time.
28
28
29
29
##### Manage chat history context length
30
30
31
-
The workflow agent maintains the chat history or *context*, including tool invocations, based on the current limit on the number of [tokens](/azure/ai-services/openai/overview#tokens) or messages to keep and pass into the model for the next interaction. Over time, the agent history grows and eventually exceeds your model's *context length* limit, or the maximum number of input tokens. Models differ in their context lengths.
31
+
The agent loop maintains the chat history or *context*, including tool invocations, based on the current limit on the number of [tokens](/azure/ai-services/openai/overview#tokens) or messages to keep and pass into the model for the next interaction. Over time, the agent loop history grows and eventually exceeds your model's *context length* limit, or the maximum number of input tokens. Models differ in their context lengths.
32
32
33
-
For example, **gpt-4o** supports 128,000 input tokens where each token has 3-4 characters. When the agent history approaches the model's context length, consider dropping stale or irrelevant messages to stay below the limit.
33
+
For example, **gpt-4o** supports 128,000 input tokens where each token has 3-4 characters. When the agent loop history approaches the model's context length, consider dropping stale or irrelevant messages to stay below the limit.
34
34
35
-
Here are some approaches to reduce your agent history:
35
+
Here are some approaches to reduce your agent loop history:
36
36
37
37
- Reduce the size of results from tools by using the [**Compose** action](/azure/logic-apps/logic-apps-perform-data-operations#compose-action). For more information, see [Tools - Best practices](#tools).
38
38
39
-
- Carefully craft your agent instructions and prompts to control the model's behavior.
39
+
- Carefully craft your agent loop instructions and prompts to control the model's behavior.
40
40
41
41
-**Experimental capability**: You have the option to try chat reduction so you can reduce the maximum number of tokens or messages to keep in chat history and pass into the model.
42
42
43
-
A workflow agent has almost the same advanced parameters as the [Azure OpenAI built-in, service provider connector](/azure/logic-apps/connectors/built-in/reference/openai/), except for the **Agent History Reduction Type** advanced parameter, which exists only in the agent. This parameter controls the history that the agent maintains, based on the maximum number of tokens or messages.
43
+
The agent loop has almost the same advanced parameters as the [Azure OpenAI built-in, service provider connector](/azure/logic-apps/connectors/built-in/reference/openai/), except for the **Agent History Reduction Type** advanced parameter, which exists only on the agent action. This parameter controls the history that the agent loop maintains, based on the maximum number of tokens or messages.
44
44
45
45
This capability is in active development and might not work for all scenarios. You can change the **Agent History Reduction Type** option to reduce the limit on tokens or messages. You then specify the numerical limit that you want.
46
46
47
47
To try the capability, follow these steps:
48
48
49
-
1. On the designer, select the agent's title bar to open the information pane.
49
+
1. On the designer, select the agent action's title bar to open the information pane.
50
50
1. On the **Parameters** tab, find the **Advanced parameters** section.
51
51
1. Check whether the parameter named **Agent History Reduction Type** exists. If not, open the **Advanced parameters** list, and select that parameter.
52
52
1. From the **Agent History Reduction Type** list, select one of the following options:
53
53
54
54
| Option | Description |
55
55
|--------|-------------|
56
-
|**Token count reduction**| Shows the parameter named **Maximum Token Count**. Specifies the maximum number of tokens in agent history to keep and pass into the model for the next interaction. The default differs based on the currently used model in Azure OpenAI Service. The default limit is **128,000**. |
57
-
|**Message count reduction**| Shows the parameter named **Message Count Limit**. Specifies the maximum number of messages in agent history to keep and pass into the model for the next interaction. No default limit exists. |
56
+
|**Token count reduction**| Shows the parameter named **Maximum Token Count**. Specifies the maximum number of tokens in agent loop history to keep and pass into the model for the next interaction. The default differs based on the currently used model in Azure OpenAI Service. The default limit is **128,000**. |
57
+
|**Message count reduction**| Shows the parameter named **Message Count Limit**. Specifies the maximum number of messages in agent loop history to keep and pass into the model for the next interaction. No default limit exists. |
58
58
59
59
### Tools
60
60
@@ -66,11 +66,11 @@ The following guidance provides best practices for tools.
66
66
67
67
- Both the tool name and description have character limits.
68
68
69
-
Some limits are enforced by the model in Azure OpenAI Service at run time, rather than when you save the changes in the agent in the workflow.
69
+
Some limits are enforced by the model in Azure OpenAI Service at run time, rather than when you save the changes in the agent loop in the workflow.
70
70
71
-
- Too many tools in the same agent can have a negative effect on agent quality.
71
+
- Too many tools in the same agent loop can have a negative effect on agent loop quality.
72
72
73
-
A good general guideline recommends that an agent includes no more than 10 tools. However, this guidance varies based on the model that you use from Azure OpenAI Service.
73
+
A good general guideline recommends that an agent loop includes no more than 10 tools. However, this guidance varies based on the model that you use from Azure OpenAI Service.
74
74
75
75
- In tools, actions don't need to have all their inputs come from the model.
76
76
@@ -94,4 +94,4 @@ The following guidance provides best practices for agent parameters.
94
94
95
95
- The name is the most important value for an agent parameter. Make sure the name is succinct and descriptive.
96
96
97
-
- The agent parameter description provides useful and helpful context for the tool.
97
+
- The agent parameter description provides useful and helpful context for the tool.
Copy file name to clipboardExpand all lines: articles/logic-apps/includes/billing-agent-workflows.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
ms.service: azure-logic-apps
3
3
ms.author: estfan
4
4
author: ecfan
5
-
ms.date: 11/18/2025
5
+
ms.date: 02/18/2026
6
6
ms.topic: include
7
7
---
8
8
@@ -12,4 +12,4 @@ ms.topic: include
12
12
13
13
- Consumption: Billing uses the pay-as-you-go model. Agent loop pricing is based on the number of tokens that each agent action uses and appears as Enterprise Units on your bill. For specific pricing information see [Azure Logic Apps pricing](https://azure.microsoft.com/pricing/details/logic-apps/).
14
14
15
-
- Standard: Although agent workflows don't incur extra charges, AI model usage incurs charges. For more information, see the Azure [Pricing calculator](https://azure.microsoft.com/pricing/calculator/).
15
+
- Standard: Although agentic workflows don't incur extra charges, AI model usage incurs charges. For more information, see the Azure [Pricing calculator](https://azure.microsoft.com/pricing/calculator/).
Copy file name to clipboardExpand all lines: articles/logic-apps/includes/supported-models.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,30 +2,30 @@
2
2
ms.service: azure-logic-apps
3
3
ms.author: estfan
4
4
author: ecfan
5
-
ms.date: 11/18/2025
5
+
ms.date: 02/18/2026
6
6
ms.topic: include
7
7
---
8
8
9
9
<aname="supported-models"></a>
10
10
11
-
## Supported Azure OpenAI Service models for agent workflows
11
+
## Supported Azure OpenAI Service models for agentic workflows
12
12
13
-
The following list specifies the AI models that you can use with agent workflows:
13
+
The following list specifies the AI models that you can use with agentic workflows:
14
14
15
15
### [Consumption (preview)](#tab/consumption)
16
16
17
-
Your agent automatically uses one of the following Azure OpenAI Service models:
17
+
Your agent loop automatically uses one of the following Azure OpenAI Service models:
18
18
19
19
- gpt-4o-mini
20
20
- gpt-5o-mini
21
21
22
22
> [!IMPORTANT]
23
23
>
24
-
> The AI model that your agent uses can originate from any region, so data residency for a specific region isn't guaranteed for data that the model handles.
24
+
> The AI model that your agent loop uses can originate from any region, so data residency for a specific region isn't guaranteed for data that the model handles.
25
25
26
26
### [Standard](#tab/standard)
27
27
28
-
Your agent can use one of the following models:
28
+
Your agent loop can use one of the following models:
Copy file name to clipboardExpand all lines: articles/logic-apps/includes/troubleshoot-agent-workflows.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,35 +2,35 @@
2
2
ms.service: azure-logic-apps
3
3
ms.author: estfan
4
4
author: ecfan
5
-
ms.date: 09/08/2025
5
+
ms.date: 02/18/2026
6
6
ms.topic: include
7
7
---
8
8
9
9
## Troubleshoot problems
10
10
11
-
This section describes guidance to help troubleshoot errors or problems that you might encounter when you build or run agent workflows.
11
+
This section describes guidance to help troubleshoot errors or problems that you might encounter when you build or run agentic workflows.
12
12
13
13
### Review tool execution data
14
14
15
-
The workflow run history provides useful information that helps you learn what happened during a specific run. For an agent workflow, you can find tool execution inputs and outputs for a specific agent loop iteration.
15
+
The workflow run history provides useful information that helps you learn what happened during a specific run. For an agentic workflow, you can find tool execution inputs and outputs for a specific agent loop iteration.
16
16
17
17
1. On the workflow menu, under **Tools**, select **Run history** to open the **Run history** page.
18
18
19
19
1. On the **Run history** tab, in the **Identifier** column, select the workflow run that you want.
20
20
21
21
The monitoring view opens to show the status for each step.
22
22
23
-
1. Select the agent that you want to inspect. To the right side, the **Agent log** pane appears.
23
+
1. Select the agent action that you want to inspect. To the right side, the **Agent log** pane appears.
24
24
25
25
This pane shows the agent log, including tool executions during the interaction.
26
26
27
27
1. To get tool execution data at a specific point, find that point in the agent log, and select the tool execution reference, for example:
This action moves you to the matching tool in monitoring view. The agent shows the current iteration count.
31
+
This action moves you to the matching tool in monitoring view. The agent action shows the current iteration count.
32
32
33
-
1. In monitoring view, select the agent or the action with the inputs, outputs, and properties that you want to review.
33
+
1. In monitoring view, select the agent action or the action with the inputs, outputs, and properties that you want to review.
34
34
35
35
The following example shows a selected action for the previously selected tool execution:
36
36
@@ -40,22 +40,22 @@ The workflow run history provides useful information that helps you learn what h
40
40
41
41
- Input messages passed into the model.
42
42
- Output messages returned from the model.
43
-
- Tools that the model asked the agent to call.
43
+
- Tools that the model asked the agent loop to call.
44
44
- Tool results that passed back into the model.
45
45
- Number of tokens that each request used.
46
46
47
47
1. To review a different agent loop iteration, in the agent, select the left or right arrow.
48
48
49
49
### Logs in Application Insights
50
50
51
-
If you set up Application Insights or advanced telemetry for your workflow, you can review the logs for agent events, like any other action. For more information, see [Enable and view enhanced telemetry in Application Insights for Standard workflows in Azure Logic Apps](/azure/logic-apps/enable-enhanced-telemetry-standard-workflows).
51
+
If you set up Application Insights or advanced telemetry for your workflow, you can review the logs for agent loop events, like any other action. For more information, see [Enable and view enhanced telemetry in Application Insights for Standard workflows in Azure Logic Apps](/azure/logic-apps/enable-enhanced-telemetry-standard-workflows).
52
52
53
53
### Model maximum context length exceeded
54
54
55
55
If your agent's log history exceeds the model's *context length*, or the maximum number of input tokens, you get an error that looks like the following example:
56
56
57
57
**This model's maximum context length is 4097 tokens. However, you requested 4927 tokens (3927 in the messages, 1000 in the completion). Please reduce the length of the messages or completion.**
58
58
59
-
Try reducing the limit on the number of tokens or messages that your agent keeps in log and passes into the model for the next interaction. For this example, you might select **Token count reduction** and set **Maximum Token Count** to a number below the error's stated maximum context length, which is **4097**.
59
+
Try reducing the limit on the number of tokens or messages that your agent loop keeps in the log and passes into the model for the next interaction. For this example, you might select **Token count reduction** and set **Maximum Token Count** to a number below the error's stated maximum context length, which is **4097**.
60
60
61
61
For more information, see [Manage chat history context length](#manage-chat-history-context-length).
0 commit comments