# Context

Configure what this local assistant can use. These settings stay in this browser.

## Documents

Upload and manage local knowledge collections.

## Databases

Store SQL database artifacts locally for chat requests.

## Web

Use web search and fetch tools when the PrivateGPT backend has them configured.

### Backend configuration

Workbench does not store web provider credentials.

Configure the web search provider and API key in PrivateGPT's backend config. From the UI, enable Web in a chat's Tools menu to include the `web_search` and `web_fetch` tools in that request.

## MCP

Add MCP server configs passed to the messages API.

## Skills

Manage backend skills for the active collection and enable them in chat.

## Custom Tools

Define tool schemas and browser-executed JavaScript handlers.

## Code Execution

Manage files in the active chat's sandbox session. Enable Code Execution in the chat Tools menu to activate.

### No active code execution session

Open a chat and enable Code Execution from the Tools menu, then return here to manage session files.

# Settings

Configure the PrivateGPT API connection used by this browser.

## PrivateGPT API

Workbench talks only to PrivateGPT. LLM gateway settings belong in the PrivateGPT backend config.

PrivateGPT base URL
Authentication (HTTP Basic Auth)

Credentials are Base64-encoded and sent as an `Authorization` header on every request. Only enable if your PrivateGPT server requires Basic Auth. Stored only in this browser; debugger headers are always redacted.

Username
Password

## Chat defaults

Controls the system prompt and request-level features sent with every chat message.

System prompt Optional. Sent as the top-level system field on chat requests, not as a system role message.
Use citations Default prompt Enable thinking Code Execution
Extensions Comma-separated list of enabled extensions, e.g. `zylon`.

## Collection

Used for ingest, document list, delete, skill management, and search. Some deployments restrict collection IDs per bearer token.

Collection ID All Documents and Skills operations use this collection. Document-enabled chats search artifacts here.

## Look and feel

Describe the product surface you want, let PrivateGPT generate a theme, then fine-tune the result if needed.

Theme brief Use natural language. Mention brand personality, audience, tone, colors to lean into or avoid, and which features should stay visible.
Advanced overrides
Brand name
Welcome title
Welcome subtitle
Workspace instructions Use this to tailor tone, role, or domain guidance without changing backend config.

### Palette

These colors feed the workspace gradients, accents, and glass tints.
Accent Secondary Surface tint Background base

### Optional sections

Hide parts of the workbench when you want a narrower, simpler surface.
Databases Web MCP Skills Custom Tools API Debugger

## Local browser data

Clear this workbench's saved chats, settings, token, context, and preferences from this browser.

This does not delete data stored in PrivateGPT itself, such as ingested documents or backend configuration.

# API Debugger

Inspect API requests and responses made during this browser session.

## Timeline

Live trace for this session only. It clears when you refresh the page.
New chat

Local session

Guided setup

# Get this workspace ready in two short steps.

First, point the UI at PrivateGPT and verify the collection works. Then, if you want, tune the surface so the workbench feels closer to your product.

1. Connect PrivateGPT Base URL, collection, and a live check.
2. Customize appearance Optional colors, feature visibility, and instructions.

## Connection

Use the same PrivateGPT API URL and collection the rest of the workbench will rely on.

PrivateGPT base URL
Authentication (HTTP Basic Auth)

Credentials are Base64-encoded and sent as an `Authorization` header on every request. Only enable if your PrivateGPT server requires Basic Auth. Stored only in this browser; debugger headers are always redacted.

Username
Password
Collection ID

This check hits the same models, artifacts, and skills endpoints the main app uses.

## Customize the workbench

This step is optional. Describe the experience you want and let the model generate a starting theme, then adjust the result if needed.

Theme brief
Advanced overrides
Brand name
Welcome title
Welcome subtitle
Workspace instructions

### Colors

These update the same runtime CSS variables available later in Settings.
Accent Secondary Surface tint Background base

### Features

Use these toggles to simplify the workbench surface.
Databases Web MCP Skills Custom Tools API Debugger