QuickAgent - Guia

Guia do usuário do QuickAgent

O QuickAgent é um workspace de agentes de IA com prioridade local. Ele transforma um objetivo em um Run durável, limita esse Run com um Workspace Profile, pede revisão antes de ações sensíveis e mantém os resultados verificados em Artifacts.

Primeiros passos

Abra Configurações > IA, adicione um provedor e execute o teste de conexão.
Abra Configurações > Workspace Profiles. Escolha quais provedores, ferramentas, conexões, raízes de arquivos, fontes de Knowledge e escopos de Memory podem ser usados.
Selecione Nova conversa, escolha o perfil e confirme o destino do provedor mostrado acima da conversa.
Descreva um resultado esperado. Adicione apenas os arquivos, pastas, mídias, Knowledge ou Memory necessários para este Run.
Revise o plano, as aprovações, a confirmação Critical e a Data Send Preview quando aparecerem.
Acompanhe o trabalho na Timeline. Abra a saída concluída em Artifacts e inspecione a trilha de auditoria em Histórico.

Dica: Comece com um Workspace Profile restrito. Amplie as ferramentas ou raízes dele apenas quando o QuickAgent indicar um motivo específico de indisponibilidade.

Visão geral da interface

Seção	Para que serve
Chats	Conversas, destino do provedor, Context Tray, planos, aprovações e a Timeline do Run ativo.
Runs	Todas as tarefas planejadas, em execução, pausadas, agendadas, com falha ou concluídas.
Approval Inbox	Revisões pendentes de ação, Critical e Data Send que precisam da sua decisão.
Artifacts	Arquivos, relatórios, logs, mídias, tabelas e manifestos de operação verificados, criados pelos Runs.
Automations	Agendamentos, monitores, webhooks, eventos de app e gatilhos de Atalhos/App Intents.
Skills	Instruções reutilizáveis com entradas tipadas, ferramentas permitidas, conexões necessárias, risco e saídas.
Connections	Provedores, perfis de navegador, raízes de arquivo/VFS, SSH, MCP, HTTP/SaaS, pontes de casa inteligente e canais de notificação.
Knowledge	Pastas indexadas, conteúdo do QuickNote, recortes da web, PDFs e fontes do Office.
Histórico	Decisões de segurança, ações de ferramentas, destinos e carimbos de data/hora somente para acréscimo.
Configurações	Aparência, idioma, IA, ferramentas, segurança, Workspace Profiles, atalhos, permissões, Ajuda e Pro.

Provedores e Workspace Profiles

O QuickAgent pode usar a IA do sistema quando o sistema operacional expõe um recurso compatível, provedores locais como Ollama, LM Studio ou DeskLLM, endpoints compatíveis com OpenAI na LAN ou personalizados, e provedores de nuvem configurados como Anthropic ou Gemini. A disponibilidade é determinada por um teste de capacidade em tempo real; o nome de um provedor, por si só, não significa que ele esteja pronto.

Um Workspace Profile é o envelope de permissões do Run. Ele registra um instantâneo do provedor/modelo selecionado, das ferramentas permitidas, das conexões, das raízes de arquivos, das fontes de Knowledge, dos escopos de Memory, das exceções de segurança e do orçamento. Uma mudança posterior na configuração torna o instantâneo desatualizado e exige revisão.

Regra de destino: o QuickAgent nunca troca silenciosamente um provedor local ou no dispositivo por um provedor de nuvem. O destino ativo permanece visível no Chat e em toda revisão de Data Send.

Runs, aprovações e recuperação

Controles de Run

Pausar solicita uma parada cooperativa em um checkpoint durável.
Retomar continua o mesmo Run e o trabalho já concluído.
Parar cancela o trabalho do provedor e das ferramentas. Um efeito externo interrompido ou incerto não é relatado como sucesso.
Repetir só está disponível quando o QuickAgent consegue identificar um limite seguro para repetição.

Níveis de segurança

Nível	Significado
Safe	Ler, inspecionar ou transformar dentro do perfil ativo.
Approve	Revisar uma gravação comum ou uma ação externa.
Confirme que	Revisar uma alteração de maior impacto ou mais difícil de reverter.
Critical	Confirmação forte todas as vezes; as regras nunca a aprovam automaticamente.

A aprovação mostra o alvo exato, o destino, os argumentos propostos, o risco e o status de desfazer. Se você editar um argumento, o QuickAgent valida e reavalia o risco da ação editada.

Resultado incerto: depois de uma interrupção, verifique primeiro o sistema de destino. Escolha “Eu verifiquei — repetir” apenas quando repetir a ação for adequado. “Retomar” sozinho nunca repete um efeito externo incerto.

Runs com múltiplos agentes

Objetivos complexos podem usar um planejador, trabalhadores especialistas tipados, um revisor e um revisor de segurança. A Timeline mostra cada repasse, revisão, repetição, alternativa e limite de resposta final. Os trabalhadores recebem apenas a interseção das quatro listas: ferramentas da Skill, ferramentas do Workspace Profile, ferramentas do papel e ferramentas atualmente ativas.

