Skip to content

Settings

The Settings panel is accessible from the gear icon in Studio's navigation. It provides configuration for all Astonish subsystems.

Settings Sections

Personal Settings

These sections are available to all users:

SectionDescription
ChannelsConfigure communication channels (Telegram, Email, etc.)
KnowledgeBrowse and manage knowledge base files
CredentialsManage encrypted secrets (API keys, tokens, passwords)

Resource Settings

Manage reusable resources (available in personal/local mode):

SectionDescription
SkillsCLI tool skills available to the agent
SchedulerScheduled jobs and recurring tasks
RepositoriesGit repositories (taps) for skills and tools
Flow StoreBrowse and manage saved flows

System Settings

Admin-level configuration for the platform:

SectionDescription
GeneralCore platform settings
ChatChat behavior and defaults
ProvidersAI model provider configuration
MemorySemantic memory and embedding settings
MCP ServersModel Context Protocol server management
SessionsSession management and history
Sub-AgentsConfigure delegated sub-agent behavior
BrowserBrowser automation configuration
DaemonBackground service monitoring
SandboxContainer sandbox settings

Providers

Configure AI model providers:

SettingDescription
Provider nameOpenAI, Anthropic, Google, Azure, etc.
API keyAuthentication credential
Base URLCustom endpoint (for proxies or self-hosted models)
Default modelModel to use when none is specified

Multiple providers can be active simultaneously. Use the Model control in Chat (and in an open App's header) to pin a provider/model for that session or app. Team-wide defaults are still set here under Providers.

MCP Servers

Manage Model Context Protocol servers that extend agent capabilities:

  • Add server — Specify command, args, and environment variables
  • Enable/disable — Toggle servers without removing config
  • Tool list — View tools provided by each server
  • Refresh — Reconnect and reload tool definitions

Credentials

The credential store manages sensitive values (API keys, tokens, passwords) used by tools and integrations:

  • Credentials are encrypted at rest using envelope encryption
  • Add, edit, or remove credentials from this panel
  • Reference credentials in flows and tool configs by name

Browser

Settings for browser automation:

SettingDescription
HeadlessRun browser without visible window
Navigation timeoutMaximum time for page loads
ViewportDefault viewport dimensions
Chrome pathCustom Chromium binary path
ProxyHTTP proxy for browser traffic
Remote CDP URLConnect to an existing Chrome DevTools Protocol instance

Memory

Configure the semantic memory system for RAG (Retrieval-Augmented Generation):

SettingDescription
Enable MemoryToggle the memory system on/off
Memory DirectoryPath where memory markdown files are stored
Vector DirectoryPath for the vector index
Embedding ProviderProvider for generating embeddings (local, OpenAI, Ollama)
ChunkingMax characters and overlap for document splitting
Search DefaultsMax results and minimum score threshold
File WatcherAuto-index changes to memory files

Daemon

Monitor and control the background daemon:

  • HTTP Port — Port for Studio UI (default: 9393)
  • Log Directory — Where daemon logs are written
  • Studio Authentication — Enable/disable login and session TTL

Sandbox

Configure the container sandbox environment for agent tool execution:

  • Backend type (Incus for local, Kubernetes for cloud)
  • Resource limits (CPU, memory, processes)
  • Network policies — multi-tier allow/deny rules (platform, org, team) controlling which endpoints the sandbox can reach. See Network Policy.

Cloud Deployment: Admin Panels

In cloud deployments, additional panels appear for users with admin roles:

Team Admin

  • Manage team members and roles
  • Team-level provider configuration
  • Team MCP servers and skills
  • Team scheduler and flows
  • Container/sandbox settings per team

Org Admin

  • Manage organization users
  • Org-wide provider configuration
  • Org-level skills and MCP servers
  • Audit log viewer

Platform Admin (Superadmin)

  • Manage all organizations
  • Platform-wide user management
  • Global provider and skill configuration
  • Platform MCP servers and channels
  • Authentication settings
  • Sandbox infrastructure management