Chat, modelos e contexto

Um chat combina uma tarefa, seu histórico, um modelo de provedor, seu contexto e as capacidades que você permite. Use um chat por resultado coerente para manter o contexto e a revisão compreensíveis.

Provedores e contas

Conecte provedores em Configurações → Maestrly Chat → Contas (veja Primeiros passos). As solicitações de inferência vão direto do app ao provedor; o Maestrly não revende acesso a modelos. A autenticação e a retenção seguem os termos do provedor.

Lista de contas: desde a 0.20.0, a aba Contas mostra todas as contas numa só lista agrupada por provedor, com status e uso, e os detalhes da conta selecionada ao lado. Use Buscar contas, mostre só as que Precisam de atenção ou estão Perto do limite, e encontre os provedores que você ainda não conectou em Disponíveis para conectar.
Várias contas por provedor: Adicionar conta conecta uma assinatura ou uma chave de API. Para outra conta do mesmo provedor, escolha Adicionar conta de novo ou Conectar outra conta … no menu ⋯ de uma conta. Cada conta tem rótulo, login e sessões próprios.
Rotação automática: com duas ou mais contas de assinatura do ChatGPT ou do Claude, ative Rotação automática e ordene a lista com Adicionar conta de fallback, Mover para cima e Mover para baixo. Quando uma conta atinge o limite de uso, a solicitação é repetida na próxima conta, preservando o contexto da conversa e os resultados de ferramentas já concluídos. Uma conta que atingiu o limite volta a ser usada assim que o limite renova. Uma conta desconectada é pulada até você reconectá-la.
Limites do plano: as contas de assinatura do ChatGPT e do Claude mostram quanto da janela de uso atual já foi consumido e quando ela reinicia. Desde a 0.21.0, uma conta Google AI também mostra o plano e a cota semanal, quando o runtime informa esses dados.
Contas que precisam de atenção: desde a 0.22.0, uma chave de API que o provedor recusa mostra Chave recusada com a mensagem do provedor, em vez de parecer conectada, e salvar ou trocar uma chave já a confere na hora. Uma conta Claude com login feito cujo Claude Code está ausente ou desatualizado mantém a linha dela com Claude Code não encontrado ou Claude Code precisa de atualização: instale ou atualize como o cartão mostra e escolha Verificar de novo, sem reiniciar.

Se a autenticação falhar, entre novamente e verifique o status da conta, a região e qualquer organização ou projeto selecionado no provedor.

Escolher um modelo

Escolha o modelo no seletor de modelo da caixa de mensagem ou pressione Cmd+Shift+M no macOS (Ctrl+Shift+M no Windows e no Linux). A lista vem de cada conta conectada e pode variar por plano, região e disponibilidade atual. Filtrar modelos, em cada conta, esconde os modelos que você não usa, e Modelo padrão, na seção Conversa de Configurações → Maestrly Chat → Modelos & agentes, define o modelo inicial; sem ele, um chat novo começa no último modelo que você escolheu. Essa aba agrupa os modelos por finalidade (Conversa, Tarefas em segundo plano, Memória e Subagents), mostra cada um como um chip com provedor, esforço e Fast, salva a escolha na hora e resume tudo em Em uso.

Combine o modelo com o trabalho:

use opções mais rápidas e econômicas para exploração e pequenas edições;
use opções de raciocínio mais capazes para mudanças amplas, ambíguas ou de maior risco;
confira se o modelo aceita as ferramentas, o tamanho de contexto ou as mídias necessárias para a tarefa.

Exibir um modelo pelo nome não representa endosso nem garantia de que sua conta possa usá-lo.

Esforço de raciocínio e modo Fast

O esforço de reasoning define quanto o modelo pensa antes de responder; Ctrl+Tab alterna entre os níveis. Só aparecem os níveis que o modelo selecionado aceita, e Padrão deixa a escolha com o provedor. Esforço maior costuma ser mais lento e consumir mais cota.

Fast é uma chave separada, de ligar e desligar, disponível nos modelos que a aceitam: respostas mais rápidas, com maior consumo. Fast nunca significa esforço baixo.

Modos e permissões

O modo controla o que o agente pode fazer. Shift+Tab alterna entre eles:

Modo	O que faz
Agente	Todas as ferramentas: lê, edita arquivos e roda comandos.
Design	Cria protótipos visuais navegáveis, com foco em UI/UX e dados simulados.
Plano	Investiga com ferramentas restritas e propõe um plano na aba Plano para você aprovar.
Pergunta	Responde com MCPs somente leitura e ferramentas permitidas do Maestrly, sem alterar código.