Orçamentos globais e por papel limitam invocações, tempo, custo, bytes de rede e tokens. Quando um orçamento é atingido, o QuickAgent pausa. Ele mostra os limites atuais e os propostos, e só os aumenta após revisão explícita. O orçamento aprovado e o histórico dos papéis concluídos sobrevivem a uma reinicialização.

Contexto, Knowledge e AI Memory

Context Tray

Adicione arquivos, pastas, imagens, quadros de vídeo, áudio, notas de voz, conteúdo do QuickNote, Knowledge ou Workspace Memory. O QuickAgent extrai ou resume o conteúdo compatível e indica se um anexo será enviado diretamente a um provedor.

Knowledge

As fontes de Knowledge são indexadas separadamente da conversa. Um Run só pode pesquisar as fontes permitidas pelo seu Workspace Profile, e as citações mantêm a identidade da fonte.

Memory

A Memory é deliberada, não um histórico automático de conversa. Os escopos de usuário, workspace, projeto e ferramenta/conexão são separados. Cada pedido de criação, edição ou exclusão recebe uma nova aprovação, e a prévia da aprovação mostra o escopo e o valor exato proposto.

Ferramentas e conexões

O catálogo em tempo real cobre operações de arquivo/VFS; Office, PDF e dados estruturados; mídia e OCR; navegador e controle do computador; comandos de desenvolvimento; SSH; MCP; HTTP e SaaS; pontes de casa inteligente; notificações; agendamentos; monitores; e controle de automações. Servidores MCP conectados podem acrescentar ferramentas dinâmicas depois da validação do esquema e da reavaliação de risco pelo QuickAgent.

Configurações > Ferramentas mostra por que uma ferramenta está pronta ou desativada. Os motivos comuns são conexão ausente, permissão do sistema operacional, plataforma não compatível, restrição do Workspace Profile, endpoint não testado ou recurso indisponível no provedor.

Controle do computador: a captura de tela e o controle de acessibilidade/entrada são permissões separadas. Mantenha a prévia visível e o botão de parada de emergência sempre disponíveis. As plataformas móveis não oferecem o mesmo controle irrestrito que o desktop.

Automations

As automações podem ser iniciadas por gatilhos de horário, arquivo/pasta, web, webhook, e-mail, calendário, rede, host, dispositivo, sensor, localização, evento de app, Atalho/App Intent, comando ou manuais, quando a plataforma oferecer suporte. Um gatilho cria um Run comum; ele não ignora as verificações de Workspace Profile, aprovação, Critical ou Data Send.

O monitoramento no desktop continua apenas enquanto o processo do app estiver em execução.
As plataformas móveis recuperam o trabalho atrasado quando o app volta ao primeiro plano.
Use Atalhos/App Intents ou um relé de eventos confiável quando a entrega pelo sistema operacional for necessária.
Eventos na fila, pausa, cancelamento e exclusão continuam explícitos, para que nenhum evento seja descartado em silêncio.

Skills e Skill Packs

Uma Skill armazena um prompt focado em resultado, variáveis tipadas, recomendação de provedor, ferramentas permitidas, conexões e recursos necessários, risco máximo e os Artifacts esperados. Antes do uso, o QuickAgent mostra as entradas e as permissões efetivas; a prévia por si só não concede permissão.

Sete Packs integrados oferecem Skills reais para Office, Programação, Casa Inteligente, Pesquisa, Automação de Navegador, Administração Pessoal e Resposta a Incidentes. Você pode instalar, atualizar, desinstalar, personalizar, duplicar, importar e exportar Skills. O JSON importado recebe uma prévia de confiança, publicador, assinatura, permissões, risco, plataforma e conflitos. “Manter ambos” cria um derivado local sem assinatura, em vez de herdar a confiança de outro publicador.

Artifacts, histórico e desfazer

Os Artifacts guardam os bytes de saída, metadados, versões, procedência, o Run de origem e os manifestos de operação. Dependendo do recurso da plataforma, você pode abri-los, compartilhá-los, exportá-los ou revelá-los. As operações elegíveis oferecem um desfazer revisado; trabalhos destrutivos ou incertos nunca são repetidos automaticamente.

O histórico é somente para acréscimo. Filtre-o por Safe, Approve, Confirm ou Critical e exporte a auditoria quando precisar de um registro externo.

Configurações

Geral: aparência, idioma, Workspace Profiles, atalhos, Ajuda e permissões.
IA: provedores, endpoints, modelos, credenciais e testes em tempo real.
Ferramentas: prontidão do catálogo, suporte por plataforma e motivos de configuração.
Segurança: regras de aprovação, comportamento do Data Send, autenticação do dispositivo e política de Memory por escopo.
Avançado: recuperação e diagnósticos destinados à solução de problemas.

Atalhos de teclado

No macOS, o app mapeia os atalhos exibidos com Ctrl para a tecla Command da plataforma quando apropriado. A página de Atalhos dentro do app é a referência oficial e permite personalização.

