This document describes how to create and configure a workflow chat agent in Workflow Builder.
Overview
A workflow chat agent functions as a powerful, multi-node workflow orchestrator to manage conversational interactions.
While a non-workflow chat agent is restricted to a single root node with fixed attributes, a workflow chat agent lets you attach published workflows and remote Application Development Kit (ADK) agents as sub-agents. The root chat agent acts as the coordinator, dispatching user queries to the appropriate sub-agent and returning responses.
Key benefits of workflow chat agents include:
- Advanced Orchestration: Nest multiple published workflow or remote ADK agents as sub-nodes to handle complex user tasks.
- Version History Support: Workflow chat agents support versioning. You can save, compare, view history, and restore previous agent versions to track modifications.
Before you begin
Before creating a workflow chat agent, complete the following prerequisites:
- Ensure that a Gemini Enterprise administrator has enabled the Workflow Builder feature toggle in your app's feature management settings. For more information, see Manage web app features.
- Ensure you have a web app with the necessary data sources connected. For more information, see Create an app, Connect a Google data source, and Connect a third-party data source.
- Verify that any workflows or remote ADK agents you want to attach as sub-agents are already published in your workspace repository, making them visible to the root orchestrator.
Create a workflow chat agent
App
To manually create a workflow chat agent, do the following:
- Open your Gemini Enterprise web app in a browser.
- In the web app navigation menu, click + New agent > Workflows.
- In the agent creation pane, click Build manually.
Select the Chat trigger chip.
The Workflow Builder editor opens, directing you to the workflow chat agent configuration options.
In the configuration pane, you can optionally configure the following for your agent:
Suggested prompts: Enter a prompt that describes your agent's purpose and intended behavior.
Knowledge: Click Add files to upload any additional reference materials for your agent to use.
Tools & integrations: Open the Tools & integrations dialog to select the Google tools and Apps allowed for this conversational interface.
Sub agents: Browse or search to select the published workflows or remote ADK agents that you want your workflow to orchestrate. These agents will be configured as run-time sub-nodes beneath the root agent.
More: Select the model used by your workflow chat agent.
Test your agent configuration:
- Click the Preview tab.
- In the chat interface, submit a test message (for example,
hello) to evaluate your agent's responses.
Save or manage agent versions (Optional):
- Click the drop-down arrow next to Publish and select Save version.
- To review or restore a version, click the drop-down arrow next to Publish, click View version history, and select the version to restore.
Click Publish to finalize and publish your workflow chat agent.
Once published, the workflow chat agent appears in your Agents gallery, ready to handle incoming user requests.
Feature limitations
Workflow chat agents have the following limitations:
- The configuration details of an attached sub-agent are not visible inside the root chat agent configuration pane. To inspect or edit a sub-agent's workflow (such as an approval step), open the workflow individually from the Agents gallery page.
- The Schedule chat agent run feature is not supported for workflow chat agents. Scheduling options only apply to non-workflow agents.
- The Share a chat agent feature is not supported for workflow chat agents in this release.