Dokumentacja / Podstawowe pojęcia

Staging AI

Opisz w panelu czatu Staging AI obszar roboczy, jakiego chcesz — oznaczaj przez @ konkretne aplikacje, okna, Stage lub monitory — a AI przeanalizuje otwarte okna (tytuły, adresy URL, ścieżki plików) i zaproponuje plan Stage, który możesz przejrzeć, dopracować, zastosować lub cofnąć jednym krokiem (Cmd-Z w panelu). Korzystaj z niego z własnym kluczem dostawcy AI na licencji Pro lub z BetterStage AI — zarządzaną subskrypcją, która nie wymaga klucza API ani konfiguracji.

Jak to działa

Staging AI skanuje wszystkie otwarte okna na wszystkich monitorach, zbiera metadane (nazwę aplikacji, tytuł okna, ścieżkę dokumentu, adres URL) i wysyła je do modelu AI — Twojego własnego dostawcy (z Twoim kluczem API) lub do zarządzanej usługi BetterStage, jeśli subskrybujesz BetterStage AI. Model zwraca plan, który tworzy nazwane Stage i przypisuje każde okno do właściwego Stage i monitora.

  1. Skanowanie — BetterStage odczytuje tytuły okien, ścieżki dokumentów, adresy URL i nazwy aplikacji wszystkich otwartych okien.
  2. Analiza — dane trafiają do dostawcy AI — Twojego własnego lub zarządzanej usługi BetterStage w ramach subskrypcji BetterStage AI. Panel czatu na bieżąco pokazuje postęp, a proponowane akcje pozostają dołączone do odpowiedzi asystenta.
  3. Przegląd i zastosowanie — powstają nowe Stage, a każde okno zostaje przypisane do właściwego monitora w każdym Stage. BetterStage wybiera też dla każdego monitora tryb okna — Ulepszony tryb natywny lub TabStack — dopasowany do zgrupowanych tam okien, a w prośbie możesz wskazać konkretny tryb. Plan możesz dopracować przed zastosowaniem, a zastosowane zmiany później cofnąć.

Uruchamianie Staging AI

Staging AI można uruchomić na cztery sposoby:

  • Skrót klawiszowy — naciśnij Opt+Z (układ europejski: Ctrl+Opt+Z) lub własny skrót z Ustawienia > Skróty.
  • Pasek menu — kliknij ikonę BetterStage na pasku menu i wybierz Staging AI…
  • Koło przyciągania — otwórz Koło przyciągania i wybierz Staging AI z podmenu Obszar roboczy.
  • Ustawienia — otwórz Ustawienia > Staging AI, skonfiguruj dostawcę i uruchom stamtąd.

Konfiguracja dostawcy

Z własnym kluczem API Staging AI komunikuje się bezpośrednio z Twoim dostawcą, a żadne dane nie przechodzą przez serwery BetterStage. (Przy subskrypcji BetterStage AI żądania są natomiast kierowane przez zarządzaną usługę BetterStage — klucz nie jest potrzebny). Dostawcę skonfigurujesz w Ustawienia > Staging AI. BetterStage zawiera 25 presetów dostawców: OpenAI, Claude (Anthropic), Google Gemini, OpenRouter, Groq, Together AI, Mistral, xAI (Grok), DeepSeek, Moonshot (Kimi), Zhipu (GLM), Alibaba Qwen, MiniMax, Tencent Hunyuan, ByteDance Doubao, NVIDIA NIM, Hugging Face, Azure OpenAI i inne — w tym serwery lokalne, takie jak Ollama i LM Studio.

  • Aktualne listy modeli — wybierz preset, a BetterStage pobierze modele, z których Twój klucz faktycznie może korzystać.
  • Wybór regionu — dostawcy z regionalnymi punktami końcowymi (Qwen, Moonshot, Zhipu, MiniMax, SiliconFlow) pozwalają przełączać się między chińskimi i międzynarodowymi bazowymi adresami URL.
  • Klucze API dla każdego dostawcy — każdy dostawca pamięta własny klucz, więc zmiana presetu nigdy nie powoduje utraty klucza.
  • Własny punkt końcowy — preset Niestandardowy (zgodny z OpenAI) przyjmuje dowolny bazowy adres URL i nazwę modelu, np. serwera proxy lub serwera na własnym sprzęcie.
