Configuration & Security

Account Settings

Customize your interface, manage tokens, secure your account, and configure integrations all in one place

Table of Contents
  1. Settings Overview
  2. Profile
  3. Appearance
  4. Chat Defaults
  5. Security
  6. API Keys
  7. Usage & Billing
  8. MCP Servers
  9. Integrations
  10. Data & Privacy
  11. Widgets
  12. Prompt Logs

Settings Overview

Accessing Settings

Open Settings from the bottom of the left sidebar by clicking Settings. Settings are organized into eleven tabs in the left panel:

  • Profile — Personal info, custom intro prompt, and password
  • Appearance — Theme, timestamps, chat width, and display toggles
  • Chat Defaults — Default model, temperature, persona, and datasets
  • Security — MFA, CAC/Smart Card, and YubiKey registration
  • API Keys — Create and manage API keys
  • Usage & Billing — Token usage and subscription plan
  • MCP Servers — Add and manage Model Context Protocol servers
  • Integrations — Connect Google, GitHub, and Microsoft accounts
  • Data & Privacy — Review recent login history and jump to your prompt logs
  • Widgets — Opens the embeddable Widgets configuration page
  • Prompt Logs — Opens your prompt/response log history

Profile

Profile Information

Update your personal details including First Name, Last Name, Company, and Phone. Your email address is displayed but cannot be changed directly.

Email Address: For security reasons, email addresses cannot be changed self-service. To update your email, contact the Ask Sage team at support@asksage.ai.

Custom Intro Prompt

The Custom Intro Prompt field (800 character limit) is added to the system prompt of every chat to personalize responses — tone, role, and preferences. It is saved to your account and applied to all new and existing conversations until you change or clear it.

Important: Avoid including sensitive or mission-specific details in the Custom Intro Prompt — it will influence every response across all chats. Use Clear prompt to remove it at any time.

Change Password

Scroll down within the Profile tab to access the Change Password section and update your account password.


Appearance

Display & Theme Options

The Appearance tab controls how the Ask Sage interface looks and behaves. Most options are simple toggles; Chat Width is a multi-option selector.

Dark Mode

Switch between dark and light theme

Show Timestamps

Show timestamps on messages

Auto Name Chats

Automatically name chats based on the first message

Expand Chat Names

Show full chat names in the sidebar instead of truncated titles

Show Classification Indicator

Display the CUI/Unclassified badge near the chat input

Inline Citation Chips

Render numbered chips inline next to each cited claim. When off, citations only appear in the Sources section below the response

Chat Width

Choose Standard, Wide, or Full to control how wide the chat messages and input stretch across the screen


Chat Defaults

Default Chat Configuration

Chat Defaults set the starting configuration applied to every new conversation. Individual settings can still be overridden per-chat from the chat toolbar.

Default Model

The AI model used for new conversations. Select from all available models in the dropdown

Temperature

Controls randomness. Slide toward Precise for focused outputs or Creative for more varied responses

Default Persona

The persona applied to new conversations by default

Default Datasets

Datasets automatically included in new conversations

Long Paste as Chip

When on, large pastes collapse into a "Pasted" chip you can click to view or edit. Turn off to paste raw text directly into the input

Allow Auto to Switch Models Mid-Conversation

When on, Auto picks the best model for each message. When off, Auto picks a model on your first message and reuses it for the rest of the conversation


Security

Security Login Features

The Security tab lets you register additional authentication methods to protect your account. Three options are available:

Multi-Factor Authentication (MFA)

Add an extra layer of security with a time-based one-time password (TOTP). Click Setup MFA and use an authenticator app such as Microsoft Authenticator or Google Authenticator

CAC / Smart Card

Register your Common Access Card or smart card for certificate-based authentication. Automatically enables CUI dataset classification

YubiKey / Security Key

Register a YubiKey or other hardware security key for authentication. Click Register to add your device


API Keys

API Key Management

