Cloudera Docs

Migrating workflows across Agent Studio

This section details the steps to transfer a workflow template between Cloudera AI Agent Studio instances, covering both export from the source and import into the target instance.

Workflow templates are exported as ZIP files, and includes the following essential components:
  • Workflow template configuration
  • Agent templates
  • Tool templates
  • MCP templates
  • Task templates
  • Associated icons and assets
  1. In the Cloudera console, click the Cloudera AI tile.
    The Cloudera AI Home page is displayed.
  2. Click on the name of the workbench.
    The AI Workbench Home page is displayed.
  3. In the left navigation pane, click AI Studios.
    The AI Studios page is displayed.
  4. On the Agent Studio tile, click Open.
    The Agentic Workflows window is displayed.
  5. Locate the workflow template you want to migrate.
  6. Click the Download Workflow Template icon on the workflow tile.
    The workflow template is downloaded as a ZIP file to your local machine. The file is named based on the template name.
  7. Click on Projects in the left navgation pane, of the AI Workbench Home page.
    The Projects window is displayed.
    Figure 1. Projects window
  8. Click on the project, where you want to upload the ZIP file.
    The project Overview window is displayed.
  9. Click on Files.
    The Files window is displayed.
  10. Click on Upload.
    Your local directory opens.
  11. Select the downloaded ZIP file from and local directory.
    The ZIP file is uploaded.
  12. Make a note of the complete relative path of the uploaded file, for example, workflow_template.zip.
  13. Navigate to the Agentic Workflows page in your target Agent Studio instance.
    Figure 2. Agentic Workflows page
  14. Click on Import Template.
    The Import Workflow Template dialog box opens.
  15. Enter the relative path to the uploaded ZIP file in the input field.
    The system automatically checks if the file exists at the specified path.
    • A green success message is displayed if the file is located.
    • A warning message is displayed if there are some issues when confirming the file's presence. You can ignore this warning message in most of the cases
  16. Click on Import.
    The ZIP file is extracted and new UUIDs are created for all templates to prevent conflicts. All workflow components such as, agents, tools, tasks, MCP servers are imported and the associated assets such as, icons, tool templates are copied.
The template is accessible in the target instance and the imported workflow template appears in the Templates section and can be used to create new workflows.