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

# Configuration Overview

> Understanding Moss configuration options and priority system

## Introduction

Moss SDK can be configured in multiple ways to fit your application's needs. This flexibility allows you to set sensible defaults while giving developers fine-grained control per user or session.

### Configuration Methods

| Method                 | Use Case                                                    | Priority |
| ---------------------- | ----------------------------------------------------------- | -------- |
| **Dashboard Settings** | Application-wide defaults, security policies                | Lowest   |
| **SDK Configuration**  | Per-deployment customization, environment-specific settings | Highest  |

## Configuration Priority

When the same setting is configured in multiple places, Moss uses this priority order (highest to lowest):

1. **SDK configuration** - `AgentProvider` config options
2. **Dashboard settings** - Application-level defaults

<Info>
  This priority system allows you to set sensible defaults in the Dashboard
  while giving developers the ability to override specific settings in code.
</Info>

### Example: Priority in Action

```tsx theme={null}
// Dashboard setting: language = 'en'
// SDK configuration overrides it:
<AgentProvider config={{
  apiUrl: 'https://moss-api.viamoss.ai',
  applicationId: 'YOUR_APP_ID',
  userId: currentUser.id,
  getJwt: () => fetchMossToken(),
  language: 'ko',  // This takes precedence over Dashboard
}}>
  <AssistantButton />
</AgentProvider>
```

## Quick Reference

### Dashboard-Only Settings

These settings can only be configured through the Dashboard:

* AI Assistant Instructions
* API Keys
* Domain Access Control
* Vector Store Configuration
* Planning

### SDK-Configurable Settings

These settings can be set in Dashboard and overridden via SDK:

| Setting           | Dashboard | SDK Config |
| ----------------- | --------- | ---------- |
| Language          | Yes       | Yes        |
| Enable Vision     | Yes       | Yes        |
| Session Recording | Yes       | Yes        |
| Screen History    | Yes       | Yes        |
| Session Timeouts  | Yes       | Yes        |
| Screenshot Mode   | Yes       | Yes        |
| Log Level         | Yes       | Yes        |
| Debug Mode        | Yes       | Yes        |
| DOM Stability     | Yes       | Yes        |

## Next Steps

<CardGroup cols={3}>
  <Card title="Dashboard Settings" icon="browser" href="/en/configurations/dashboard-settings">
    Configure application defaults through the web UI
  </Card>

  <Card title="SDK Options" icon="code" href="/en/configurations/sdk-options">
    Customize behavior in your application code
  </Card>

  <Card title="Examples" icon="lightbulb" href="/en/configurations/examples">
    See complete configuration examples
  </Card>
</CardGroup>