> ## Documentation Index > Fetch the complete documentation index at: https://docs.orkestral.pro/llms.txt > Use this file to discover all available pages before exploring further. # Configurações > Configure o Orkestral: provedores, autonomia, aparência e mais. Configurações é onde você ajusta o Orkestral para você e seu time. Você gerencia seu perfil, escolhe quais provedores e modelos de IA alimentam seus agentes, controla quanto o time pode fazer por conta própria, muda a aparência do app e roda a manutenção de dados. Tudo fica atrás de uma única janela com uma barra lateral de seções agrupadas. Abra as Configurações de qualquer lugar com `Cmd ,` (ou `Ctrl ,` no Windows e Linux). Pressione novamente para fechar, ou aperte `Esc`. O mesmo atalho funciona como alternância. A maioria das mudanças salva instantaneamente. Alternâncias, seletores e amostras de cor são aplicados no momento em que você clica. O formulário de perfil em **Geral** é a exceção: edite os campos e depois pressione **Salvar**. ## Como as Configurações são organizadas A barra lateral agrupa seções por contexto para você encontrar as coisas rápido. O número da versão fica na parte de baixo da barra lateral. Perfil em **Geral**, **Time** (em breve) e **Assinatura** (em breve). Gerenciamento e autonomia do **Workspace**, além de **Modelos** (seus provedores de IA). **Sistema**, **Aparência**, **Áudio**, **Atalhos**, **Privacidade** (em breve) e **Dados**. Links de **Suporte** e, somente em workspaces locais, ferramentas de desenvolvedor em **Avançado**. Seções marcadas como **Em breve** mantêm suas preferências, mas ainda não têm um backend por trás delas. **Avançado** aparece somente quando seu workspace ativo roda em modo local. ## Geral Este é seu perfil e o bloco "sobre" do app. Preencha **Nome** e **Email**. O nome é como os agentes se dirigem a você no chat. Use **Apelidos** para outros nomes pelos quais as pessoas te chamam (separados por vírgula). Os agentes reconhecem esses nomes ao ler seus repos e mensagens. Pressione **Salvar**. O botão fica desabilitado até seu perfil terminar de carregar. Ative **Usar fuso horário do dispositivo** para seguir sua máquina, ou abra **Configurações de data e hora** para ajustar o relógio do sistema operacional. O bloco **Sobre** mostra sua versão e verifica os GitHub Releases. Se existir uma versão mais nova, você recebe um link clicável para ela; caso contrário, confirma que você está atualizado. **Sair** fecha o app. ## Workspace A seção Workspace gerencia os workspaces que você criou e define quão autônomo é o time. Um **seletor de escopo** no topo permite inspecionar ou gerenciar qualquer workspace não arquivado sem trocar aquele em que você está trabalhando ativamente. O card mostra o nome, a organização, a missão, o selo do plano (**Team** ou **Local**), a data de criação e uma contagem ao vivo de agentes, fontes, issues e páginas da base de conhecimento. Abaixo, você vê cada fonte conectada (repo do GitHub ou pasta local) com seu papel e a marca de principal. O controle deslizante de **Autonomia** é uma configuração de todo o workspace que reside no orquestrador CEO. Tem três níveis: **Baixa**, **Média** e **Alta**. Uma autonomia mais alta permite que o time dê mais passos antes de pausar para te perguntar. Ela é definida aqui, e não por agente, porque o orquestrador conduz todo o time. Arquivar oculta um workspace do alternador, mas mantém todos os seus dados. Workspaces arquivados são listados abaixo com uma ação **Restaurar**. A exclusão é permanente e pede confirmação. Se você excluir o workspace ativo, o Orkestral muda para outro ou, se nenhum restar, abre o assistente de onboarding para criar um novo workspace. Excluir é irreversível. Remove o workspace e seus dados para sempre. Prefira arquivar caso queira recuperá-lo depois. ## Modelos Esta é sua seção de provedores. Ela lista os adaptadores de IA reais que o Orkestral descobriu e, para cada um, os modelos que ele de fato expõe. Nada aqui é fixo no código: os chips de modelo vêm da própria descoberta de cada provedor. Cada provedor mostra seu nome, descrição e uma linha de modelos disponíveis. Os selos indicam o que um provedor é: **Local, incluído** para a Forge embutida, **Recomendado**, **Executor** para modelos somente de execução e **Em breve** para provedores que ainda não estão conectados. O modelo local embutido, a Forge (`orkestral_local`), é marcado como **Local, incluído**. Ele roda na sua máquina sem custo de API e é o motor que aplica mudanças de código. ### Roteamento inteligente Abaixo dos provedores, você controla como o trabalho se divide entre modelos premium de planejamento e a Forge local. * **Permitir fallback premium** deixa o roteamento recorrer a um modelo premium quando o caminho local não consegue dar conta de uma tarefa. * **Habilitado** liga ou desliga o roteamento inteligente. * **Preservar contexto da CLI** mantém o contexto do seu terminal ao rotear. * **Exigir aprovação para local** faz o time pausar para sua autorização antes de rodar trabalho localmente. Escolha com que agressividade o trabalho migra para o modelo local: * **Observar** observa sem agir. * **Perguntar** confere com você antes de rotear. * **Assistência local** usa ajuda local junto com o planejamento premium. * **Local primeiro** prefere a Forge local sempre que possível. **Risco local máximo** limita quais tarefas o modelo local pode assumir: **Baixo**, **Médio** ou **Alto**. Tarefas acima do limite permanecem com os modelos premium. Comece com **Local primeiro** e um limite de risco **Médio** para manter o custo perto de zero enquanto os modelos premium ficam reservados para o planejamento. Leia mais em [Roteamento híbrido de modelos](/pt/forge) e [A Forge](/pt/forge). ## Sistema Sistema cobre o comportamento do sistema operacional e as notificações, dividido em dois grupos. **Iniciar com o sistema** abre o Orkestral quando você faz login. **Formato de hora** alterna entre 12h e 24h. **Mostrar app em** controla se o app fica no dock, na barra de status, ou em ambos. **Notificações** liga os alertas da área de trabalho (na primeira vez, pede permissão ao sistema operacional). **Som de notificação** toca um som a cada alerta. **Notificações da caixa de entrada** controla os alertas de atividade na caixa de entrada. ## Aparência Aparência tem duas abas: a aparência geral e o tema de código usado no realce e nos diffs. Escolha **Escuro**, **Claro** ou **Sistema** para seguir seu sistema operacional. Escolha **Português (Brasil)**, **Inglês** ou **Sistema** para seguir o idioma do seu SO. A interface é bilíngue. A cor de destaque é por workspace. Use o seletor de escopo para escolher qual workspace recolorir, depois clique em uma amostra de cor. Recolorir um workspace diferente do ativo não muda a cor da sessão atual. Defina **Densidade** como **Confortável** ou **Compacta**, e **Tamanho da fonte** como **Pequeno**, **Médio** ou **Grande**. Vá para a aba **Tema** e escolha entre os cards de pré-visualização ao vivo. Cada card mostra o realce de sintaxe real mais um diff de exemplo nas cores daquele tema. Tema, idioma, densidade e tamanho da fonte são globais. Somente a cor de destaque segue o seletor de escopo do workspace. ## Áudio Áudio escolhe o microfone usado para a ditadura por voz e o dispositivo de saída. Os nomes dos dispositivos só aparecem depois que você concede permissão de microfone, então o painel mostra primeiro um pedido de permissão. Clique no botão para solicitar acesso, depois escolha seus dispositivos de **Entrada** e **Saída**. Cada um recorre ao **Padrão do sistema**. Se sua plataforma não suporta a seleção de saída, esse controle fica oculto. ## Atalhos Atalhos é uma referência somente leitura de cada atalho de teclado que o app de fato registra, agrupados por **Navegação**, **Chat** e **Geral**. A lista é gerada a partir do registro de atalhos ao vivo, então ela sempre corresponde ao que funciona. ## Privacidade Privacidade está marcada como **Em breve**. As três alternâncias de preferência persistem de verdade, mas o Orkestral ainda não coleta telemetria nem roda um mecanismo de mascaramento. Trate-as como preferências registradas que o futuro vai honrar. As ações de dados abaixo são reais e têm efeito imediato. **Telemetria local**, **Mascarar segredos** e **Bloquear arquivos sensíveis** são preferências armazenadas. Nada é enviado a lugar nenhum hoje. Limpa o cache de navegação do app imediatamente. Restrito ao workspace que você escolher. Após confirmar, exclui as sessões e mensagens de chat daquele workspace e informa quantas foram removidas. ## Dados Dados é seu hub de manutenção e armazenamento. Um bloco em destaque mostra o tamanho total do banco de dados e o caminho em disco. Um seletor de escopo filtra as contagens para um workspace. Duas grades de blocos mostram contagens do workspace (agentes, sessões, mensagens, issues) e contagens da base de conhecimento (páginas, chunks, embeddings, eventos de trace). Quando um job de embedding da base de conhecimento está na fila ou em execução, você vê seu status e progresso, com um botão para cancelá-lo. O Orkestral pré-visualiza os dados seguros para remover do workspace selecionado e estima o espaço que você recuperaria. Revise as sugestões e depois confirme para rodar a limpeza. **Exportar para JSON** grava uma exportação completa e informa o caminho. **Abrir pasta** revela o diretório de dados no seu gerenciador de arquivos. **Limpar cache** apaga o cache do app. ## Suporte Suporte reúne apenas links e ações reais. Mostra sua versão, depois abre o repositório do GitHub, um formulário de nova issue, as notas de versão, a visão de **Logs** dentro do app e a pasta de dados. ## Avançado Avançado aparece somente em workspaces locais e contém ações de desenvolvedor e destrutivas. **Refazer onboarding** redefine o estado do onboarding e pede confirmação antes de rodar. ## Time e Assinatura Essas duas seções são placeholders honestos para recursos que dependem do Orkestral Cloud, que ainda não existe. * **Time** lista o único humano real (você) como proprietário. Os agentes de IA são gerenciados na área de Agentes, não aqui. Convidar colegas humanos fica desabilitado até o Cloud chegar. * **Assinatura** mostra seu plano real e apresenta o Orkestral Cloud como um nível **Em breve**. Não há preços para comprar nem faturas. ## O que fazer a seguir Adicione chaves de API para que os modelos premium possam planejar para seu time. Equilibre o planejamento premium com a Forge local gratuita. Decida até onde o time vai antes de te perguntar. Exporte para JSON e descubra onde seus dados ficam em disco.