---
schema_version: "1"
id: aff5a1c8fd8bd1ec53b8c5eb4fd41c29aadb02ccb3ad035e78437251df7ef985
title: iOS Data Models Overview
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/genai/agentforce-mobile-sdk/references/ios/data-models-overview-ios.md
canonical_url: https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/data-models-overview-ios.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 5be2721c5af7af4124fe3bb4d73f3fef9031b5445e31dd0bda25a0ec1877c17c
products:
  - Agentforce Mobile SDK
  - Agentforce and Einstein Generative AI
---
# iOS Data Models Overview

The Agentforce iOS SDK provides a comprehensive data modeling system that handles all aspects of conversational AI data, from Salesforce object metadata to participant interactions. The data models are designed to provide type-safe, efficient access to conversation data while maintaining compatibility with Salesforce's data structures.

## Data Model Architecture

The data modeling system is organized into several key categories that work together to provide a complete data representation layer:

### Core Data Models

- **[AgentforceObjectRepresentation](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-object-representation-ios.md)** - Salesforce object metadata including labels, fields, and theme information
- **[AgentforceRecordRepresentation](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-record-representation-ios.md)** - Individual record data with field values and relationships
- **[AgentforceUIApiRecord](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-record-ios.md)** - UI-optimized record handling for display components
- **[AgentforceUIApiRecordCollection](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-record-collection-ios.md)** - Collection management for multiple records
- **[AgentforceUIApiFields](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-fields-ios.md)** - Comprehensive field definitions with metadata and validation rules
- **[AgentforceUIApiFieldValues](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-field-values-ios.md)** - Field value handling with type safety and formatting
- **[AgentforceUIApiObjectInfo](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-object-info-ios.md)** - Complete object information including relationships and capabilities
- **[AgentforceUIApiRecordTypeInfo](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-ui-api-record-type-info-ios.md)** - Record type metadata for specialized record handling

### Interaction Models

- **[ParticipantAction](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/participant-action-ios.md)** - Individual participant actions and behaviors
- **[ParticipantInteraction](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/participant-interaction-ios.md)** - Participant interaction patterns and sequences
- **[EscalationAction](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/escalation-action-ios.md)** - Escalation workflow actions and triggers

## Data Model Categories

### Object and Record Management

The SDK provides comprehensive support for Salesforce data structures:

#### Object Representation

- **Metadata Management**: Complete object metadata including labels, descriptions, and capabilities
- **Field Definitions**: Detailed field information with types, validation rules, and display properties
- **Relationship Mapping**: Object relationships and reference handling
- **Theme Integration**: Visual theming information for object display

#### Record Handling

- **Data Access**: Efficient access to record data with type safety
- **Field Values**: Comprehensive field value management with proper typing
- **Collection Support**: Bulk record operations and collection management
- **UI Optimization**: Record data optimized for display in UI components

### Interaction Tracking

The system provides detailed tracking of conversation interactions:

#### Participant Management

- **Action Tracking**: Monitor individual participant actions and behaviors
- **Interaction Patterns**: Analyze interaction sequences and patterns
- **Status Management**: Track participant status and availability
- **Role Management**: Handle different participant roles and permissions

#### Escalation Handling

- **Escalation Triggers**: Automatic and manual escalation triggers
- **Workflow Management**: Escalation workflow state and progression
- **Agent Handoff**: Seamless handoff between different agent types
- **Status Tracking**: Monitor escalation status and resolution

## Data Model Benefits

### Type Safety

- **Compile-Time Validation**: Type-safe access to all data structures
- **Null Safety**: Proper handling of optional values and null states
- **Type Inference**: Automatic type inference for improved developer experience

### Performance

- **Efficient Access**: Optimized data access patterns for UI components
- **Memory Management**: Efficient memory usage for large data sets
- **Caching**: Intelligent caching of frequently accessed data

### Integration

- **Salesforce Compatibility**: Full compatibility with Salesforce data structures
- **API Integration**: Seamless integration with Salesforce APIs
- **Custom Extensions**: Support for custom data extensions and modifications

## Usage Patterns

### Basic Object Access

Access object metadata and field information using the comprehensive data model classes.

### Record Operations

Work with record collections and individual record data using the optimized data models.

### Interaction Tracking

Track participant actions and interactions using the specialized interaction models.

## Best Practices

- **Use Type-Safe Access**: Leverage the type-safe data models for reliable data access
- **Handle Optional Values**: Properly handle optional values and null states
- **Optimize for UI**: Use UI-optimized models for display components
- **Cache Frequently Used Data**: Implement caching for performance-critical data
- **Monitor Performance**: Track data access patterns and optimize as needed

## Next Steps

- **UI Components**: See [iOS UI Components](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/ui-components-ios.md) for data model integration
- **Configuration**: See [iOS Configuration Overview](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/configuration-overview-ios.md) for data provider setup
- **Integration**: See [iOS Development](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/development-ios.md) for architecture patterns