General Configuration

Overview

The General Configuration module controls global project behavior across both Development and Production environments. These settings govern timezone reporting, default UI languages, retention policies, and automated maintenance schedules.

Project Metadata & Identity

Every project maintains foundational metadata configured in Project > Settings:

• Project Name: The display title shown across the dashboard, telemetry reports, and billing invoices.

• Primary Domain: The canonical domain name where the primary assistant is deployed (e.g. https://asiyst.com).

• Organization Namespace: The multi-tenant workspace namespace that groups projects and manages team RBAC permissions.

Localization & Timezone Settings

• Default Timezone: Used to aggregate analytics intervals, schedule daily re-crawlers, and time-stamp conversation transcripts (e.g., America/Los_Angeles, Europe/London, Asia/Tokyo).

• Default Locale: Configures default fallback strings for the SDK widget (e.g., en-US, es-ES, fr-FR, ja-JP).

• Auto-Detection: When enabled, the SDK reads navigator.language from the visitor's browser to localize greeting chips automatically.

asiyst.config.json Schema Reference

Projects can be declared and version-controlled via asiyst.config.json in your repository root:

{
  "$schema": "https://asiyst.com/schemas/v1/config.json",
  "projectId": "proj_9f8a2b3c4d",
  "name": "Acme Marketing Assistant",
  "domain": "https://acme.com",
  "timezone": "America/New_York",
  "locale": "en-US",
  "ai": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet",
    "temperature": 0.2,
    "maxTokens": 800
  },
  "knowledge": {
    "collectionId": "col_acme_production_docs",
    "similarityThreshold": 0.72,
    "topK": 4
  },
  "dataRetentionDays": 90,
  "allowedDomains": [
    "https://acme.com",
    "https://www.acme.com",
    "http://localhost:3000"
  ]
}

Automated Maintenance Windows

Configure off-peak maintenance hours (e.g., Sundays at 03:00 UTC) for heavy vector re-indexing and database pruning to prevent any latency degradation during high-traffic hours.