> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configuração avançada do agente > Geral, IA, notificações, equipes, respostas salvas, segurança, limites de créditos e variáveis de cada agente. # Configuração avançada do agente Cada agente tem uma aba **Configurações** com estas seções: **Geral**, **Notificações**, **IA**, **Equipes**, **Respostas salvas**, **Segurança**, **Limites** e **Variáveis**. No mesmo menu você vai ver **Pesquisa de satisfação** e **Custom domain** com a etiqueta **Em breve**: elas ainda não estão disponíveis. Para chegar lá: `Agentes → [seu agente] → Configurações`. ## Geral * **Agent ID** — identificador único do agente, usado ao interagir com a [API](https://docs.chatnorris.ai/pt/api-referencia/introduccion.md). Não pode ser alterado; use **Copiar** para copiá-lo. * **Nome** e **Descrição** do agente. * **Timezone** — fuso horário usado pelas funções que dependem do horário, incluindo a IA: o agente conhece o dia, a data e a hora atuais nesse fuso horário, em todos os canais. * **Zona de perigo** — **Excluir agente** apaga o agente e toda a sua base de conhecimento. Pede confirmação e não pode ser desfeito. ## IA Na seção **IA** você define como o agente responde: * **Modelo** — o modelo de IA do agente. Cada modelo consome uma quantidade diferente de créditos por resposta; veja [Modelos de IA e créditos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md). * **Temperatura** — de **Preciso** a **Criativo**: um valor baixo gera respostas mais focadas e consistentes; um valor alto, mais variadas. Alguns modelos usam uma temperatura fixa do provedor e, neles, este controle não se aplica. * **Max tokens** — tamanho máximo de cada resposta. * **Limitar respostas à base de conhecimento** — se estiver ativado, o agente responde apenas com a sua base de conhecimento e não usa conhecimento geral. Se estiver desativado, ele pode usar conhecimento geral quando a base não tiver informações relevantes. * **System Prompt / Instruções** — as instruções do agente. Com **Explorar templates** você pode aplicar um template de acordo com o tipo de agente; se o template tiver campos próprios, você os edita em **Campos do template** e os aplica com **Aplicar ao system prompt**. ## Equipes Em **Equipes** você cria as equipes deste agente (nome, descrição, cor e membros) para encaminhar os handoffs às pessoas certas. Veja [Equipes por agente](https://docs.chatnorris.ai/pt/guias/equipo.md#equipes-por-agente). ## Segurança Controla quem pode acessar o widget web deste agente. > [card] Whitelist de domínios > > Lista de domínios onde o widget web pode ser carregado. Qualquer site fora da lista não conseguirá exibi-lo. Formato: `exemplo.com`, sem protocolo nem espaços. > [card] Geobloqueio > > Bloqueia visitantes de países específicos — o widget web fica oculto para esses países. > [card] Usuários bloqueados > > Bloqueia visitantes específicos pelo `visitor ID` para que não possam usar o widget web. > [card] Rate limiting > > Limite de mensagens que cada visitante pode enviar em uma janela de tempo (minuto, hora ou dia), com uma **Mensagem de erro personalizada** quando ele é ultrapassado. Se você deixar o campo de mensagens vazio, é usado o limite padrão do sistema. > [!TIP] > > A whitelist de domínios e o geobloqueio se aplicam apenas ao widget web: não afetam nenhum canal de mensagens (WhatsApp, Instagram, Telegram, Messenger nem Email). ## Variáveis As variáveis permitem inserir dados dinâmicos no system prompt do agente. ### Variáveis personalizadas Crie as suas próprias variáveis em `Configurações → Variáveis → Nova variável`: | Campo | Descrição | | - | - | | **Nome** | O identificador da variável (apenas letras, números e sublinhados). | | **Tipo** | **Texto**, **Número** ou **Booleano**. | | **Descrição** | Para que serve — ajuda você a lembrar ao escrever o prompt. | | **Valor padrão** | Valor usado se nenhum outro for especificado em tempo de execução. | ### Variáveis de sistema Além das que você cria, o ChatNorris expõe variáveis de sistema somente leitura (identificadas com a etiqueta **Sistema** na tabela), preenchidas automaticamente de acordo com o visitante e a conversa: | Variável | O que contém | | - | - | | `contact_fname`, `contact_city`, `contact_state`, `contact_country`, `contact_postal_code`, `contact_address` | Dados de localização/contato do visitante, quando disponíveis. | | `contact_company`, `contact_job_title`, `contact_industry`, `contact_website` | Dados da empresa do contato, quando disponíveis. | | `webpage_title`, `webpage_url` | Título e URL da página onde está o widget — apenas widget web. | | `user_id`, `chat_id` | Identificadores únicos do visitante e da conversa atual. | | `conversation_content` | Transcrição do chat (últimas 50 mensagens). | ## Respostas salvas Atalhos de texto para que um agente humano responda mais rápido durante um handoff, sem ter que reescrever as mesmas respostas. **1. Vá para Configurações → Respostas salvas** Você verá a lista de respostas salvas deste agente. **2. Crie uma resposta** Clique em **Criar resposta salva** e preencha **Título** (para identificá-la na lista), um **Shortcut** opcional (atalho de texto, por exemplo `/saudacao`) e o **Corpo** (a mensagem que será enviada). **3. Use-a durante um handoff** No chat ao vivo, selecione a resposta salva para inseri-la sem digitá-la de novo. ## Limites de créditos Além da cota geral de créditos de IA do seu plano, você pode definir um teto mensal de créditos **por agente** — útil se você tem vários agentes e quer distribuir o consumo entre eles. * Ative o interruptor para habilitar um teto mensal específico para este agente. * **Limite mensal** — a quantidade máxima de créditos de IA que o agente pode consumir no mês. * O uso atual do mês (consumo real, não estimado) e a data de reinício do contador aparecem na mesma tela. > [!NOTE] > > Este limite é adicional à cota de créditos do seu plano geral — serve para controlar o consumo de um agente específico, não para ampliá-lo além do seu plano. ## Notificações do agente Em `Configurações → Notificações` você pode alterar, apenas para este agente, os canais (**Email**, **Sino**, **Push**) e os destinatários de email dos eventos de conversa: | Evento | Quando avisa | | - | - | | **Handoff solicitado** | Um visitante pede para falar com uma pessoa. | | **Handoff sem atendimento** | Ninguém respondeu a um handoff dentro da meta de primeira resposta da ação Human Handoff. | | **Novo lead** | Um visitante deixa os seus dados de contato. | | **Pergunta sem resposta** | A última mensagem do visitante está há algum tempo sem resposta. | | **Nova conversa** | Uma conversa nova é iniciada com este agente. | Cada evento pode ficar em **Herdar**, para usar as configurações da organização, ou ter valores próprios para este agente. Os eventos de créditos (uso e créditos esgotados) são configurados apenas no nível da organização. Veja o detalhe completo de eventos, canais e destinatários em [Notificações](https://docs.chatnorris.ai/pt/guias/notificaciones.md). ## Perguntas frequentes > [accordion] A whitelist de domínios afeta o WhatsApp, o Instagram ou outros canais? > > Não. Ela se aplica apenas ao widget web. Os canais de mensagens são gerenciados separadamente na aba Publicar. > [accordion] Posso usar variáveis personalizadas junto com as variáveis de sistema no mesmo prompt? > > Sim. Ambas são referenciadas da mesma forma no system prompt do agente. > [accordion] As respostas salvas são compartilhadas entre agentes? > > Não, cada agente tem a sua própria lista de respostas salvas. > [accordion] O que acontece se um agente atingir o seu limite mensal de créditos? > > O agente para de responder até que o contador seja reiniciado no mês seguinte, mesmo que o seu plano geral ainda tenha cota disponível. Você pode desativar o limite a qualquer momento. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.