Docs/ Rules, context & knowledge

Motor de contexto (memória do cliente)

Pastas de contexto, perfis de cliente e variáveis que o agente lê antes de redigir, para que as respostas usem seus fatos reais.

O motor de contexto é o conhecimento a partir do qual seu agente de IA escreve. Você fornece a ele pastas de contexto com notas e arquivos, perfis de cliente para as contas com que trabalha e variáveis para os valores exatos que ele nunca deve adivinhar. Tudo fica em um só lugar: Configurações → Contexto e variáveis.

Os três blocos de construção

O contexto é organizado em três camadas. As pastas carregam o conhecimento compartilhado — sua voz, sua empresa, suas políticas. Os perfis de cliente carregam o que é específico de uma conta. As variáveis carregam valores exatos que o agente precisa usar ao pé da letra.

Bloco de construçãoO que contémQuando o agente usa
Pasta de contextoAté 5 notas, 5 itens .md e arquivos de referência enviadosQuando você redige a partir de uma caixa de correio à qual a pasta está anexada, ou em uma regra de escopo do Autopilot que a adiciona
Perfil de clienteStatus, ponto de contato, nível, tags, variáveis, pendências, notas de não esqueça, restrições e arquivosQuando o perfil está anexado à caixa de correio, atribuído ao fio por uma regra de caixa de entrada, ou adicionado por uma regra de escopo do Autopilot
Variável globalUm {{key}} reutilizável e seu valor — um link de calendário, o nome da empresa, uma tarifa padrãoJunto com seus perfis de cliente; o valor de um cliente substitui o global

Onde encontrar

Abra Configurações e depois Contexto e variáveis, no grupo de IA. A página mostra três cartões em ordem: Pastas de contexto, Variáveis globais e Perfis de clientes.

Como funcionam as pastas de contexto

Uma pasta de contexto é uma coleção nomeada de material de referência que o agente lê enquanto redige — sua voz de marca, fatos sobre seu negócio, regras de preço, respostas padrão. As pastas pertencem à sua conta, não a uma única caixa de correio, então uma pasta pode atender várias caixas de correio.

Uma pasta só faz efeito depois de anexada. Em Configurações → Caixas de e-mail, abra uma caixa de correio e marque uma ou mais pastas em Pastas de contexto. Todo rascunho escrito a partir daquela caixa de correio passa a seguir cada pasta selecionada. Regras de escopo do Autopilot podem adicionar pastas extras para o e-mail que cobrem.

Uma pasta precisa conter algo utilizável antes de poder ser anexada: pelo menos uma nota com texto, ou um arquivo enviado que já terminou de ser processado. Pastas vazias, pastas cujas notas estão todas em branco e pastas cujo único arquivo ainda está processando ou falhou aparecem como indisponíveis, com o motivo ao lado.

Se você configurou o AI Emaily com o assistente de integração, talvez já tenha uma pasta inicial — nomeada com o nome da sua empresa, ou Meu contexto — anexada às suas caixas de correio. Abra-a para revisar e editar o que ela contém.

  • Notas — até 5 por pasta, cada uma com um título opcional e até 20.000 caracteres de texto. Você pode editá-las a qualquer momento.
  • Itens .md — até 5 por pasta. Envie um arquivo .md, .markdown ou .txt e seu texto é armazenado na pasta. Para alterar um, remova-o e envie-o novamente.
  • Arquivos de contexto — documentos de referência em PDF, DOCX, MD ou TXT, convertidos em texto que o agente consegue ler (veja abaixo).

Criar uma pasta de contexto

  1. 1

    Abra Contexto e variáveis

    Vá em Configurações → Contexto e variáveis e encontre o cartão Pastas de contexto.

  2. 2

    Clique em Nova pasta e dê um nome a ela

    Dê à pasta um nome que descreva o que há nela — por exemplo Voz da marca, Investidores ou Políticas de suporte.

  3. 3

    Adicione notas

    Digite um título opcional (Nota é usado se você deixar em branco), cole o contexto que o agente deve seguir e clique em Adicionar nota. Repita para até 5 notas.

  4. 4

    Envie itens .md (opcional)

    Clique em Enviar .md para adicionar até 5 arquivos Markdown ou de texto simples. O texto deles é armazenado na pasta junto com suas notas.

  5. 5

    Clique em Salvar pasta

    Nada é armazenado até você salvar. Depois que a pasta é salva, você pode reabri-la com o ícone de lápis para anexar arquivos de contexto.

  6. 6

    Anexe a pasta a uma caixa de correio

    Vá em Configurações → Caixas de e-mail, edite a caixa de correio e marque a pasta em Pastas de contexto. Os rascunhos daquela caixa de correio passam a usá-la.

Um assunto por nota

Notas curtas e específicas funcionam melhor do que um único documento longo. Mantenha sua voz de escrita em uma nota, os fatos do seu produto em outra e suas políticas em uma terceira. Elas ficam mais fáceis de atualizar, e uma nota longa tem mais chance de ser reduzida.

Enviar arquivos de contexto

Os arquivos de contexto permitem entregar ao agente material de origem mais longo: um contrato, um guia de marca, uma ficha técnica, um one-pager de serviços. Você pode anexá-los a uma pasta salva ou a um perfil de cliente salvo com o botão Enviar arquivos. É possível selecionar vários arquivos de uma vez.