O modo de permissão decide quando o agente para e pede aprovação: Solicitar aprovação (edição de arquivos, comandos e uso da internet), Aprovar por mim (só ações potencialmente perigosas, como comandos de shell ou diretórios externos) ou Acesso completo (nunca pede). Use Acesso completo só onde erros são fáceis de desfazer.

Em um projeto, um plano aprovado também pode começar uma nova conversa com Implementar em nova conversa, e Usar Maestro, no menu de modos, passa a conversa para o Maestro, que coordena os agentes do seu Pool de agentes (veja Conceitos).

Escrever a primeira solicitação

Inclua quatro elementos:

Resultado — o que deve ser verdade quando o trabalho terminar.
Escopo — o projeto, arquivos ou áreas que o agente pode alterar.
Restrições — convenções, requisitos de compatibilidade e ações a evitar.
Verificação — testes, comandos ou evidências esperadas antes da conclusão.

Anexe apenas o contexto relevante. Contexto grande e sem relação consome a janela de contexto do modelo e pode deixar o resultado menos focado. Enquanto um turno roda, uma nova mensagem entra na fila ou redireciona o agente, nos runtimes que permitem isso.

Trocar de modelo no meio da conversa

Você pode trocar de modelo ou de provedor a qualquer momento. O Maestrly leva a conversa disponível completa para o novo modelo, incluindo resultados de ferramentas e instruções de skills armazenados. Se ela não couber na janela do destino, o Maestrly compacta antes; se ainda não couber ou a compactação falhar, a solicitação é bloqueada em vez de cortar o contexto em silêncio. O raciocínio privado e o estado de sessão de um provedor não passam para outro.

Depois da troca, confira o entendimento do agente antes de autorizar ações importantes.

Uso de contexto e compactação

O medidor de contexto mostra quanto da janela de trabalho do modelo está ocupado. Passe o mouse sobre ele para comparar a última medição com a estimativa para a próxima solicitação; estimativas começam com ~. Quando o runtime não informa uma medição, como no Google AI e no Cursor, o medidor mostra contexto desconhecido. A ocupação do contexto é separada do uso acumulado de tokens e do custo.

Quando o contexto fica alto, um aviso oferece Compactar, e /compact resume o histórico quando você quiser. O Maestrly também compacta antes de uma solicitação que não caberia. As mensagens originais continuam visíveis e uma lista de tarefas aberta segue ativa após a compactação; o resumo só vira o novo limite do contexto depois que todas as etapas dão certo, e uma compactação com falha bloqueia a solicitação sem mexer no histórico.

Clique no medidor de contexto para definir um Limite de contexto para aquele modelo naquela conta de provedor, abaixo da janela real (como 300k ou 1M), ou Sem limite para removê-lo. O medidor mostra a janela limitada com um cadeado, e o Maestrly compacta a conversa no limite antes de um turno. Desde a 0.23.0, o limite funciona com provedores de API e com as assinaturas Codex, Claude, GitHub Copilot, Grok, Cursor e Google AI: provedores de API, Codex, Claude, GitHub Copilot e Grok também compactam durante um turno que atinge o limite, enquanto o Cursor e o Google AI compactam entre os turnos, então um turno longo ali pode passar dele. O ChatGPT Web guarda o contexto no próprio ChatGPT e não tem limite.

A preparação em segundo plano é opcional e começa desligada. Em Configurações → Maestrly Chat → Modelos & agentes, em Tarefas em segundo plano → Preparar contexto, ative Usar preparação de contexto em segundo plano e escolha um Modelo de preparação e um Intervalo de preparação (100.000 tokens novos por padrão). Esse modelo prepara um ponto de compactação enquanto a conversa continua, para que uma compactação posterior o aproveite sem nova chamada de resumo. Ele recebe o conteúdo da conversa e consome a própria cota.

Anexos

Anexe arquivos com + → Imagem / arquivo, colando ou arrastando para a caixa de mensagem.

Imagens: cole com Cmd/Ctrl+V. Se o modelo não lê imagens, ative Usar o intérprete de imagens em Tarefas em segundo plano → Intérprete de imagens, em Configurações → Maestrly Chat → Modelos & agentes, para descrevê-las; sem ele, a imagem sai do contexto.
PDFs: até 10 MB cada e quatro por mensagem, dentro de um limite de 20 MB por mensagem dividido com as imagens. A assinatura do Claude e os modelos de API da Anthropic ou da OpenAI que aceitam PDF recebem o documento (até 100 páginas); os demais recebem o texto extraído localmente, sem layout nem imagens. PDFs protegidos por senha ou danificados são recusados.
Arquivos de texto e código, como Markdown, JSON ou código-fonte.

