Importing Agents

VectorChat supports importing and exporting agents as JSON files. This allows you to share agent configurations between accounts, back up your setups, or deploy pre-built agents.

Exporting an agent

To export an agent:

1. Navigate to the agent's detail page.
2. Click the Export option from the agent's menu.
3. A JSON file will be downloaded containing the agent's complete configuration.

The export includes:

• Agent settings (name, description, system instructions, model, parameters)
• All attached skills with their instructions and tool configurations

Importing an agent

To import an agent:

1. Navigate to the Agents page.
2. Click the Import Agent button.
3. Paste or upload the JSON export file.
4. Review the agent configuration that will be created.
5. Click Import to create the agent.

The import process creates:

• A new agent with the exported settings
• New copies of all skills included in the export
• Skill-to-agent assignments

Export format

The export file is a JSON document with the following structure:

{
  "agent": {
    "name": "Customer Support Bot",
    "description": "Handles common support requests",
    "system_prompt": "You are a helpful support agent...",
    "model": "gpt-4o",
    "temperature": 0.7,
    "max_tokens": 4096,
    "save_messages": true,
    "max_agent_turns": 10,
    "max_tool_calls": 5
  },
  "skills": [
    {
      "title": "Ticket Triage",
      "description": "Categorizes incoming support tickets...",
      "prompt_md": "# Ticket Triage\n\n## Instructions\n...",
      "tools": []
    }
  ]
}

After importing

Once imported, the agent is ready to use but you may want to:

• Connect tools — Tool credentials are not included in exports for security. Re-authenticate any required integrations.
• Attach knowledge bases — Link relevant knowledge bases to the imported agent.
• Review settings — Verify the model and parameters match your preferences.
• Test the agent — Start a conversation to confirm everything works as expected.