Documentazione / Concetti di base

Staging IA

Descrivi lo spazio di lavoro che vuoi nel pannello di chat di Staging IA — menziona con @ app, finestre, Stage o monitor specifici — e l'AI analizza le finestre aperte (titoli, URL, percorsi dei file), poi propone un piano di Stage che puoi esaminare, perfezionare, applicare o annullare in un solo passaggio (Cmd-Z nel pannello). Usalo con la chiave del tuo provider AI su una licenza Pro, oppure con BetterStage AI — un abbonamento gestito che non richiede chiavi API né configurazione.

Come funziona

Staging IA analizza ogni finestra aperta su ogni monitor, raccoglie i metadati (nome dell'app, titolo della finestra, percorso del documento, URL) e li invia a un modello AI — il tuo provider (con la tua chiave API) oppure il servizio gestito di BetterStage se sei abbonato a BetterStage AI. Il modello restituisce un piano che crea Stage con nome e assegna ogni finestra allo Stage e al monitor giusti.

  1. Analisi — BetterStage legge titoli delle finestre, percorsi dei documenti, URL e nomi delle app di ogni finestra aperta.
  2. Elaborazione — I dati vengono inviati al provider AI — il tuo, oppure il servizio gestito di BetterStage con un abbonamento BetterStage AI. Il pannello di chat mostra l'avanzamento in tempo reale e mantiene le azioni proposte associate alla risposta dell'assistente.
  3. Revisione e applicazione — Vengono creati i nuovi Stage e ogni finestra viene assegnata al monitor giusto in ogni Stage. BetterStage sceglie anche una Modalità finestra per ogni monitor — Native avanzata o TabStack — in base a ciò che vi è raggruppato, e nella richiesta puoi chiedere una modalità specifica. Puoi perfezionare il piano prima di applicarlo e annullare in seguito l'intera serie di modifiche applicate.

Avviare Staging IA

Ci sono quattro modi per eseguire Staging IA:

  • Scorciatoia da tastiera — Premi Opt+Z (layout Europeo: Ctrl+Opt+Z) o la scorciatoia che hai impostato in Impostazioni > Scorciatoie.
  • Barra dei menu — Fai clic sull'icona di BetterStage nella barra dei menu e seleziona Staging IA…
  • Ruota Snap — Apri la Ruota Snap e scegli Staging IA dal sottomenu Spazio di lavoro.
  • Impostazioni — Apri Impostazioni > Staging IA per configurare il provider, poi avvialo da lì.

Configurazione del provider

Con la tua chiave API, Staging IA comunica direttamente con il provider e nessun dato passa dai server di BetterStage. (Con un abbonamento BetterStage AI, invece, le richieste passano dal servizio gestito di BetterStage — nessuna chiave necessaria.) Configura il provider in Impostazioni > Staging IA. BetterStage include 25 preset di provider: 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 e altri — compresi server locali come Ollama e LM Studio.

  • Elenchi di modelli aggiornati — scegli un preset e BetterStage recupera i modelli che la tua chiave può effettivamente usare.
  • Selettore di regione — i provider con endpoint regionali (Qwen, Moonshot, Zhipu, MiniMax, SiliconFlow) ti permettono di passare dall'URL di base per la Cina a quello internazionale.
  • Chiavi API per provider — ogni provider ricorda la propria chiave, così cambiare preset non te ne fa mai perdere una.
  • Endpoint personalizzato — il preset Personalizzato (compatibile OpenAI) accetta qualsiasi URL di base e nome di modello, ad esempio un proxy o un server self-hosted.
ProviderModello predefinitoAutenticazione
OpenAIgpt-4.1-miniChiave API (token Bearer)
Claude (Anthropic)claude-sonnet-4-6Chiave API (intestazione x-api-key)
Ollama (locale)il modello installatoNessuna (localhost)
Personalizzato (compatibile OpenAI)qualsiasiChiave API (token Bearer)

Gli altri 22 preset seguono lo stesso schema compatibile con OpenAI, con URL di base e modello predefinito già compilati.

Verifica connessione

Impostazioni > Staging IA include un pulsante Verifica connessione che invia un vero messaggio di chat al modello configurato — così sai che endpoint, chiave e modello funzionano davvero prima di affidarti a loro. I problemi di configurazione vengono rilevati prima della richiesta, con un messaggio chiaro e un pulsante Apri Impostazioni invece di un errore grezzo del provider.

Recipe salvate

Le Recipe sono istruzioni salvate su come organizzare il tuo spazio di lavoro. Tieni Recipe separate per flussi di lavoro diversi — programmazione, revisione del design, assistenza, scrittura o qualsiasi altra attività ricorrente. Il pannello di Staging IA ti permette di cambiare Recipe, crearne una nuova, duplicarne o rinominarne una esistente, eliminare quelle vecchie e scegliere una Recipe predefinita per le nuove sessioni.

La Recipe selezionata viene inclusa quando esegui Staging IA. Modificala con gli stessi chip di menzione @ della chat (monitor, Stage, finestre, app e Modalità finestra), visualizza in anteprima il prompt esatto inviato al modello ed esegui una disposizione direttamente dal pannello.

Esempi di note per una Recipe:

  • «Metti le app di chat e la musica sul piccolo monitor laterale. Tieni le schede del browser con la documentazione del progetto accanto all'editor.»
  • «Crea sempre uno Stage Comunicazioni per Slack, Discord ed email.»
  • «Raggruppa per nome del cliente quando possibile.»

Quali dati vengono inviati

Staging IA invia al modello AI un'istantanea dello spazio di lavoro. Con la tua chiave API va direttamente al tuo provider e i server di BetterStage non la vedono mai; con un abbonamento BetterStage AI passa dal servizio gestito di BetterStage. L'istantanea include:

  • Metadati delle finestre — nome dell'app, titolo della finestra, percorso del file del documento, URL del contenuto (host + percorso)
  • Disposizione dei monitor — nomi dei display, ordine di disposizione, dimensioni e posizione, stato principale/secondario
  • Vincoli di sistema — numero massimo di Stage, numero massimo di finestre per Stage

Non vengono inviati contenuti dei file, screenshot né sequenze di tasti. Titoli delle finestre, percorsi dei file e URL possono comunque contenere nomi sensibili di progetti o documenti, quindi scegli un provider di cui ti fidi.

Requisiti

  • Licenza Pro — Staging IA è una funzione Pro.
  • Un provider AI — la tua chiave API per uno dei 25 provider supportati (o per qualsiasi endpoint compatibile con OpenAI), oppure un abbonamento BetterStage AI, che esegue l'AI per te senza chiave.
  • Connessione a Internet — Necessaria per i provider cloud. I server locali (Ollama, LM Studio) funzionano offline.