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-<app-name>-<timestamp>.json
agents-<app-name>-<timestamp>.json

​

Import

​

Prerequisites

• Import permissions in your account
• Valid JSON file (max 5 MB)
• Target app must exist (for agent imports)

​

Import Process

1. Navigate to Deploy → Export/Import.
2. Select Import tab.
3. Upload JSON 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

⚠️ Agent "Support Agent" references tool "get_order_status"
   which does not exist in target environment.

Options:
- Import the tool first
- Update agent to use existing tool
- Skip this agent

​

Model Availability

⚠️ Agent uses model "gpt-4-custom" which is not available.

Options:
- Configure the model first
- Select an alternative model

​

Name Conflicts

⚠️ Tool "get_order_status" already exists.

Options:
- Overwrite existing
- Rename imported tool
- Skip import

​

Workflow Tool Import

1. Export workflow tools separately if needed.
2. Import workflow tools first.
3. Link to agents manually 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

​

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.