Overview
Agents created directly inside workflows are moving to the AI Agent hub. Until migrated, legacy agents remain functional but are read-only and cannot be edited. Workflows that still contain legacy agents display a banner indicating that migration is required.
How to use
Review agents flagged for migration
When the AI Agent hub is enabled, a banner appears at the top of the Workflows page listing the number of agents and workflows that require migration.
Open the migration list: Click Review in the banner to open a panel listing all agents flagged for migration, along with the workflow each agent belongs to.
Open a workflow: Select a workflow from the list to open it on the canvas.
Migrate an agent
Legacy agents on the canvas are marked with a Legacy label and an orange warning badge. Clicking a legacy agent opens its configuration in read-only mode.
Select the legacy agent: Click the agent step on the canvas. The configuration panel opens showing the agent's instructions, toolbox, and execution log: all read-only.
Start migration: Click Duplicate. A new browser tab opens with a pre-filled copy of the agent in the AI Agent hub.
Review the configuration: Check the migrated instructions, tools, and settings. Make any adjustments needed.
Publish: Click Save, then Publish to publish the agent and make it available in workflows.
Return to the canvas: Go back to the original workflow tab.
Swap the agent: Remove the legacy agent step from the canvas, then add the newly published agent from the Published agents panel.
Repeat: Repeat for any remaining legacy agents in the workflow.
The workflow banner disappears once all legacy agents have been removed from the canvas.
Legacy agent configuration
Legacy agents that have not been migrated remain on the canvas and continue to run, but their configuration is read-only. No edits can be made to a legacy agent's instructions, toolbox, or settings.
The configuration panel has three tabs:
Instructions: Shows the agent's role, instructions, and output schema. Read-only.
Toolbox: Shows the tools connected to the agent. Read-only.
Execution log: Shows the run history for the agent, including inputs, outputs, and action flow.
To make changes to a legacy agent, complete the migration steps above and edit the published copy in the AI Agent hub.