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

# Administration

# 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@company.com
Members:
  - agent1@company.com
  - agent2@company.com
  - agent3@company.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)