Atalho	Ação
`Ctrl` + `N`	Nova conversa
`Ctrl` + `L`	Focar o campo de composição
`Ctrl` + `Shift` + `Space`	Pausar ou retomar o Run ativo
`Ctrl` + `.`	Parar o Run ativo
`Ctrl` + `1` … `9`	Abrir Chats pelo histórico
`Ctrl` + `,`	Abrir as Configurações
`F1`	Abrir Ajuda & Privacidade
`Esc`	Fechar uma caixa de diálogo ou cancelar a interação não destrutiva atual

Notas por plataforma

Plataforma	Limites importantes
macOS	Executa em sandbox em Debug e Release. O acesso a arquivos usa as raízes selecionadas/marcadores com escopo de segurança. Gravação de Tela e Acessibilidade são permissões separadas do sistema. As integrações com processos locais e Atalhos continuam sujeitas a teste de capacidade.
Windows	Os recursos de arquivos, Office/PDF/dados, navegador, desenvolvimento, acesso remoto e controle do desktop dependem do runtime instalado e das permissões. As integrações exclusivas da Apple ficam indisponíveis, com um motivo visível.
iPhone / iPad	Os arquivos usam o seletor do sistema. Câmera, microfone, fala, fotos, rede local e notificações são solicitados no contexto de uso. O monitoramento em segundo plano não é garantido; use Atalhos/App Intents ou a recuperação em primeiro plano.
Android	Arquivos e pastas usam o Storage Access Framework. O trabalho em segundo plano segue as restrições do Android. O controle de entrada baseado em acessibilidade nunca é considerado concedido só porque um serviço foi declarado.
Web	Usa armazenamento apenas de sessão para os recursos que exigem persistência nativa e desativa claramente os recursos de dispositivo, raiz de arquivos, processo local e segundo plano que não têm suporte.

Dicas & Truques

Comece com um Workspace Profile restrito e adicione uma ferramenta, conexão ou raiz de arquivos apenas quando o Run indicar uma necessidade específica.

Dê a cada pedido um resultado claro, um Artifact esperado e um limite de revisão, para que o progresso continue fácil de auditar.

Use Knowledge para fontes indexadas reutilizáveis e Context para o material necessário apenas ao Run atual.

Quando um efeito externo for incerto, inspecione o destino antes de repetir; Retomar nunca repete a ação automaticamente.

Solução de problemas

Problema	O que verificar
O provedor não funciona	Abra Configurações > IA. Verifique a configuração, a autenticação, a capacidade do modelo, o alcance do endpoint, o tempo limite e os detalhes de limite de taxa, depois execute o teste de conexão.
Uma ferramenta está desativada	Abra Configurações > Ferramentas e leia o motivo em tempo real. Revise a plataforma atual, a permissão, o teste de conexão, o Workspace Profile e a raiz selecionada.
Um Run parece travado	Abra Runs e a Timeline. Ele pode estar pausado, aguardando uma entrada, uma aprovação, uma confirmação Critical, uma revisão de Data Send ou de orçamento. Parar continua disponível.
Uma permissão mudou	Abra Ajuda > Visão geral ou as Configurações e, em seguida, abra as configurações do sistema. Teste novamente a conexão ou a ferramenta afetada ao voltar.
Uma ação externa está incerta	Verifique o sistema de destino. Mantenha o Run pausado ou pare-o, a menos que você tenha confirmado que repetir é adequado.
Uma automação não disparou em segundo plano	Os sistemas operacionais móveis não garantem consultas periódicas arbitrárias. Volte ao primeiro plano para a recuperação ou configure um Atalho/App Intent ou uma fonte de eventos confiável.
Um Artifact não abre nem exporta	Verifique se os bytes dele ainda estão disponíveis, se a plataforma oferece suporte à ação e se a permissão do destino escolhido continua válida.

Privacidade, permissões e licenças

O QuickAgent armazena conversas, Runs, aprovações, metadados de Knowledge, Skills e configurações localmente. As credenciais usam o armazenamento protegido pela plataforma. O conteúdo só sai do dispositivo por meio de um provedor ou serviço conectado que você configurar, e os envios externos recebem uma prévia que informa o destino.

As permissões são solicitadas no contexto de uso: arquivos/pastas, fotos, câmera, microfone, reconhecimento de fala, rede local, notificações, gravação de tela e controle de acessibilidade/entrada são independentes. Remover uma permissão torna o recurso afetado indisponível, em vez de produzir um falso sucesso.

Abra Configurações > Ajuda & Privacidade para ver a tabela de recursos da plataforma atual e Licenças de código aberto para os avisos de pacotes e componentes nativos incluídos.

Free e Pro: todos os recursos de agente continuam disponíveis no plano Free. O teste de sete dias é livre de anúncios; depois disso, o celular pode exibir anúncios e o desktop pode exibir um lembrete diário. O Pro remove essas mensagens por meio de uma assinatura anual ou de uma compra vitalícia.