Gen3 Admin Instructions Helper
- Look for the ? bubble fixed on the Control Panel shell (lower-right on most operator pages).
- Click ? to open the GT Helper help shelf—a focused chat surface for Control Panel product questions.
- Type a substantive operator question and send it; answers ground in the super-admin instructions wiki and current-page context when enabled.
- Use New question in the thread rail when you want a fresh conversation without deleting older threads.
- Open Instructions from the sidebar footer (book icon) or Full instructions in the help shelf when you need the full wiki drawer for long articles, search, and browse-and-read mode.
Control Panel operators manage deployment-wide settings that tenant users never see. GT Helper on the Control Panel gives Super Admins and other signed-in operators conversational wiki assistance against the super-admin instructions corpus (models, SSO, licenses, backup, helper usage, and related runbooks).
Use the ? shelf for multi-turn chat on the page you are on; use the Instructions drawer when you need to browse, search, or read full operator articles with screenshots.
| Surface | How to open | Best for |
|---|---|---|
| ? help shelf (GT Helper) | Fixed ? control on the Control Panel shell | Multi-turn GT Helper chat on the operator page you are on |
| Instructions | Sidebar footer → Instructions (book icon), or Full instructions in the help shelf | Wiki search, tree navigation, long-form reading, printing |
Both surfaces share the same super-admin instructions corpus. The help shelf is chat-only—it does not include wiki search, page suggestions, or Open page instructions controls. Use the Instructions drawer when you need those browse-and-read affordances.
Use the Float / Split toggle in the help shelf header to choose how the panel sits on screen.
- Float — A movable, resizable panel over the page (default on narrow viewports). Drag the header to reposition; use the resize handle on supported layouts.
- Split — Docks the shelf beside page content and shrinks the main column. Requires a viewport at least 900px wide; below that width, Split is unavailable and the shelf stays floating.
Your layout preference is remembered per browser session. When the Instructions drawer is open on a wide screen, Split can also dock the help shelf beside the drawer so you can read wiki articles and chat with GT Helper side by side.
The help shelf is a focused GT Helper chat surface:
- Multi-turn chat grounded in super-admin instructions wiki excerpts, optional current-page context, and prior threads.
- Include current page context (checkbox) — when enabled, sends the active Control Panel pathname so answers can reference what you are configuring.
Casual greetings (for example hi, thanks) receive a brief reply without wiki retrieval. Ask a substantive product question when you need grounded operator steps or configuration detail.
The left Prior GT Helper threads rail lists your saved helper conversations.
- New question — Starts a fresh thread without deleting older threads.
- Prior threads — Select a thread to reload its transcript; search and time filters narrow the list.
- Collapse the rail to hide thread history and show only Expand and New question above the chat pane, preserving full chat width.
Threads are per signed-in operator, not shared across accounts.
Before the model replies, the Control Panel API gathers excerpts from the super-admin wiki index:
- Corpus — all super-admin navigation articles (operator session auth still applies).
- Keyword match — title and body scored against your question.
- Route and topic injection — articles tied to your current Control Panel path and detected question topics are injected even when keyword scores are weak.
- Hybrid rank — keyword score plus route boost for page-relevant slugs.
Unlike the tenant app, passive ranking on the Control Panel does not incorporate query embedding in the rank—only keyword and route signals are used during passive retrieval.
Up to 20 excerpts may be included in the initial context.
When passive excerpts are missing or insufficient for a GT AI OS product question, the model may call search_instructions_wiki locally on the Control Panel API.
- The tool loop runs up to 5 rounds on the Control Panel service.
- Each round executes a super-admin corpus search and returns excerpts to the model.
- If the loop limit is reached without a final answer, a synthesis fallback turn instructs the model to answer from excerpts and tool results already in the conversation—using general knowledge only for non-product portions—and not to invent product steps.
Casual messages skip passive retrieval and tool calls.
| Question type | Source | Behavior |
|---|---|---|
| GT AI OS product behavior — Control Panel screens, routes, operator workflows, settings | Instructions wiki only | Answer from wiki excerpts and search_instructions_wiki results. Do not invent features or steps. |
| General knowledge — generic OIDC/SAML theory, markdown, industry concepts | General knowledge allowed | Clearly separated from GT AI OS-specific guidance. |
| Mixed questions | Both | General knowledge for non-product portions; wiki-backed guidance for GT AI OS portions. |
| Missing wiki evidence | None sufficient | State what is missing; suggest the Instructions drawer or a narrower question. |
Ask GT Helper requires a deployment default model:
- Open Models → Default Models.
- Set Default GT Helper model (
defaultInstructionsHelperModelId) to an enabled chat-capable model. - Save. Both tenant and Control Panel help shelves use this default.
When unset or invalid, helper chat returns 503 Service Unavailable with a configuration error.
Control Panel GT Helper traffic is not shown on the tenant Observability GT Helper tab.
Review operator help-shelf activity on CTP Helper Usage:
- Usage — aggregate threads, messages, inference tokens, top cited wiki topics, and top operators.
- Threads — searchable transcripts with page paths and source articles.
Inference burn is tagged with requestMode=instructions_helper.
Instructions Settings controls the optional external documentation link shown alongside the built-in Instructions drawer. It does not author the repo-backed wiki corpus that GT Helper searches.
- Models
- CTP Helper Usage
- Instructions Settings
- How to use GT Helper — tenant app help shelf documentation