Choosing a style for your agent

When you create an agent in watsonx Orchestrate, you must choose an agent style, which defines the reasoning and execution pattern your agent follows. This choice determines how the agent interprets instructions, selects tools, and completes tasks. Your choice directly affects the agent’s accuracy, reasoning, and overall performance.

This topic describes the available agent styles, their ideal use cases, and how to select the right style for your workflow.

Agent styles

An agent style controls how the agent plans, decides, and acts during task execution when interacting with tools and collaborators.

watsonx Orchestrate supports three agent styles:

  • Default (default)

  • ReAct (react)

  • Plan-Act (planner)

Each style is optimized for different types of tasks. Evaluate your task complexity, tool usage, and need for transparency to select the most effective one.

Default style

Use the Default style for simple, flexible workflows that rely on the LLM’s prompt-driven decision making. This style is tool-centric and allows the agent to decide which tool to use, when to use it, and how to respond without requiring a predefined plan.

When to use

Choose the Default style when your agent handles:

  • Single step or lightly sequential tasks

  • Scenarios that require adaptability

  • Tasks involving multiple tools without strict order

Behavior

The agent uses iterative prompting to:

  • Identify the appropriate tool or collaborator

  • Determine the correct input

  • Decide whether to continue or finalize the response

This loop continues until the agent gathers enough context to complete the task.

Tool compatibility

  • Python tools

  • OpenAPI tools

  • MCP tools

Sample use cases

  • Retrieve a report from a system

  • Check the status of a ticket

  • Extract information from a webpage

Supports Benefits: Enables fast execution with minimal setup. Ideal for agents that need flexibility and quick responses.

ReAct style

Use the ReAct style for tasks that require step-by-step reasoning and validation. This style follows a "Think → Act → Observe” loop, allowing the agent to reflect on each action before proceeding. It is based on the ReAct methodology and supports transparent reasoning.

When to use

Choose the ReAct style when your agent handles:

  • Exploratory or research intensive tasks

  • Scenarios with evolving or ambiguous requirements

  • Tasks that benefit from visible reasoning and user confirmation

Behavior

The agent performs the following steps:

  • Think: Analyze the request and decide on the next action

  • Act: Run the selected tool or collaborator

  • Observe: Review the result and adjust the next step

This loop repeats until the task is complete.

Tool compatibility

  • Knowledge intensive tools

  • Data intensive tools

  • Collaborator agents

Sample use cases

  • Generate and refine code snippets

  • Answer complex questions by using web search and synthesis

  • Handle support tickets with multiple user interactions

Supports Benefits: Improves accuracy through iterative reasoning. Ideal for tasks that require validation, transparency, or user feedback.

Plan-Act style

Use the Plan-Act style for structured, multi-step workflows. This style begins with a planning phase where the agent creates a sequence of actions. It then runs each step in order, by using predefined tools and collaborators. The agent can replan if conditions change during execution.

Plan-Act style requires setup by using the Agent Development Kit (ADK). For more information on configuring the style of your agent by using ADK, see Agent styles Launch icon .

When to use

Choose the Plan-Act style when your agent handles:

  • Business processes with multiple steps

  • Tasks that require traceability and structured output

  • Automations involving several tools or domains

Behavior

The agent performs the following:

  • Generates a structured plan by using the LLM

  • Runs each step in the plan sequentially

  • Replans if unexpected results occur

  • Summarizes the completed tasks (unless a custom output is defined)

Tool Compatibility

  • Python tools

  • OpenAPI tools

  • MCP tools

  • Collaborator agents

Sample use cases

  • Create structured reports from multiple data sources

  • Draft contracts or compliance checklists

  • Combine results from search, calculator, and code tools

Supports Benefits: Enhances reliability and traceability. Ideal for agents that require oversight and structured execution.

Choosing the right style

Use the following table to compare agent styles and select the one that best fits your task:

Criteria Default ReAct Plan-Act
Task complexity Low to moderate Moderate to high High
Reasoning pattern Prompt driven Iterative Planned
Transparency Low High High
Flexibility High Moderate Low
Tool usage Dynamic Adaptive Structured
Ideal for Quick tasks Exploratory tasks Multi-step workflows

Recommendations

  • Use Default for fast, flexible tasks with minimal dependencies.

  • Use ReAct when accuracy and reasoning transparency are important.

  • Use Plan-Act for structured workflows that require planning and traceability.

Setting the style in the UI

  1. In the Profile section, go to Agent style.
  2. Choose Default or ReAct based on your agent style.
  3. If the style is locked with an Agent style set from ADK notification, it indicates a configuration that is made in the ADK and cannot be changed in the UI.
Note: You can also set the style for your agent through ADK. For more information, see Agent styles.