> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Administration

Manage users, security, and platform settings for AI for Service.

***

## User Management

### Roles

| Role | Permissions |
| - | - |
| **Platform Admin** | Full platform access |
| **Bot Developer** | Create and manage virtual assistants |
| **Analyst** | View analytics and reports |
| **Agent** | Access agent console |
| **Supervisor** | Monitor agents and queues |

### User Enrollment

Add users to the platform:

1. Navigate to **Administration** → **Users**
2. Click **Add User**
3. Enter user details
4. Assign roles
5. Send invitation

### Team Management

Organize users into teams:

```yaml theme={null}
Team: Support Team
Manager: jane.doe@example.com
Members:
  - agent1@example.com
  - agent2@example.com
  - agent3@example.com
Queues:
  - Support
  - Billing
Skills:
  - customer_service
  - billing
```

***

## Security

### Single Sign-On

Configure SSO:

| Provider | Protocol |
| - | - |
| **Okta** | SAML, OIDC |
| **Azure AD** | SAML, OIDC |
| **Google** | SAML, OIDC |
| **Custom** | SAML 2.0, OIDC |

### API Security

| Feature | Description |
| - | - |
| **API Keys** | Authenticate API requests |
| **JWT Tokens** | Short-lived access tokens |
| **IP Allowlisting** | Restrict by IP address |
| **Rate Limiting** | Prevent abuse |

### Data Security

| Feature | Description |
| - | - |
| **Encryption at rest** | AES-256 |
| **Encryption in transit** | TLS 1.3 |
| **PII Redaction** | Automatic sensitive data handling |
| **Data retention** | Configurable retention policies |

***

## Bot Versioning

### Version Management

| Action | Description |
| - | - |
| **Create version** | Snapshot current configuration |
| **Compare versions** | Diff between versions |
| **Deploy version** | Promote to environment |
| **Rollback** | Revert to previous version |

### Environments

| Environment | Purpose |
| - | - |
| **Development** | Building and testing |
| **Staging** | Pre-production validation |
| **Production** | Live deployment |

### Deployment Flow

```
[Development] → [Staging] → [Production]
      ↓             ↓            ↓
   Testing     Validation    Live users
```

***

## Analytics & Reporting

### Built-in Dashboards

| Dashboard | Metrics |
| - | - |
| **Overview** | Conversations, users, containment |
| **Performance** | Response time, accuracy |
| **Intents** | Top intents, confidence |
| **Channels** | Usage by channel |

### Custom Reports

Build custom reports:

1. Navigate to **Analytics** → **Reports**
2. Click **Create Report**
3. Select dimensions and metrics
4. Apply filters
5. Choose visualization
6. Schedule delivery

### Data Export

Export data for external analysis:

* CSV/JSON export
* API access
* Streaming to data warehouse
* Scheduled exports

***

## Billing & Usage

### Usage Tracking

| Metric | Unit |
| - | - |
| **Conversations** | Per session |
| **Messages** | Per message |
| **Voice minutes** | Per minute |
| **API calls** | Per request |

### Billing Dashboard

View and manage:

* Current usage
* Billing history
* Usage forecasts
* Plan limits

***

## Audit Logs

### Logged Events

| Category | Events |
| - | - |
| **Authentication** | Login, logout, failed attempts |
| **Configuration** | Bot changes, deployments |
| **Data access** | Exports, API calls |
| **User management** | Role changes, invitations |

### Log Retention

Configure retention:

* Standard: 90 days
* Extended: 1 year
* Compliance: 7 years

### Export Logs

```yaml theme={null}
Audit Export:
  format: json
  destination: s3://audit-logs/
  schedule: daily
  include:
    - user_actions
    - system_events
    - api_calls
```

***

## Settings

### General Settings

| Setting | Description |
| - | - |
| **Timezone** | Default timezone for analytics |
| **Language** | Default bot language |
| **Branding** | Logo, colors |
| **Notifications** | Email, Slack alerts |

### Developer Settings

| Setting | Description |
| - | - |
| **API access** | Enable/disable API |
| **Webhooks** | Configure webhook endpoints |
| **Debug mode** | Enable detailed logging |
| **Test mode** | Sandbox for testing |

***

## Related

* [Getting Started](/ai-for-service/getting-started)
* [Channels](/ai-for-service/channels)
* [Integrations](/ai-for-service/integrations)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.