Skip to content
Last updated

Core Concepts

WebDesktopMobile

Master four concepts — Projects, Models, Credits, and Context — and every Studio session becomes faster, cheaper, and more predictable.

Note

The AI automatically selects tools and manages context within a session. Understanding these concepts lets you guide it more effectively, not replace its decision-making.

Objective

Equip users with the mental model needed to structure their work: scope a project, choose the right model tier, manage credit spend, and keep long conversations productive.

Prerequisites

  • Signed in to Treasure AI Studio (Getting Started)
  • AI Credits provisioned for your account

Projects

A project saves your working context so you don't repeat yourself across conversations. Think of it as a preset that loads your preferences and skills every time you start a new chat.

Each project includes:

FieldWhat It Does
NameIdentifies the project in the sidebar and project switcher
DirectoryA slug (lowercase letters, numbers, hyphens) used internally. Cannot be changed after creation
InstructionsCustom rules the AI follows — coding conventions, preferred databases, output formats
SkillsSkills that are always active in this project's chats
TD contextDefault database, table, or segment the AI uses when none is specified

Example: A "CDP Ops" project might activate segment and journey skills and include instructions like "Always validate YAML before pushing. Use the marketing database by default."

Web & Desktop

Projects appear in the PROJECTS section of the sidebar with a count in parentheses (e.g., "PROJECTS (3)"). Click the folder-plus icon next to the header to create a new project — a Create Project dialog appears asking for Name and Directory.

Sidebar showing Projects and Chats sections with user info

Mobile (iOS)

Projects appear on the home screen in a collapsible PROJECTS section. Each project row shows its chat count. Tap a project to view its chats, or tap the floating action button to start a new chat.

Technical Note

Project configurations are stored server-side and sync across all your platforms. A project created on Web is immediately available on Desktop and Mobile.

AI Models

Studio supports three AI model tiers. You can switch models mid-conversation — useful for starting with Fast for quick exploration, then switching to Pro for the complex part. Switching models restarts the AI session. Your conversation history is preserved, but the AI re-initializes with the new model.

UI LabelModelDescription (from UI)When to Use
ProClaude Opus 4.6"Complex reasoning and analysis"Multi-step data analysis, building segment rules, writing workflows
BalancedClaude Sonnet 4.6"Fast and capable"General-purpose work — the default model for new conversations
FastClaude Haiku 4.5"Quick tasks and simple questions"Quick lookups, simple questions, conserving credits

Web & Desktop

Click the model selector dropdown in the chat input area to switch. The current model label (e.g., "Balanced") is shown.

Model selector dropdown showing Pro, Balanced, and Fast options

Mobile (iOS)

Tap the model label in the chat input area to switch between available models.

Pro Tip

Switch to Fast for simple lookups like "list my databases" or "How many rows in this table?" — it answers in seconds and uses far fewer credits. Reserve Pro for multi-step analysis, complex segment logic, and workflow generation.

AI Credits

Each AI interaction consumes credits. The amount depends on which model you use and how much the AI processes (longer conversations and tool-heavy sessions cost more).

Model TierRelative Cost
ProHighest
BalancedMedium
FastLowest

Contact your Customer Success Manager to check your credit allocation or request additional credits.

Context Window

The context window is how much conversation the AI can "remember" at once. As you chat, the context fills up. When it gets close to the limit, Studio's auto-compact feature kicks in — it summarizes older messages to free up space without losing important context. Your conversation continues normally.

You can also manage context manually with these commands in the chat:

CommandAction
/contextSee detailed context usage breakdown
/compactSummarize the conversation to free up space
/clearClear the context entirely and start fresh

For best results on long-running work, use projects to carry context across multiple chats rather than pushing a single conversation to its limit.

In-Session Memory

Within a single conversation, the AI remembers everything discussed — questions asked, data explored, decisions made. This in-session memory lets you build on previous messages naturally:

  • "Now filter that to just the US region" (references a previous query)
  • "Add those users to the segment we defined earlier" (references a previous segment definition)
  • "Export that as a PowerPoint" (references a previous chart or analysis)
Note

In-session memory (the AI's context window) does not persist across separate conversations. However, the AI can read and write memory files that persist across sessions within the same project. Project instructions also carry forward automatically. See In-Session Memory for details.

Chat History

All conversations are saved automatically and sorted by most recent activity.

Web & Desktop

Chats appear in the sidebar — under their parent project in the PROJECTS section, or in the standalone CHATS section. The search bar (placeholder: "Search chats...") filters chats by title. Use Cmd+O to open chat search.

Sidebar showing chat history items sorted by recency

Mobile (iOS)

The home screen shows a Recent Chats entry with a count of standalone conversations. Tap it to see the full list. Chats within a project are visible when you tap into that project.

Technical Note

Chat history is stored server-side, so your conversations are available on any platform you sign into. Treasure Studio Labs stored chats locally on disk — this is no longer the case.

Auto-Titling

Studio automatically generates a descriptive title for each conversation. Titles appear in the sidebar chat list to help you find past conversations.

Web & Desktop

To rename a conversation, right-click a chat in the sidebar and select Rename Chat. To delete, select Delete Chat.

Mobile (iOS)

Long-press a chat to access rename and delete options.

Settings

Access settings from the user avatar in the sidebar footer (Web/Desktop) or the user icon in the top-left header (Mobile).

Web & Desktop

Settings open as a centered modal with tabs on the left sidebar:

TabLabelContents
GeneralGeneralLanguage (English, 日本語), Timezone (searchable picker), Auto Update toggle (desktop only)
AppearanceAppearanceTheme preview cards: Light, Dark, System
ProfileProfileUser email, identity provider, region + Account ID, Sign Out button
Network Audit LogNetwork Audit LogNetwork activity log viewer with time range and filters (admin-only, under "Organization" section)

The bottom-left corner shows the app version: "Treasure AI Studio v0.1.0".

Settings panel showing General tab with Language, Timezone, and Default Model optionsSettings panel showing Appearance tab with Light, Dark, and System theme options

Mobile (iOS)

Settings open as a bottom sheet (drag-to-dismiss). Tap a row to navigate to its sub-page:

RowIconContents
LanguageGlobeEnglish or 日本語 (checkmark on current selection)
AppearanceMoonSystem, Light, or Dark (checkmark on current selection)
TimezoneClockSearchable timezone picker
Sign OutLogOut (red)End your session

The footer shows the app version.

Verification

  • Create a project with instructions and an active skill
  • Switch between Pro, Balanced, and Fast models during a conversation
  • Use /context to check your context usage and /compact to free space

Troubleshooting

IssueSolution
Cannot create a new projectVerify you have an active Treasure AI account with AI Studio access. On Mobile, projects are managed on Web/Desktop
Model selector not visibleThe model selector appears in the chat input area on Web and Desktop. On Mobile, the default model is used automatically
/context returns no outputContext tracking requires an active conversation. Send at least one message before checking context usage

Next Steps