Skip to content

Commit 01b8b91

Browse files
author
ecfan
committed
Fix terminology
1 parent 85764da commit 01b8b91

6 files changed

Lines changed: 41 additions & 41 deletions

articles/logic-apps/create-autonomous-agent-workflows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -675,6 +675,6 @@ For this example, follow these steps:
675675
## Related content
676676

677677
- [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)
679679
- [Azure Logic Apps limits and configuration](/azure/logic-apps/logic-apps-limits-and-config)
680680
- [Azure OpenAI Service quotas and limits](/azure/ai-services/openai/quotas-limits)

articles/logic-apps/includes/ai-action-parameter-values-runtime.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
ms.service: azure-logic-apps
33
ms.author: estfan
44
author: ecfan
5-
ms.date: 11/18/2025
5+
ms.date: 02/18/2026
66
ms.topic: include
77
---
88

@@ -18,4 +18,4 @@ This section describes the options for how your MCP server sources input paramet
1818

1919
- User-provided inputs
2020

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.

articles/logic-apps/includes/best-practices-agent-workflows.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,59 +2,59 @@
22
ms.service: azure-logic-apps
33
ms.author: estfan
44
author: ecfan
5-
ms.date: 10/18/2025
5+
ms.date: 02/18/2026
66
ms.topic: include
77
---
88

9-
## Best practices for agents and tools
9+
## Best practices for agent loops and tools
1010

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.
1212

13-
### Agents
13+
### Agent loops
1414

15-
The following guidance provides best practices for agents.
15+
The following guidance provides best practices for agent loops.
1616

17-
##### Prototype agents and tools with 'Compose' actions
17+
##### Prototype agent loops and tools with 'Compose' actions
1818

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:
2020

2121
- **Compose** actions don't produce side effects, which make these actions useful for ideation, design, and testing.
2222

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.
2424

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.
2626

2727
- 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.
2828

2929
##### Manage chat history context length
3030

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.
3232

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.
3434

35-
Here are some approaches to reduce your agent history:
35+
Here are some approaches to reduce your agent loop history:
3636

3737
- 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).
3838

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.
4040

4141
- **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.
4242

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.
4444

4545
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.
4646

4747
To try the capability, follow these steps:
4848

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.
5050
1. On the **Parameters** tab, find the **Advanced parameters** section.
5151
1. Check whether the parameter named **Agent History Reduction Type** exists. If not, open the **Advanced parameters** list, and select that parameter.
5252
1. From the **Agent History Reduction Type** list, select one of the following options:
5353

5454
| Option | Description |
5555
|--------|-------------|
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. |
5858

5959
### Tools
6060

@@ -66,11 +66,11 @@ The following guidance provides best practices for tools.
6666

6767
- Both the tool name and description have character limits.
6868

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.
7070

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.
7272

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.
7474

7575
- In tools, actions don't need to have all their inputs come from the model.
7676

@@ -94,4 +94,4 @@ The following guidance provides best practices for agent parameters.
9494

9595
- The name is the most important value for an agent parameter. Make sure the name is succinct and descriptive.
9696

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.

articles/logic-apps/includes/billing-agent-workflows.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
ms.service: azure-logic-apps
33
ms.author: estfan
44
author: ecfan
5-
ms.date: 11/18/2025
5+
ms.date: 02/18/2026
66
ms.topic: include
77
---
88

@@ -12,4 +12,4 @@ ms.topic: include
1212

1313
- 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/).
1414

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/).

articles/logic-apps/includes/supported-models.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,30 @@
22
ms.service: azure-logic-apps
33
ms.author: estfan
44
author: ecfan
5-
ms.date: 11/18/2025
5+
ms.date: 02/18/2026
66
ms.topic: include
77
---
88

99
<a name="supported-models"></a>
1010

11-
## Supported Azure OpenAI Service models for agent workflows
11+
## Supported Azure OpenAI Service models for agentic workflows
1212

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:
1414

1515
### [Consumption (preview)](#tab/consumption)
1616

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:
1818

1919
- gpt-4o-mini
2020
- gpt-5o-mini
2121

2222
> [!IMPORTANT]
2323
>
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.
2525
2626
### [Standard](#tab/standard)
2727

28-
Your agent can use one of the following models:
28+
Your agent loop can use one of the following models:
2929

3030
- gpt-5
3131
- gpt-4.1

articles/logic-apps/includes/troubleshoot-agent-workflows.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,35 +2,35 @@
22
ms.service: azure-logic-apps
33
ms.author: estfan
44
author: ecfan
5-
ms.date: 09/08/2025
5+
ms.date: 02/18/2026
66
ms.topic: include
77
---
88

99
## Troubleshoot problems
1010

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.
1212

1313
### Review tool execution data
1414

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.
1616

1717
1. On the workflow menu, under **Tools**, select **Run history** to open the **Run history** page.
1818

1919
1. On the **Run history** tab, in the **Identifier** column, select the workflow run that you want.
2020

2121
The monitoring view opens to show the status for each step.
2222

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.
2424

2525
This pane shows the agent log, including tool executions during the interaction.
2626

2727
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:
2828

2929
:::image type="content" source="media/troubleshoot-agent-workflows/tool-reference-links.png" alt-text="Screenshot shows agent log and selected tool execution link." lightbox="media/troubleshoot-agent-workflows/tool-reference-links.png":::
3030

31-
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.
3232

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.
3434

3535
The following example shows a selected action for the previously selected tool execution:
3636

@@ -40,22 +40,22 @@ The workflow run history provides useful information that helps you learn what h
4040

4141
- Input messages passed into the model.
4242
- 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.
4444
- Tool results that passed back into the model.
4545
- Number of tokens that each request used.
4646

4747
1. To review a different agent loop iteration, in the agent, select the left or right arrow.
4848

4949
### Logs in Application Insights
5050

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).
5252

5353
### Model maximum context length exceeded
5454

5555
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:
5656

5757
**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.**
5858

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**.
6060

6161
For more information, see [Manage chat history context length](#manage-chat-history-context-length).

0 commit comments

Comments
 (0)