Na caixa de mensagem, @ referencia arquivos ou pastas e # referencia agentes. Os anexos ficam no perfil do app e são apagados junto com a mensagem ou a conversa; arquivos que um provedor recebeu seguem a política de retenção dele.

Respostas interativas

Desde a 0.18.0, em chats, conversas de projeto e conversas com bots, o agente pode misturar pequenas interfaces na resposta: páginas que ele escreve em HTML, CSS e JavaScript, mostradas num frame isolado. Elas servem para fotos de produtos, comparações visuais, gráficos, diagramas, calculadoras, simulações e pequenas ferramentas.

Com as Ferramentas do Maestrly ligadas, o agente pode ver uma prévia antes de mostrar a interface: o app a renderiza na largura do chat e devolve um print e os problemas encontrados.
Mover um controle deslizante ou mudar um campo roda dentro da interface e não chama o modelo. Um botão pode enviar uma mensagem como você ou abrir uma página no seu navegador, só logo depois que você interage com ele.
As interfaces não chamam ferramentas, não leem arquivos nem buscam dados, e não guardam nada entre uma exibição e outra. Elas podem carregar imagens, vídeo e áudio da web, e bibliotecas e fontes de alguns CDNs públicos, que veem os endereços pedidos.
Problemas que o app encontra, como conteúdo mais largo que a resposta ou erros de script, aparecem listados sob a interface. Código da interface mostra o que o agente escreveu. O app para celular também executa as interfaces, numa web view isolada, e sempre pergunta antes de uma delas enviar uma mensagem ou abrir uma página.

Desligue Respostas interativas na aba Ferramentas de Configurações → Maestrly Chat, ou nas Preferências de um ambiente de bots, para economizar os tokens. Respostas que já têm interfaces continuam mostrando elas.

Ditado por voz

Clique no microfone da caixa de mensagem de um chat ou bot, ou pressione Cmd+D (Ctrl+D no Windows e no Linux), para ditar; com Segure para gravar ligado, segure o botão enquanto fala. O ditado roda neste computador, onde está o microfone, seja o chat daqui, de um servidor ou de um bot.

Desde a 0.22.0, Configurações → Maestrly Chat → Ferramentas → Ditado escolhe o motor:

Este computador (Whisper), o padrão: a fala nunca sai do computador. O whisper.cpp transcreve localmente com o modelo Whisper large-v3-turbo, e gravações sem fala são descartadas.
OpenAI (gpt-4o-transcribe) ou Groq (whisper-large-v3-turbo): cada gravação vai para esse provedor com a sua chave de API e é cobrada na sua conta, cerca de US$ 0,006 e US$ 0,0007 por minuto. Eles lidam melhor com fala que mistura idiomas e termos técnicos, não precisam de download e funcionam em qualquer sistema. Uma gravação para sozinha depois de 10 minutos, e Tentar de novo envia de novo uma que falhou.

Desde a 0.21.0, o ditado ocupa a barra de ações da caixa de mensagem enquanto grava, com o tempo e o nível do microfone, e você pode continuar editando o texto. ↑ ou Enter envia o rascunho seguido da transcrição, Inserir (ou Cmd/Ctrl+D de novo) coloca a transcrição no rascunho para você revisar, e ✕ ou Esc descarta a gravação. Clique com o botão direito no microfone para escolher o microfone, Segure para gravar e o Idioma do ditado: Idioma do app por padrão; Detectar automaticamente leva cerca do dobro do tempo.

Com um servidor de bots conectado, Usar no celular também guarda o seu motor e a sua chave no servidor para que o app para celular dite por ele, e Remover do servidor apaga de lá. O servidor guarda essa chave sem criptografia no banco de dados, como os outros segredos dele.

No primeiro uso do motor local, o app oferece um download único de 547 MB, que aparece como Modelo de voz em Configurações → Maestrly Chat → Componentes, ou Usar uma chave de API. Ele exige macOS 15 ou mais recente em Apple silicon, ou Windows x64 ou Linux x64, onde roda na CPU e é mais lento.

Memória