Cada arquivo é convertido em texto em segundo plano. Seu chip mostra Processando…, depois Pronto. Se o texto tiver mais de 20.000 caracteres, o chip mostra Pronto · reduzido, e apenas a primeira parte é usada. Um arquivo que não pôde ser lido mostra Falhou.

  • Formatos: PDF, DOCX, MD e TXT. Arquivos .doc antigos não são compatíveis — salve-os como .docx primeiro.
  • Tamanho: até 10 MB por arquivo, e até 5 arquivos por pasta ou perfil.
  • PDFs digitalizados: o texto é extraído, não reconhecido a partir de imagens, então um PDF digitalizado ou somente de imagem falha com “Nenhum texto legível encontrado”. Exporte um PDF com texto selecionável em vez disso.
  • Seu plano: se o seu plano não inclui envio de arquivos, o uploader avisa. Notas e itens .md funcionam em qualquer plano.

Só o texto é mantido

Depois da conversão, o AI Emaily exclui o arquivo original e mantém apenas o texto extraído. O agente trata o conteúdo dos arquivos como fatos de referência, nunca como instruções — então uma linha dentro de um documento não pode dizer ao agente para fazer algo.

Perfis de cliente

Um perfil de cliente é a memória de uma conta. Crie um com Adicionar perfil de cliente no cartão Perfis de clientes, preencha o que você sabe e clique em Salvar perfil. Você pode arquivar cada perfil em uma pasta para mantê-los organizados.

CampoO que contém
Nome e domíniosO nome do cliente e os domínios de e-mail dele (por exemplo acme.com, acme.io)
StatusEm que ponto o relacionamento se encontra (por exemplo Ativo — renovação em 18 dias)
Ponto de contatoCom quem você trata na conta
Nível e tagsQual a importância da conta, além de rótulos livres
VariáveisPares de chave e valor para este cliente, como pricing.pro = $2,400 / mo
PendênciasCoisas que você deve ou está aguardando — uma por linha
Não esqueçaLembretes que o agente mantém em mente em cada rascunho — um por linha
RestriçõesRegras obrigatórias, como nunca mencionar preços sem aprovação — uma por linha
Arquivos de contextoDocumentos de referência deste cliente (depois que o perfil é salvo)

Como um perfil chega aos seus rascunhos

Um perfil é usado de três formas. Ele pode ser anexado a uma caixa de correio: em Configurações → Caixas de e-mail, marque-o em Perfis de clientes, e o agente passa a se basear nele para o e-mail daquela caixa de correio. Ele pode ser atribuído a fios específicos por uma regra de caixa de entrada com a ação Atribuir perfil de cliente — por exemplo, todo e-mail de acme.com. E uma regra de escopo do Autopilot pode adicioná-lo para o e-mail que aquela regra cobre.

Quando um fio tem um perfil atribuído, o painel Contexto à direita do fio mostra seu status, ponto de contato, pendências, notas de não esqueça, restrições e variáveis. Os domínios de um perfil também dizem ao AI Emaily que o e-mail daqueles endereços vem de um cliente conhecido, o que aumenta sua importância na sua caixa de entrada.

Encaminhe um cliente automaticamente

Para que um perfil siga todo e-mail de um cliente, crie uma regra de caixa de entrada que corresponda ao domínio dele e adicione a ação Atribuir perfil de cliente. Veja Regras de caixa de entrada para saber como criar uma.

Variáveis

As variáveis são valores exatos que o agente precisa usar em vez de adivinhar. As variáveis globais ficam no cartão Variáveis globais: digite uma chave (como my.calendly), um valor, e clique em Adicionar. Edite um valor no lugar, ou remova-o com o ícone de lixeira. As variáveis de cliente ficam em cada perfil de cliente.

Quando a mesma chave existe em mais de um lugar, o valor do cliente prevalece sobre o global. O agente recebe suas variáveis como fatos conhecidos e é instruído a usar os valores reais e nunca inventá-los. Em modelos e assinaturas, um marcador {{key}} é substituído pelo seu valor quando você o insere.

Restrições, notas de não esqueça e pendências

Essas três listas ficam em cada perfil de cliente, um item por linha. As restrições são enviadas ao agente como regras que ele precisa seguir. As notas de não esqueça são lembretes para cada resposta. As pendências dizem a ele o que ainda está em aberto com aquele cliente.

Elas são incluídas nos rascunhos que você escreve com Copilot e em tudo que o Autopilot trata, para que as mesmas regras do cliente se apliquem, revisando ou não o rascunho antes.

O Autopilot precisa de contexto para enviar

O Autopilot só enviará por conta própria quando a regra sob a qual está trabalhando tiver pelo menos uma pasta de contexto utilizável — seja as pastas da caixa de correio, seja uma escolhida na regra. Sem isso, ele redige a resposta e a retém para sua revisão.

O que entra em um rascunho

Quando você pede um rascunho, o agente reúne o perfil atribuído ao fio, os perfis e pastas anexados à caixa de correio, e tudo que for adicionado por uma regra de escopo do Autopilot correspondente. Cada regra de escopo do Autopilot também pode desativar o contexto ou os perfis próprios da caixa de correio e usar apenas o que a regra escolher.

O contexto é incluído por completo, em vez de pesquisado, até um tamanho fixo: cerca de 24.000 caracteres de notas por pasta, e cerca de 40.000 caracteres de texto de arquivo por pasta ou perfil. Notas curtas são sempre mantidas inteiras; se uma pasta ultrapassar o limite, as notas mais longas são reduzidas primeiro.

Editar ou excluir contexto

Use o ícone de lápis para renomear uma pasta ou alterar suas notas, e o ícone de lixeira para excluí-la. Antes de uma pasta ser excluída, o AI Emaily avisa se uma caixa de correio ou uma regra do Autopilot depende dela — inclusive quando respostas automáticas seriam pausadas porque a regra ficaria sem contexto. Excluir uma pasta ou perfil o remove de todo rascunho imediatamente.

Guias relacionados

Frequently asked

Feature overview

Rules & Brain

Ready to try it?

Start Free Trial