Documentação / Conceitos principais

Staging com IA

Descreva o espaço de trabalho que quer no painel de chat do Staging com IA — mencione com @ apps, janelas, Stages ou monitores específicos — e a AI analisa as suas janelas abertas (títulos, URL, caminhos de ficheiros) e propõe um plano de Stages que pode rever, refinar, aplicar ou desfazer num só passo (Cmd-Z no painel). Use-o com a chave do seu próprio fornecedor de AI numa licença Pro, ou com o BetterStage AI — uma subscrição gerida que não precisa de chave API nem de configuração.

Como funciona

O Staging com IA analisa todas as janelas abertas em todos os monitores, recolhe metadados (nome da app, título da janela, caminho do documento, URL) e envia-os para um modelo de AI — o seu próprio fornecedor (com a sua chave API) ou o serviço gerido do BetterStage, se subscrever o BetterStage AI. O modelo devolve um plano que cria Stages com nome e atribui cada janela à Stage e ao monitor certos.

  1. Analisar — O BetterStage lê os títulos das janelas, os caminhos dos documentos, os URL e os nomes das apps de todas as janelas abertas.
  2. Processar — Os dados são enviados para o seu fornecedor de AI — o seu próprio, ou o serviço gerido do BetterStage com uma subscrição do BetterStage AI. O painel de chat mostra o progresso em tempo real e mantém as ações propostas associadas à resposta do assistente.
  3. Rever e aplicar — São criadas novas Stages e cada janela é atribuída ao monitor certo em cada Stage. O BetterStage também escolhe um modo de janela para cada monitor — Nativo melhorado ou TabStack — adequado ao que está lá agrupado, e pode pedir um modo específico no seu pedido. Pode refinar o plano antes de o aplicar e desfazer depois o conjunto aplicado.

Iniciar o Staging com IA

Há quatro formas de executar o Staging com IA:

  • Atalho de teclado — Prima Opt+Z (layout europeu: Ctrl+Opt+Z) ou o seu próprio atalho definido em Definições > Atalhos.
  • Barra de menus — Clique no ícone do BetterStage na barra de menus e selecione Staging com IA…
  • Roda Snap — Abra a Roda Snap e escolha Staging com IA no submenu Espaço de trabalho.
  • Definições — Abra Definições > Staging com IA para configurar o fornecedor e execute a partir daí.

Configuração do fornecedor

Com a sua própria chave API, o Staging com IA comunica diretamente com o seu fornecedor e nenhum dado passa pelos servidores do BetterStage. (Com uma subscrição do BetterStage AI, os pedidos passam, em vez disso, pelo serviço gerido do BetterStage — sem chave.) Configure o seu fornecedor em Definições > Staging com IA. O BetterStage inclui 25 predefinições de fornecedores: 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 outros — incluindo servidores locais como o Ollama e o LM Studio.

  • Listas de modelos em direto — escolha uma predefinição e o BetterStage obtém os modelos que a sua chave pode realmente usar.
  • Seletor de região — os fornecedores com endpoints regionais (Qwen, Moonshot, Zhipu, MiniMax, SiliconFlow) permitem alternar entre URL base nacionais e internacionais.
  • Chaves API por fornecedor — cada fornecedor memoriza a sua própria chave, por isso mudar de predefinição nunca faz perder uma chave.
  • Endpoint personalizado — a predefinição Personalizado (compatível com OpenAI) aceita qualquer URL base e nome de modelo, por exemplo um proxy ou um servidor alojado por si.
FornecedorModelo predefinidoAutenticação
OpenAIgpt-4.1-miniChave API (token Bearer)
Claude (Anthropic)claude-sonnet-4-6Chave API (cabeçalho x-api-key)
Ollama (local)o modelo que instalouNenhuma (localhost)
Personalizado (compatível com OpenAI)qualquerChave API (token Bearer)

As outras 22 predefinições seguem o mesmo padrão compatível com OpenAI, com o URL base e o modelo predefinido já preenchidos.

Testar ligação

Definições > Staging com IA inclui um botão Testar ligação que envia uma mensagem de chat real ao modelo configurado — para saber que o endpoint, a chave e o modelo funcionam mesmo antes de depender deles. Os problemas de configuração são detetados antes do pedido, com uma mensagem clara e um botão Abrir definições em vez de um erro em bruto do fornecedor.

Recipes guardadas

As Recipes são instruções guardadas sobre como o seu espaço de trabalho deve ser organizado. Mantenha Recipes separadas para fluxos de trabalho diferentes — programação, revisão de design, suporte, escrita ou qualquer outra coisa que repita. O painel do Staging com IA permite mudar de Recipe, criar uma nova, duplicar ou mudar o nome de uma existente, eliminar as antigas e escolher uma Recipe predefinida para novas sessões.

A Recipe selecionada é incluída quando executa o Staging com IA. Edite-a com os mesmos chips de menção @ do chat em direto (monitores, Stages, janelas, apps e modos de janela), pré-visualize o pedido exato enviado ao modelo e execute uma organização diretamente a partir do painel.

Exemplos de notas de Recipe:

  • “Coloca as apps de chat e a música no monitor lateral pequeno. Mantém os separadores do navegador com a documentação do projeto ao lado do editor.”
  • “Cria sempre uma Stage de Comunicação para o Slack, o Discord e o e-mail.”
  • “Agrupa pelo nome do cliente sempre que possível.”

Que dados são enviados

O Staging com IA envia uma captura do espaço de trabalho ao modelo de AI. Com a sua própria chave API, vai diretamente para o seu fornecedor e os servidores do BetterStage nunca a veem; com uma subscrição do BetterStage AI, passa pelo serviço gerido do BetterStage. A captura inclui:

  • Metadados das janelas — nome da app, título da janela, caminho do ficheiro do documento, URL do conteúdo (anfitrião + caminho)
  • Disposição dos monitores — nomes dos ecrãs, ordem de disposição, limites das molduras, estado principal/secundário
  • Restrições do sistema — número máximo de Stages, número máximo de janelas por Stage

Não é enviado o conteúdo de ficheiros, nem capturas de ecrã, nem teclas premidas. Os títulos das janelas, os caminhos dos ficheiros e os URL podem, ainda assim, conter nomes sensíveis de projetos ou documentos, por isso escolha um fornecedor em que confie.

Requisitos

  • Licença Pro — O Staging com IA é uma funcionalidade Pro.
  • Um fornecedor de AI — a sua própria chave API de um dos 25 fornecedores suportados (ou de qualquer endpoint compatível com OpenAI), ou uma subscrição do BetterStage AI, que executa a AI por si, sem chave.
  • Ligação à Internet — Necessária para fornecedores na nuvem. Os servidores locais (Ollama, LM Studio) funcionam offline.