Skip to main content

​
Importing Agents

Movoice AI makes it easy to move agents between environments or import community-built templates directly into your account.

​
Importing from the Library

The fastest way to get started is by importing an agent from our Agents Library:
  1. Navigate to the Agents tab.
  2. Click “Explore Library”.
  3. Choose a template that fits your use case (e.g., “Real Estate Assistant”).
  4. Click “Import”.
  5. The agent will now appear in your list, pre-configured with the correct prompt structure and tool definitions.

​
Importing via JSON

For advanced users and developers, you can import agents using a standard JSON format. This is useful for version control or migrating agents from a development workspace to production.

​
Step-by-Step

  1. Click “Create New Agent”.
  2. Select “Import from JSON”.
  3. Paste your agent configuration or upload a .json file.
  4. Movoice will validate the configuration (ensuring all Providers and Tools are available).
  5. Click “Confirm”.

​
Batch Importing

Enterprise customers can batch-import agents for large-scale deployments. This is typically done via the Movoice CLI or our Admin API: 
movoice agents import --file all_agents.json --subaccount department_alpha

​
Troubleshooting Imports

  • Missing Providers: If the imported agent uses a voice provider (e.g., Sarvam AI) that you haven’t connected yet, the agent will default to a standard system voice until you connect the provider in Settings.
  • Schema Mismatch: Ensure your JSON follows the latest Movoice API schema. You can download a reference schema from the API Reference.
When importing an agent, all Knowledge Bases must be re-synced to ensure the vector embeddings are correctly indexed for your account.