Generate and manage API keys for authenticating with the Ask Sage API. Enter a name in the Enter API key name... field, optionally restrict it to one or more scopes, and click + Create Key to generate a new key.

API Keys tab in Settings, showing the key name field, scopes dropdown, and Create Key button

Each key in the list shows a masked value and four action icons:

  • Show — Reveal the full key value
  • Copy — Copy the key to clipboard
  • Revoke — Disable the key without deleting it
  • Delete — Permanently remove the key

API Key Scopes

By default, a new key has full access to the Ask Sage API. To limit what a key can do, select one or more scopes before creating it — the key will only be able to call endpoints covered by the selected scopes.

Scope Grants access to
query Core chat and completion endpoints, such as /query and /query_with_file
plugins Plugin discovery and execution endpoints, such as /get-plugins and /execute-plugin
mcp MCP server management endpoints, such as adding, listing, and removing MCP servers
passthrough Ask Sage's OpenAI/Anthropic-compatible passthrough proxy, used when configuring Ask Sage as a custom model provider in third-party tools
agent_builder Triggering Agent Builder workflows programmatically via POST /execute-agent
Tip: Scopes can be combined on a single key. If no scopes are selected, the key keeps full access to every endpoint.
API Documentation: Links to the full API Docs and your account domain are shown at the bottom of the API Keys tab. To learn more about using the Ask Sage API, visit: Ask Sage API Documentation

Usage & Billing

Token Usage & Subscription

The Usage & Billing tab shows your current subscription plan, token reset date, and real-time token consumption with progress bars for each token type.

Current Plan

Displays your active subscription (e.g., enterprise) and the next token reset date. Click Manage Subscription to update your plan

Inference Tokens

Shows tokens used vs. total available for inference (prompt and response generation), with a progress bar and percentage used

Training Tokens

Shows tokens used vs. total available for training workloads, with a progress bar and percentage used

Enterprise Accounts: If you are part of an enterprise account, contact your Ask Sage administrator to increase your token volume. To learn more about tokens, visit Ask Sage Tokens. To manage your subscription, visit Subscription Management.
Org-Pooled Tokens: Some enterprise accounts draw from a shared organizational pool instead of per-user Inference/Training allowances. On these accounts, the Inference Tokens and Training Tokens cards above are replaced with a single notice: "Your org manages token allocation — see your org admin for pool status. Personal monthly token limits do not apply." The Current Plan card (plan name, reset date, Manage Subscription) still displays normally either way.

MCP Servers

Model Context Protocol Servers

The MCP Servers tab is where you add and manage Model Context Protocol servers that extend the AI with external tools and data sources. Click + Add Server to configure a new MCP connection.

Security Warning: MCP servers can access external systems. Only add servers you trust. Contact support@asksage.ai if you have questions.
Learn More: To learn more about MCPs and how to use them within Ask Sage, visit: Model Context Protocols (MCPs)

Integrations

Third-Party Integrations

Connect external accounts to access files and services directly within Ask Sage. Click Connect next to any integration to authorize it:

Google

Connect your Google account for Drive and Calendar access

GitHub

Connect your GitHub account for repository access

Microsoft

Connect your Microsoft account for OneDrive and Teams access


Data & Privacy

Data & Privacy

Recent Logins

A log of your recent login activity, showing the Date & Time, Status (Success or failure), and a Comment column for each login event. Use this to monitor for unexpected access to your account.

A View Prompt Logs button at the bottom of the panel links to your prompt/response log history (see Prompt Logs below).


Widgets

Embeddable Widgets

The Widgets tab opens a separate page (indicated by the external-link icon) for configuring embeddable Ask Sage widgets, such as the SharePoint widget, that surface Ask Sage capabilities inside third-party tools.


Prompt Logs

Prompt & Response Logs

The Prompt Logs tab opens a separate page (indicated by the external-link icon) showing a history of your prompts and responses, useful for auditing past usage.



Back to top

Copyright © 2026 Ask Sage Inc. All Rights Reserved. Ask Sage is a BigBear.ai company.