Import / Export

Overview

The Agent Import/Export feature in Dataworkz allows users to seamlessly migrate agent and tool definitions between different tenants or environments — for example, from Development → Staging → Production.

This feature ensures configuration consistency, speeds up deployment workflows, and simplifies agent lifecycle management across environments.

What You Can Do

Action	Description
Export Agents	Download one or more agent configurations — including their associated tools, parameters, prompts, and metadata — as a portable zip file.
Import Agents	Upload previously exported definitions into another Dataworkz tenant or environment.
Selective Import	Choose which agents and tools to import, allowing granular control during migration.
Configure Import	Configure values of dependencies for the agent during import. For example, API keys, LLM configuration, etc. can be configured that are specific to the tenant/environment into which it is being imported.

Typical Use Cases

• Environment Promotion: Move a tested agent from the staging environment to production.

• Tenant Migration: Copy agents between customer tenants in multi-tenant Dataworkz deployments.

• Backup & Recovery: Export and version-control agent definitions as part of your DevOps workflow.

• Collaboration: Share pre-built agent/tool definitions with teammates or partner organizations.

How to Use the Feature

Export Agents and Tools

1

Export: Open Agent

Go to Agents → Edit Agent in the Dataworkz web console.

2

Export: Trigger Export

Click Export.

3

Export: Choose Options

In the Export dialog, choose whether to include linked tools / context variables (recommended).

4

Export: Generate File

Click Export to generate a .zip file. The file will automatically download to your system.

---

Import Agents and Tools

1

Import: Open Import Screen

Navigate to Agents → Import Agent or Agents → Import Tool.

2

Import: Upload File

Select your exported .zip file and click Upload File.

3

Import: Validation

Dataworkz automatically validates the file, including:

• Dependency validation

• Presence of all required agent/tool definitions

4

Import: Review Summary

Review the Import Summary screen to see which agents and tools will be created or updated.

5

Import: Configure Values

Choose values for:

• New Values for Context Variables: Replace current values

• LLM Configuration: Choose from configured options in the new tenant

6

Import: Finalize

Click Save to finalize. Once complete, imported agents appear in the Agents list, tagged as Recently Imported.