A memória pessoal guarda fatos e preferências, como seu idioma e estilo de resposta, compartilhados pelos seus chats avulsos em qualquer provedor. Abra Configurações → Maestrly Chat → Modelos & agentes → Memória → Gerenciar memória pessoal para buscar, editar, fixar, arquivar e exportar entradas. O salvamento automático começa desligado e precisa de um modelo próprio.
A memória do projeto pertence a um workspace. Com Lembrar memórias relevantes automaticamente ligado (o padrão), cada mensagem pode trazer até três memórias relevantes, listadas em um selo abaixo da mensagem. Salvar memórias das conversas usa um Modelo de memória escolhido por você e começa desligado. As duas opções ficam na seção Memória de Configurações → Maestrly Chat → Modelos & agentes; o modelo que salva as memórias fica em Tarefas em segundo plano → Extração de memória.

A memória pessoal fica no perfil do app neste computador e não sincroniza entre dispositivos. Os agentes tratam memórias como evidência a conferir. Remover uma memória impede que ela seja lembrada de novo; não apaga o que um provedor já recebeu.

Buscar em uma conversa

Pressione Cmd/Ctrl+F em um chat ou conversa de bot. Enter e Shift+Enter percorrem os resultados, e Esc fecha a busca. Nas conversas de bots, a busca também cobre páginas mais antigas da transcrição e abre a atividade recolhida que contém um resultado. Com o grupo de ferramentas Histórico da conversa ligado, os agentes também podem buscar e ler as próprias mensagens anteriores.

Janelas separadas

Abrir chat em nova janela, no cabeçalho da conversa ou no menu da barra lateral, leva um chat avulso, uma conversa de workspace ou uma conversa de bot para uma janela própria, por exemplo em outro monitor. Rascunhos, anexos, mensagens na fila e respostas em andamento vão junto. Feche a janela ou escolha Voltar ao app para trazê-la de volta sem interromper o trabalho.

Atividade do agente

O raciocínio, os comandos, as buscas e os demais passos de ferramentas por trás de cada resposta ficam recolhidos em uma linha de atividade. Ela mostra o passo atual enquanto o agente trabalha e um resumo no final, incluindo passos que falharam ou que você negou; abra a linha para ver os detalhes. Respostas, perguntas, planos, subagents, artefatos, imagens geradas e capturas de tela que o agente compartilha continuam visíveis. Para ver cada passo em um cartão próprio, escolha Expandida em Configurações → Aparência e sons → Atividade do agente; Compacta é o padrão.

Notificações e contadores

Quando uma conversa neste computador, num servidor ou em outro computador termina o turno, falha, faz uma pergunta ou traz um plano para revisar, o Maestrly mostra uma notificação silenciosa do sistema, a menos que você esteja olhando para essa conversa (na janela principal em foco ou na própria janela em foco). Clicar na notificação abre a conversa, na própria janela quando ela tiver uma. Uma notificação mais nova substitui a anterior da conversa, abrir a conversa a remove, e um turno que trouxe um plano mostra só a notificação do plano.

Os Sons de alerta tocam para os mesmos eventos (Turno pronto, Turno falhou, Pedido de permissão, Plano para revisar). Desligue as notificações em Notificações do sistema, em Configurações → Aparência e sons; silenciar os sons não as desliga. Os bots também notificam (veja Bots).

O ícone do app conta o que precisa de você: as conversas com ponto vermelho na barra lateral (neste computador e nos servidores e computadores que ele alcança) mais a contagem da aba Bots. No macOS a contagem aparece no ícone do Dock, no Linux nos inicializadores compatíveis e no Windows uma marca vermelha aparece no botão da barra de tarefas.

Resolver falhas numa solicitação

Não autorizado ou proibido: entre novamente e verifique permissões da conta, projeto, organização ou modelo.
Modelo indisponível: escolha outro modelo disponível ou confira o status e o acesso regional no provedor.
Limite de uso ou de taxa: espere a janela reiniciar, reduza o trabalho paralelo ou adicione contas de fallback para a rotação automática.
Contexto grande demais: use Compactar, remova anexos sem relação, divida a tarefa ou escolha um modelo com janela maior.
Falha na compactação: tente de novo ou compacte manualmente; se continuar falhando, verifique a conexão com o provedor.
Ferramenta incompatível: escolha um modelo compatível ou remova essa capacidade da tarefa.

Os logs e painéis de cobrança do provedor são a fonte oficial para status e custos das solicitações. Veja Uso e custos.