1. Builder Docs
  2. API Reference
  3. AI Employees
  4. Data Model

AI Employee Data Model

This page defines the protobuf data structures used to configure AI Employees (personas) in the Ema platform.

PersonaConfig

The top-level configuration object for an AI Employee.

FieldTypeDescription
idstringUnique identifier (UUID)
namestringDisplay name of the AI Employee
descriptionstringBrief description of the AI Employee's purpose
iconstringIcon identifier
statusTemplateStatusDeprecated template status field
editableboolWhether the configuration is editable
versionint32Configuration version number
rich_detail_descriptionstringRich text description (supports formatting)
widgetsrepeated WidgetList of widget configurations
display_settingsDisplaySettingsUI display configuration
project_settingsProjectSettingsProject-level settings and defaults
triggerPersonaTriggerOperational trigger configuration
persona_statusPersonaStateEnumPersona state
access_levelPersonaAccessLevelComputed access level
persona_trigger_typePersonaTriggerTypeUser-facing trigger type such as chat or dashboard
workflow_dashboard_idstringAssociated workflow dashboard ID
template_idstringTemplate ID this persona was instantiated from
persona_group_idstringOptional persona group identifier

Widget

A Widget connects the AI Employee to an external data source or integration.

FieldTypeDescription
namestringUnique name of the widget instance
typeWidgetTypeThe type of widget
<widget field>objectType-specific configuration stored under the matching widget field (for example file_upload or chatbot_sdk_config)

WidgetType Enum

ValueIntegerDescription
SCRAPE_URLS0URL scraping configuration
EXAMPLE_TRIGGERS1Example triggers (deprecated)
WEBSEARCH_ENABLED2Web search enablement
FILE_UPLOAD3Direct file upload
DATA_INTEGRATION4Data source integration
ANSWER_FORMAT5Answer format configuration
FUSION_MODEL6Fusion LLM model selection
EXAMPLE_QUESTIONS7Example questions for the AI Employee
DATA_PROTECTION8Data protection settings
COPYRIGHT_CHECK9Copyright checking
STEPS10Workflow steps configuration
TICKET_CATEGORY_CONFIG11Ticket category configuration
CUSTOM_INSTRUCTIONS12Custom instructions
GLOSSARY13Glossary terms
HEIRARCHICAL_TAGS14Hierarchical tags
PROPOSAL_TEMPLATE_TYPE15Proposal template type
DOC_SECTION_CONFIG16Document section configuration
COMPANY_DETAILS17Company details
EMAIL_INTEGRATION18Email integration
TARGET_AUDIENCE19Target audience (deprecated)
EMAIL_CONFIGURATION20Email configuration (deprecated)
CAMPAIGN_GOAL_SETUP21Campaign goal setup
BASE_CATEGORY_WIDGET22Base category widget
TITLE_WITH_TEXT_AREA23Title with text area
LINKEDIN_INTEGRATION24LinkedIn integration
CANDIDATE_SEARCH_DETAILS25Candidate search details
CANDIDATE_SEARCH_SCORECARD26Candidate search scorecard
TARGET_COMPANY_SEARCH27Target company search
CHATBOT_SDK_CONFIG28Chatbot SDK configuration
FILE_TAGGING29File tagging
MULTI_SOURCE_TARGET_AUDIENCE30Multi-source target audience
FILE_LINKING31File linking
TEMPLATE_INPUT32Template input
FEEDBACK_MESSAGE33Feedback message
BLOCK_USERS34Block users
ENGAGEMENT_CONFIGURATION35Engagement configuration
SFO_ID_CONFIG36SFO ID configuration
VOICEBOT_VOICE_SETTINGS38Voicebot voice settings
VOICEBOT_CONVERSATION_SETTINGS39Voicebot conversation settings
VOICEBOT_FEEDBACK_COLLECTION40Voicebot feedback collection
VOICEBOT_CALL_SETTINGS41Voicebot call settings
VOICEBOT_DATA_STORAGE_SETTINGS42Voicebot data storage settings
VOICEBOT_VAD_SETTINGS43Voicebot VAD settings
VOICEBOT_PHONE_NUMBER44Voicebot phone number
DOCUMENT_INSTRUCTIONS_CONFIG45Document instructions configuration
DOCUMENT_OUTLINE_SOURCE46Document outline source
STYLE_GUIDE_SOURCE47Style guide source
WORKFLOW_DYNAMIC_INPUTS48Workflow dynamic inputs
EMAIL_INTEGRATION_V249Email integration v2 (API-powered)
AGENT_QA_RULE_GENERATION50Agent QA rule generation
EMAIL_EMPLOYEE_INBOX_PREFERENCES51Email employee inbox preferences
DOCUMENT_APPROVAL52Document approval
TOOL_WIDGET53Custom tools widget (deprecated)
AGENT_QA_INSIGHT_GENERATION54Agent QA insight generation
TOOL_PERSONA_CONFIG55Tool persona configuration
RFP_EXTRACTED_FIELDS56RFP extracted fields

Complete list of WidgetType values from the proto definition. Note that value 37 is not assigned.

DisplaySettings

Controls how the AI Employee appears in the UI.

FieldTypeDescription
display_typeDisplayTypeDisplay mode for the persona UI
pagesrepeated DisplayPagePages shown for multi-page or tabbed displays

Complete list of DisplaySettings fields.

ProjectSettings

Project-level configuration for the AI Employee.

FieldTypeDescription
enabledboolWhether projects are enabled for this persona
display_namestringDisplay name used for projects in the UI
project_typeProjectTypeProject type associated with the persona
allowed_sub_projectsrepeated SubProjectAllowed sub-project categories
selected_sub_project_typeSubProjectTypeCurrently selected sub-project type
workflowsrepeated ProjectWorkflowProject workflows associated with the persona

Complete list of ProjectSettings fields.

PersonaTrigger

Defines how the AI Employee is triggered.

FieldTypeDescription
typePersonaTrigger.TriggerTypeOperational trigger source
integration_idstringIntegration ID used for data-ingestion triggers
triggerer_emailstringEmail address associated with the trigger when applicable

PersonaTriggerType Enum

ValueIntegerDescription
CHAT1Triggered by a chat conversation
DASHBOARD2Triggered by a dashboard row operation
THREAD3Triggered by a thread interaction
CHATBOT4Triggered by an external chatbot
DOCUMENT_GENERATION5Triggered by a document generation request
CONVERSATIONAL_EMAIL6Triggered by a conversational email interaction
AGENT_QA7Triggered by Agent QA evaluation

TemplateStatus Enum

ValueIntegerDescription
ACTIVE0Template is active
INACTIVE1Template is inactive

Last updated: Jul 3, 2026