> ## 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. # Agentes de IA > Como criar, configurar e gerenciar seus agentes de IA no ChatNorris. # Agentes de IA Um agente no ChatNorris é um assistente de inteligência artificial que responde perguntas com base na sua base de conhecimento. Você pode criar vários agentes, cada um com uma personalidade e um propósito diferentes. > [!TIP] > > Para um guia detalhado do wizard de criação passo a passo, acesse [Criar um agente — wizard passo a passo](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). ![Lista de agentes](https://mintcdn.com/chatnorris/16qwVirrkIq_uU-z/images/ListaDeAgentes.png?fit=max\&auto=format\&n=16qwVirrkIq_uU-z\&q=85\&s=c2cfb5af4d4db565cfe03ccfd4a2da97) ## Meus agentes Em **Meus agentes**, cada agente aparece como um cartão com seu avatar (o mesmo do widget), tipo, status (**Publicado** ou **Rascunho**) e canais conectados: * Os agentes **publicados** mostram suas conversas dos últimos 7 dias (com a variação em relação à semana anterior), a porcentagem resolvida pela IA, os leads e, em laranja, quantas pessoas estão esperando alguém da equipe. * Os **rascunhos** mostram o checklist **Para publicar** (**Base de conhecimento**: pelo menos uma fonte; **Personalizar**: você salvou alterações em Personalizar ou enviou seu logo ou avatar; **Testar no Playground**: você enviou uma mensagem no Playground ou houve uma conversa real; **Conectar um canal**: o agente está publicado) e o botão **Continuar →**, que leva você ao primeiro passo pendente. * O menu de cada cartão tem **Playground**, **Configurações**, **Publicar/Despublicar widget** e **Excluir**. Acima da lista você vê a cota de agentes do seu plano ("N de M agentes"). Se você atingiu a cota, **Novo agente** e o cartão **Cota completa** permitem solicitar agentes adicionais (veja [Add-ons](https://docs.chatnorris.ai/pt/cuenta-y-facturacion/addons.md)) ou ver o plano seguinte. ## Tipos de agente Ao criar um agente, você escolhe um tipo que pré-configura as instruções do sistema com um template otimizado para esse caso de uso. Os tipos disponíveis incluem: suporte ao cliente, vendas, geração de leads, e-commerce, suporte técnico, onboarding SaaS, reservas e agendamento, RH, imobiliário, saúde, educação, restaurante e mais. Você pode ver a lista completa e suas descrições no [wizard de criação](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md#passo-1-—-tipo). Depois de criar o agente, você pode editar livremente as instruções do sistema para ajustá-las às suas necessidades específicas. ## Modo KB-Only (somente base de conhecimento) O modo **KB-Only** limita o agente a responder apenas com as informações que você tem indexadas na sua base de conhecimento. Quando está ativado: * O agente **não usa o conhecimento geral do modelo de IA**. * Se não tiver informações sobre algo, ele diz isso claramente e sugere entrar em contato com a equipe. * Ideal para assistentes de suporte em que a precisão e o controle são prioridade. É opcional: o assistente de criação o deixa ativado por padrão e você pode ativá-lo ou desativá-lo a qualquer momento em **Configurações → IA** (**Limitar respostas à base de conhecimento**). Se estiver desativado, o agente pode usar seu conhecimento geral quando a base de conhecimento não tiver informações relevantes. ## Criar um agente Em **Meus agentes**, clique em **Novo agente**. Abre-se um assistente de 6 passos: 1. **Tipo** — você escolhe um template de acordo com o que o agente fará e, se quiser, a URL do seu site. 2. **Análise** — o ChatNorris examina seu site para detectar sua marca e redigir as instruções. 3. **Negócio** — você confirma o nome e a descrição do seu negócio. 4. **Treinamento** — as páginas do seu site (até 60) são adicionadas à base de conhecimento, ou você pula esse passo e adiciona fontes depois. 5. **Modelo** — modelo, modo KB-Only e instruções do agente. 6. **Widget** — cor, logo, nome do agente e mensagem de boas-vindas. Se você não tem site, o assistente pula do passo 1 para o 5. Ao clicar em **Criar agente**, o agente fica como **Rascunho** em **Meus agentes**, com a lista **Para publicar**. Com **Salvar e sair** você pode deixá-lo pela metade e terminá-lo depois. [Ver o assistente passo a passo →](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md) ## Status do agente | Status | Significado | | - | - | | **Rascunho** | O widget não está publicado e o agente não tem nenhum canal ativo | | **Publicado** | O widget web está publicado ou o agente tem pelo menos um canal ativo | Para publicar ou despublicar o widget, use a aba **Publicar** do agente ou o menu do cartão dele em **Meus agentes** (**Publicar widget** / **Despublicar widget**). ## O workspace de um agente Ao entrar no detalhe de um agente, a configuração está organizada em abas: | Aba | Para que serve | | - | - | | **Painel** | Visão operacional do agente: caixa de entrada ao vivo, conversas que precisam de atenção, saúde da base de conhecimento e indicadores dos últimos 7 dias. Veja [Painel](#painel). | | **Análises** | Métricas do agente. Veja [Análises](https://docs.chatnorris.ai/pt/guias/analytics.md). | | **Base de conhecimento** | Base de conhecimento do agente. Veja [Base de conhecimento](https://docs.chatnorris.ai/pt/guias/knowledge-base.md). | | **Ações** | Lead Form, Human Handoff, agendas, pagamentos, tickets e outras ações que o agente pode executar na conversa. Veja [Ações do agente](https://docs.chatnorris.ai/pt/guias/acciones.md). | | **Playground** | Conversar com o agente para testar respostas antes de publicá-lo. | | **Conversas** | Conversas deste agente em particular. | | **Leads** | Contatos capturados por este agente. Veja [Leads](https://docs.chatnorris.ai/pt/guias/leads.md). | | **Campanhas** | Campanhas outbound do agente (em fase piloto). Veja [Campanhas](https://docs.chatnorris.ai/pt/guias/campanas.md). | | **Publicar** | Publicar o widget web e conectar e gerenciar os canais do agente (WhatsApp, Instagram, Telegram, Messenger, Email e Google Reviews). Veja [Publicar](#publicar-canais-do-agente). | | **Personalizar** | Aparência do widget: Branding, Interface, Visibilidade, Textos e Configurar. Veja [Personalizar o widget](https://docs.chatnorris.ai/pt/guias/widget-personalizacion.md). | | **Integrações** | Conectar as contas externas que as ações e a base de conhecimento usam. Veja [Integrações](https://docs.chatnorris.ai/pt/guias/integraciones.md). | | **Configurações** | Nome e dados do agente (**Geral**), notificações, modelo e parâmetros de IA (**IA**), equipes, respostas salvas, segurança, limites de créditos e variáveis. Veja [Configuração avançada do agente](https://docs.chatnorris.ai/pt/guias/configuracion-avanzada-agente.md) e [Equipes por agente](https://docs.chatnorris.ai/pt/guias/equipo.md#equipes-por-agente). | ## Painel O **Painel** (o geral, no menu lateral, e o de cada agente) é uma visão operacional, disponível em todos os planos: * **Caixa de entrada ao vivo** — conversas **Abertas**, **Aguardando humano** (com a espera mais antiga), **Não atribuídas** e **Não lidas**. Cada número abre Conversas com esse filtro aplicado. * **Precisam de atenção** — primeiro os handoffs mais antigos e depois as conversas não lidas. * **Saúde da base de conhecimento** — fontes com erro ou paradas, com link para a base de conhecimento. * **Indicadores de 7 dias** em relação aos 7 anteriores: conversas, resolvidas pela IA (sem handoff), leads e créditos de IA. * No Painel geral, além disso: **Requer configuração** (fontes com erro, integrações vencidas ou com erros, agentes sem canais), créditos de IA do mês por agente e uma tabela de agentes. O Painel se atualiza sozinho quando há atividade (um handoff, uma mensagem ou um encerramento). Para o detalhe completo, **Ver análises completas** leva você a [Análises](https://docs.chatnorris.ai/pt/guias/analytics.md). ## Publicar (canais do agente) A aba **Publicar** agrupa os canais do agente em **Conectados**, **Disponíveis** e **Não incluídos no seu plano**. Para cada canal conectado você vê a conta, o idioma, o encerramento por inatividade e as conversas dos últimos 7 dias, além de um interruptor **Ativo** para pausá-lo (ou publicar/despublicar o widget) sem desconectá-lo. Uma barra de resumo permite copiar o código do widget. * **WhatsApp, Instagram, Telegram e Messenger** são conectados e configurados em um painel lateral (idioma, encerramento por inatividade, status do webhook do Telegram e desconectar). Veja [WhatsApp, Instagram e outros canais](https://docs.chatnorris.ai/pt/guias/canales-whatsapp-instagram.md). * **Web** tem sua própria página com a instalação do widget e o encerramento por inatividade. Veja [Instalar o widget](https://docs.chatnorris.ai/pt/guias/widget-instalacion.md). * **Email** tem sua própria página com a conexão, o comportamento, a assinatura e o guia de encaminhamento; se ainda não estiver conectado, um assistente de 3 passos. Veja [Canal Email](https://docs.chatnorris.ai/pt/guias/canal-email.md). A seção **Canais** do menu lateral mostra os canais de todos os seus agentes em uma única visão. ## Editar um agente 1. Vá até **Meus agentes** e clique no agente que você quer modificar. 2. Em **Configurações → Geral** você pode alterar o nome, a descrição e o fuso horário. Em **Configurações → IA** você edita o modelo, a temperatura, o máximo de tokens, a opção **Limitar respostas à base de conhecimento** (modo KB-Only) e o **System Prompt / Instruções**, que você pode começar a partir de um template com **Explorar templates**. 3. Salve as alterações com o botão **Salvar alterações**. As alterações no prompt são aplicadas imediatamente nas novas conversas. > [!WARNING] > > Modificar as instruções do sistema pode mudar significativamente o comportamento do bot. Sempre teste as alterações no **Playground** antes de publicar. ## Testar um agente Antes de implantá-lo, você pode testar o agente diretamente pelo portal: 1. Entre no detalhe do agente. 2. Clique na aba **Playground**. 3. Escreva mensagens como se fosse um cliente e verifique as respostas. > [!WARNING] > > Algumas ações gravam em serviços externos mesmo no Playground: os tickets do Zendesk, Freshdesk e Odoo e as reservas do Encuadrado, Cal.com e Calendly são reais. Se o agente tiver alguma delas, antes da primeira mensagem você verá o aviso **Este teste pode criar dados reais** («Esta prueba puede crear datos reales») com **Continuar** e **Cancelar**. Os links de pagamento nunca são criados no Playground. ![Playground](https://mintcdn.com/chatnorris/ZBI3jrViaJTqLSlk/images/Playground.png?fit=max\&auto=format\&n=ZBI3jrViaJTqLSlk\&q=85\&s=45f55e009d9151573a1c1a78a9e31fec) ## Instalar o widget no seu site Depois de publicado, você pode obter o código de instalação: 1. Entre no detalhe do agente e vá até a aba **Publicar**. 2. Copie o snippet HTML do cartão do widget web. 3. Cole-o no HTML do seu site, antes do fechamento de ``. O widget aparece como um botão flutuante no canto inferior da sua página. Na mesma aba **Publicar** você também conecta o WhatsApp e o Instagram. [Ver o guia completo de instalação do widget →](https://docs.chatnorris.ai/pt/guias/widget-instalacion.md) ## Perguntas frequentes sobre agentes > [accordion] Quantos agentes posso criar? > > Depende do seu plano. O plano gratuito inclui 1 agente. Os planos pagos incluem mais. Acima de **Meus agentes** você vê quantos agentes está usando da sua cota, e seu plano em **Faturamento e uso**. > [accordion] O bot responde perguntas que não estão na minha base de conhecimento? > > Depende do modo **KB-Only**. Se estiver ativado (é o que o assistente de criação deixa por padrão), o agente responde apenas com a sua base de conhecimento e, se não tiver informações sobre algo, diz isso. Se você desativá-lo em **Configurações → IA** (**Limitar respostas à base de conhecimento**), o agente pode usar seu conhecimento geral quando a sua base de conhecimento não tiver informações relevantes. > [accordion] Posso ter agentes em idiomas diferentes? > > Sim. Defina o idioma no prompt do sistema e adicione conteúdo nesse idioma à base de conhecimento. O bot responderá no idioma em que o usuário escrever, se o conteúdo permitir. > [accordion] Qual é a diferença entre os modelos de IA disponíveis? > > Eles variam em capacidade, velocidade e custo em créditos. O **Claude Haiku 4.5** é o recomendado por padrão: rápido, preciso para atendimento ao cliente e consome 1 crédito por resposta. Os modelos mais capazes, como **Claude Sonnet 4.6, 5 ou 5.5** (3 créditos), são indicados para consultas complexas ou ações que criam algo real. Veja a tabela completa em [Modelos de IA e créditos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.