Skip to main content

Export Formats

MeetLoyd uses standardized JSON formats for exporting and importing agents and teams. These formats are designed to be portable, version-controlled, and Store-ready.

Format Overview

FormatDescriptionUse Cases
meetloyd-agentSingle agent exportShare agents, backup, Store publishing
meetloyd-teamMulti-agent team exportShare teams, backup, Store publishing

Both formats are forward-compatible. When importing an older version, the system detects the version and applies migrations automatically.

meetloyd-agent Format

Export format for individual agents. Current version: 1.1.

Top-Level Fields

FieldTypeRequiredDescription
_formatstringYesMust be "meetloyd-agent"
_versionstringYesFormat version
_exportedAtstringYesISO 8601 timestamp
_exportedFromstringNoSource tenant ID
agentobjectYesAgent configuration (name, model, systemPrompt, tools, memoryConfig, rateLimits)
versionsarrayNoVersion history

Exporting and Importing

Export an agent from the dashboard by navigating to the agent detail page and clicking Export. You can optionally include version history.

Import an agent by going to Agents > Import and uploading the JSON file.

meetloyd-team Format

Export format for multi-agent teams. Current version: 1.0.

Top-Level Fields

FieldTypeRequiredDescription
_formatstringYesMust be "meetloyd-team"
_versionstringYesFormat version
_exportedAtstringYesISO 8601 timestamp
teamobjectYesTeam metadata (name, description, settings)
agentsarrayYesAgents in the team with localId, name, role, model, etc.
teamMemoryarrayNoInitial team memory entries
tasksarrayNoScheduled tasks
provisioningobjectNoGoogle Workspace / Microsoft 365 resource creation settings
storeobjectNoStore metadata for publishing

Agent Fields

FieldTypeRequiredDescription
localIdstringYesReference ID within the export
namestringYesAgent name
rolestringNoAgent role (e.g., "cmo", "cro")
modelstringYesLLM model ID or alias
systemPromptstringNoSystem prompt
toolsarrayNoEnabled tools
parentAgentLocalIdstringNoReference to supervisor agent

Provisioning Options

Google Workspace

FieldTypeDescription
createGroupbooleanCreate a Google Group
groupEmailstringSuggested group email
createSharedDrivebooleanCreate a shared Google Drive
sharedDriveNamestringName for the shared drive

Microsoft 365

FieldTypeDescription
createGroupbooleanCreate a Microsoft 365 Group
createSharePointSitebooleanCreate a SharePoint site
createTeamsChannelbooleanCreate a Teams channel

Importing a Team

When importing, you can optionally specify a target workspace, override the team name, choose whether to import team memory, and enable or disable Google/Microsoft provisioning.

Best Practices

For Agent Exports

  1. Include meaningful descriptions
  2. Keep system prompts modular
  3. Use standard tool names
  4. Set appropriate rate limits

For Team Exports

  1. Use descriptive localId values
  2. Set parentAgentLocalId for hierarchy
  3. Include initial teamMemory for context
  4. Define tasks with proper schedules

For Store Submissions

  1. Set all store fields (category, tags, version)
  2. Include comprehensive documentation in descriptions
  3. Test the import/export cycle before submission
  4. Version your exports semantically