App Import & Export

​

Overview

• Backup app configurations.
• Share setups across teams.
• Migrate between environments.
• Version control outside the platform.

​

Export

​

What’s Exported

​

What’s NOT Exported

• API keys and secrets
• Actual data in memory stores
• Usage analytics
• Deployment history

​

Export Process

1. Navigate to Deploy → Export/Import.
2. Select Export tab.
3. Choose export type:
   • App: Full application export
   • Agents: Selected agents only
4. Select version (if applicable).
5. Click Export.
6. Download the JSON file.

​

File Naming

App level export: <app-name>-export-<timestamp>.zip, includes app level config and individual files for workflow tools that are part of the app.
Agent level export: agents-<app-name>-<timestamp>.json

​

Import

​

Prerequisites

• Import permissions in your account
• Valid JSON or zip file (max 5 MB)
• Target app must exist.

​

Import Process

1. Navigate to Deploy → Export/Import.
2. Select Import tab.
3. Upload JSON/Zip file.
4. Review component summary:
   • App details
   • Agents and tools
   • Knowledge sources
   • Memory stores
   • Variables
5. Resolve any conflicts (highlighted in red).
6. Click Import.

​

Import Order

1. Tools (standalone)
2. Agents
3. App configuration
4. Events
5. Memory stores

​

Handling Conflicts

​

Missing Dependencies

• Verify the file.
• Retry after appropriate changes in the file.

​

Model Availability

• Configure the required models
• Select alternative models after import.

​

Environment Variables

{
  "env_variables": [
    {
      "name": "API_KEY",
      "value": "***REDACTED***",
      "is_secret": true
    },
    {
      "name": "API_URL",
      "value": "https://api.example.com",
      "is_secret": false
    }
  ]
}

1. Navigate to Settings → Environment.
2. Update secret values.
3. Verify non-secret values are correct.

​

Best Practices

​

Before Export

• Test the app thoroughly.
• Document the configuration.
• Note any external dependencies.
• Verify all tools are deployed.

​

Before Import

• Backup existing configuration.
• Check model availability.
• Prepare environment variables.
• Review import summary carefully.

​

Version Control

configs/
├── production/
│   ├── app-customer-service-2024-01-15.json
│   └── app-customer-service-2024-01-01.json
├── staging/
│   └── app-customer-service-latest.json
└── README.md

​

Migration Checklist

## Pre-Migration
- [ ] Export source configuration
- [ ] Document external dependencies
- [ ] List required API keys
- [ ] Note model requirements

## Import
- [ ] Create target app (if new)
- [ ] Upload configuration
- [ ] Resolve conflicts
- [ ] Update environment variables

## Post-Migration
- [ ] Configure API keys
- [ ] Test all agents
- [ ] Verify tool functionality
- [ ] Run diagnostics
- [ ] Test end-to-end flows

​

Troubleshooting

​

Import Fails

• Validate JSON syntax.
• Check file wasn’t corrupted.

• Maximum size is 5 MB.
• Split into separate exports.

• Ensure export is from compatible version.
• Check for manual edits that removed fields.

​

Configuration Issues After Import

• Redeploy workflow tools.
• Check API connections.
• Verify environment variables.

• Review instruction import.
• Check knowledge connections.
• Verify model configuration.