DostawcaModel domyślnyUwierzytelnianie
OpenAIgpt-4.1-miniKlucz API (token Bearer)
Claude (Anthropic)claude-sonnet-4-6Klucz API (nagłówek x-api-key)
Ollama (lokalnie)Twój zainstalowany modelBrak (localhost)
Niestandardowy (zgodny z OpenAI)dowolnyKlucz API (token Bearer)

Pozostałe 22 presety działają według tego samego schematu zgodnego z OpenAI, z wstępnie wypełnionym bazowym adresem URL i modelem domyślnym.

Testuj połączenie

Ustawienia > Staging AI zawierają przycisk Testuj połączenie, który wysyła prawdziwą wiadomość czatu do skonfigurowanego modelu — dzięki temu wiesz, że punkt końcowy, klucz i model naprawdę działają, zanim zaczniesz na nich polegać. Problemy z konfiguracją są wychwytywane przed wysłaniem żądania i sygnalizowane czytelnym komunikatem z przyciskiem Otwórz Ustawienia zamiast surowego błędu dostawcy.

Zapisane Recipe

Recipe to zapisane instrukcje opisujące, jak ma być urządzony Twój obszar roboczy. Trzymaj osobne Recipe dla różnych sposobów pracy — programowania, przeglądu projektów, wsparcia, pisania czy czegokolwiek innego, co powtarzasz. Panel Staging AI pozwala przełączać Recipe, tworzyć nowe, duplikować istniejące lub zmieniać ich nazwy, usuwać stare i wybierać domyślne Recipe dla nowych sesji.

Wybrane Recipe jest dołączane przy uruchamianiu Staging AI. Edytuj je za pomocą tych samych oznaczeń @ co w czacie (monitory, Stage, okna, aplikacje i tryby okna), podejrzyj dokładny prompt wysyłany do modelu i uruchom rozmieszczanie prosto z panelu.

Przykładowe notatki w Recipe:

  • „Komunikatory i muzykę umieść na małym monitorze bocznym. Karty przeglądarki z dokumentacją projektu trzymaj obok edytora”.
  • „Zawsze twórz Stage Comms dla Slacka, Discorda i poczty”.
  • „Gdy to możliwe, grupuj według nazwy klienta”.

Jakie dane są wysyłane

Staging AI wysyła do modelu AI migawkę obszaru roboczego. Z własnym kluczem API trafia ona bezpośrednio do Twojego dostawcy i serwery BetterStage nigdy jej nie widzą; przy subskrypcji BetterStage AI jest kierowana przez zarządzaną usługę BetterStage. Migawka zawiera:

  • Metadane okien — nazwa aplikacji, tytuł okna, ścieżka pliku dokumentu, adres URL zawartości (host + ścieżka)
  • Układ monitorów — nazwy ekranów, kolejność rozmieszczenia, granice obszaru, status główny/dodatkowy
  • Ograniczenia systemowe — maksymalna liczba Stage, maksymalna liczba okien na Stage

Nie są wysyłane zawartość plików, zrzuty ekranu ani naciśnięcia klawiszy. Tytuły okien, ścieżki plików i adresy URL mogą jednak zawierać poufne nazwy projektów lub dokumentów, więc wybierz dostawcę, któremu ufasz.

Wymagania

  • Licencja Pro — Staging AI to funkcja Pro.
  • Dostawca AI — własny klucz API do jednego z 25 obsługiwanych dostawców (lub dowolnego punktu końcowego zgodnego z OpenAI) albo subskrypcja BetterStage AI, która uruchamia AI za Ciebie, bez klucza.
  • Połączenie z internetem — wymagane dla dostawców chmurowych. Serwery lokalne (Ollama, LM Studio) działają offline.