> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexx.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistente

> Um chat que lê os dados do seu workspace, responde sobre eles e propõe o que fazer.

O assistente do Apex não é um chatbot genérico: ele consulta os dados do seu
workspace para responder. "Quanto vendi este mês", "quais produtos estão sem
estoque", "quem são meus maiores clientes" são perguntas que ele resolve
olhando os seus registros, não inventando. E ele também age: prepara um
cadastro ou uma alteração e espera você confirmar.

## Onde fica

> [card] Página inicial
>
> O chat em tela cheia, com o **Histórico** das suas conversas e anexos.

> [card] Painel lateral
>
> Nas telas do ERP, o botão flutuante (ou **⌘I**, **Ctrl+I** no Windows)
> abre o chat ao lado, sem sair do que você está vendo.

## O que ele consegue fazer

> [accordion] Consultar seus dados
>
> Produtos, estoque, lotes, pedidos de venda e de compra, notas fiscais,
> devoluções, anúncios, contatos, contas e caixa. Ele busca no workspace e
> responde com números reais.

> [accordion] Entender o registro aberto
>
> Com um pedido, um produto, um contato ou uma conta aberto na tela,
> pergunte no painel "esse pedido já foi pago?": ele sabe de qual registro
> você fala.

> [accordion] Ler arquivos
>
> **+ → Carregar fotos e arquivos**: imagem, PDF, planilha, Word,
> PowerPoint ou texto, até 10 MB cada. Pergunte sobre o conteúdo.

> [accordion] Buscar na web
>
> **+ → Buscar na web**, ligado de saída. Quando a resposta não está no seu
> workspace, ele pesquisa e decide sozinho quando vale a pena. As citações
> ficam no próprio texto, e o botão **Fontes**, embaixo da resposta, lista
> as páginas que ele leu.

> [accordion] Fazer um relatório
>
> **+ → Relatório** vale para a próxima mensagem: ele mostra o plano, junta
> os números e escreve um relatório que abre no painel ao lado, com download
> em PDF e Word.

## Propor e confirmar

Peça "cadastra o cliente João Silva" ou "muda o vencimento da conta CP-0012
para dia 20" e o assistente prepara a mudança num cartão, sem gravar nada.

| Onde | O que ele pode propor |
| - | - |
| Cadastros | Cadastrar e alterar clientes, fornecedores e produtos |
| Financeiro | Lançar e alterar contas a pagar, contas a receber e lançamentos no caixa |
| Suprimentos | Criar pedido de compra e movimentar estoque |
| Qualquer um desses | Mover para a lixeira, restaurar e excluir de vez |

No cartão, **Ajustar campos** abre os valores para você corrigir antes;
**Confirmar** grava, **Cancelar** desiste. Numa alteração, o cartão mostra o
antes e o depois de cada campo. Com vários cartões pendentes, **Confirmar
todas** e **Cancelar todas** decidem de uma vez; exclusão nunca entra no
Confirmar todas.

> [!TIP]
>
> **Permitir nesta conversa**, no cartão, confirma aquele e deixa os próximos
> cadastros e edições da mesma conversa gravarem direto, com **Desfazer**
> logo abaixo. O aviso **Edições permitidas** fica ao lado do campo de
> mensagem: um clique nele volta a pedir confirmação. Só aparece no plano
> Plus, quando o dono da empresa liberou, e nos módulos marcados para isso.

O que ele não faz: dar baixa em conta, criar conta recorrente ou parcelada,
mexer em pedido de venda, emitir nota, mudar configurações. Para isso, a tela.
Vendas, notas fiscais, devoluções, anúncios, estoque e lotes são só consulta.

## O que ele respeita

> [!NOTE]
>
> O assistente nunca passa da permissão de quem está usando. Se o seu acesso
> é limitado a certas páginas, ou ao alcance "somente próprios", as respostas
> e as propostas seguem a mesma regra. Ele não é uma porta lateral para dados
> que a sua permissão não alcança.

Em cima disso, o dono da empresa decide o que a IA faz em **Configurações →
Permissões**, no grupo Inteligência artificial:

* **Pausar a IA** desliga o chat da empresa inteira, na hora.
* Cada módulo fica **Desligado** (a IA nem o vê), **Só ver** ou **Ver e
  propor**.
* **Permitir nesta conversa** liga ou desliga a opção do cartão.
* As **Regras fixas** não se desligam: excluir e restaurar, o financeiro, a
  nota fiscal e o preço de venda sempre pedem confirmação, e zerar ou apagar
  um campo sempre pergunta.

## Memória

O assistente guarda sozinho o que vale lembrar nas próximas conversas: seu
fornecedor principal, como você gosta das respostas. Quando a memória muda, a
resposta mostra **Memória atualizada**; clique para ver o que entrou. Pedir
"esqueça isso" apaga.

Em **Configurações → Personalização → Memória**:

* **Gerar memória a partir das conversas** liga ou desliga (vem ligado).
* **Incluir temas sensíveis na memória**, como saúde ou religião (vem
  desligado).
* **Memória salva → Gerenciar** mostra cada nota: clique numa frase para
  corrigir ou apagar.
* **Redefinir** apaga tudo.

A memória é sua: outros membros do workspace não a veem. No mesmo lugar,
**Pesquisar nos documentos** deixa o assistente procurar nos arquivos do
workspace.

## Chat temporário

O fantasma ao lado do Histórico (**Iniciar chat anônimo**, ou **⇧⌘I**) abre
uma conversa que não vai para o histórico, não vira memória e não pode ser
compartilhada. Recarregar ou fechar a aba encerra a conversa de vez. As
consultas ao ERP continuam, com as mesmas permissões, e a conversa conta no
limite de uso.

## Compartilhar

No menu **…** da conversa, **Compartilhar** convida membros do workspace, um a
um. Só eles abrem o link, e leem as mensagens até aquele ponto: o texto, sem
o que a IA consultou no ERP. **Parar de compartilhar** desliga o link. No
mesmo menu: **Histórico**, **Fixar chat** e **Excluir**.

## Escolher o modelo

O botão ao lado do envio troca o **Modelo** e o **Esforço** (Leve, Médio ou
Alto). Modelos mais capazes pensam melhor em perguntas difíceis e consomem
mais do limite; os leves resolvem o dia a dia. **Saiba mais** mostra a ficha
de cada um. Veja [Uso e modelos](https://docs.apexx.work/ia/uso-e-modelos.md).

## Boas perguntas

| Em vez de | Pergunte |
| - | - |
| "Como está o estoque?" | "Quais produtos estão abaixo do estoque mínimo?" |
| "E as vendas?" | "Quanto faturei em setembro, comparado a agosto?" |
| "Tem algum problema?" | "Quais contas a pagar vencem esta semana?" |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.