> ## 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.

# Criar um agente — wizard passo a passo

> Guia detalhado do assistente de criação de agentes do ChatNorris, com os 6 passos explicados.

# Criar um agente — wizard passo a passo

O assistente de criação guia você pela configuração inicial do seu agente de IA em 6 passos. Você pode concluí-lo em poucos minutos, e o resultado é um agente pronto para testar.

Para começar, vá até **Meus agentes** no menu lateral e clique em **Novo agente** (ou **Criar seu primeiro agente** se você ainda não tiver nenhum). O assistente abre em tela cheia. No topo você vê os passos — **Tipo · Análise · Negócio · Treinamento · Modelo · Widget** — e pode clicar em um que já visitou para voltar. Com **← Voltar** você retorna ao passo anterior.

> [!NOTE]
>
> **Salvar e sair**, no canto superior direito, cria o agente como rascunho com o que você preencheu até aquele momento e leva você de volta a **Meus agentes**. Você pode completar o resto depois pelas abas do agente.

***

## Passo 1 — Tipo

A tela **O que o seu agente vai fazer?** mostra os templates disponíveis. Cada template traz instruções e campos prontos para esse trabalho; tudo pode ser ajustado depois. Você pode pesquisar com **Buscar template…** ou filtrar por categoria: **Todas**, **Atendimento**, **Vendas**, **Agenda**, **Setores** e **Equipe interna**.

| Tipo | Descrição |
| - | - |
| **Suporte ao cliente** | Resolve perguntas, problemas e dúvidas gerais de clientes |
| **Agente de IA geral** | Um assistente versátil para uma grande variedade de perguntas |
| **Agente de vendas** | Qualifica prospects, explica o valor e conduz à conversão |
| **Geração de leads** | Captura leads qualificados e os direciona ao próximo passo adequado |
| **Suporte e-commerce** | Ajuda com pedidos, produtos, envios, devoluções e políticas |
| **Recomendação de produtos** | Ajuda a encontrar o produto adequado de acordo com as necessidades do usuário |
| **Suporte técnico** | Diagnostica problemas técnicos e orienta passo a passo |
| **Onboarding SaaS** | Ajuda novos usuários a configurar a conta, aprender os fluxos e começar a usar |
| **Reservas e agendamento** | Responde perguntas sobre horários e orienta a agendar horários |
| **Assistente de RH e benefícios** | Responde perguntas internas sobre RH, políticas, benefícios e recursos de trabalho |
| **Helpdesk de TI interno** | Ajuda os funcionários com contas, dispositivos, acessos e ferramentas internas |
| **Assistente imobiliário** | Responde perguntas sobre imóveis, agenda visitas e ajuda compradores e locatários |
| **Recepção de saúde** | Responde perguntas da clínica ou consultório e direciona os pacientes |
| **Admissões educacionais** | Ajuda candidatos com programas, admissões e matrícula |
| **Viagens e hotelaria** | Responde perguntas de hóspedes e viajantes e orienta em reservas ou planejamento |
| **Assistente de restaurante** | Responde sobre cardápio, reservas, localização e restrições alimentares |
| **Recepção jurídica** | Coleta os detalhes iniciais de consultas jurídicas sem dar aconselhamento jurídico |
| **Assistente financeiro/seguros** | Ajuda com produtos financeiros, coberturas e orientação geral |
| **Assistente de eventos** | Responde perguntas sobre o evento e orienta no cadastro ou na participação |
| **Suporte ONG/doadores** | Responde perguntas de doadores, voluntários, programas e impacto |

### Campos do template

Alguns templates pedem dados adicionais que são inseridos nas instruções, marcados com a etiqueta **DO TEMPLATE**: por exemplo, **Meta de conversão** em Agente de vendas, **URL da política de devoluções** em Suporte e-commerce ou **Link de reservas** em Reservas e agendamento.

### Seu site

Digite o endereço do seu site em **Seu site** (por exemplo, `exemplo.com`) e clique em **Analisar meu site**. A partir dele o ChatNorris obtém o nome, a descrição, o logo e a cor da sua marca.

Se você não tem site, marque **Não tenho site** e preencha **Nome do negócio** e **O que o seu negócio faz?**. Sem site, o assistente pula a análise e o treinamento; você poderá enviar documentos depois pela [Base de conhecimento](https://docs.chatnorris.ai/pt/guias/knowledge-base.md).

> [!TIP]
>
> **Começar do zero** cria o agente na hora com o template escolhido e leva você ao painel dele, sem passar pelo resto do assistente.

***

## Passo 2 — Análise

Enquanto o ChatNorris analisa seu site, a tela **Construindo seu agente.** mostra o progresso:

1. Lendo seu site
2. Identificando sua marca
3. Resumindo o que você faz
4. Criando seu agente
5. Redigindo instruções
6. Escrevendo mensagens de boas-vindas

Se não for possível ler o site, você verá **Não conseguimos ler seu site.** («No pudimos leer tu web.»). Você pode continuar mesmo assim: preencha o nome e a descrição manualmente no passo seguinte.

***

## Passo 3 — Negócio

Em **Está tudo certo?** você revisa o que o ChatNorris detectou:

* **Nome do negócio** — o nome da sua empresa.
* **O que o seu negócio faz?** — uma descrição breve. É redigida no seu idioma mesmo que seu site esteja em outro, e é salva como descrição do agente.
* **Marca detectada** — o logo e a cor encontrados no seu site, que são usados no widget no final.

Corrija o que não estiver certo (seu agente se apresenta com isso) e clique em **Está certo**.

***

## Passo 4 — Treinamento

Em **Treine seu agente com seu site.** o ChatNorris procura as páginas públicas do seu site para adicioná-las à base de conhecimento do agente. Você verá quantas páginas ele encontrou, até um máximo de 60. Se não encontrar mais páginas, lê apenas a página principal.

* **Somente este domínio** — ignora subdomínios (como `blog.seusite.com`).
* Em **Opções avançadas**: **Excluir caminhos** (por exemplo `/blog, /legal, /admin`) e **Excluir domínios**.

Clique em **Treinar e continuar**, ou em **Pular por enquanto** se preferir escolher o conteúdo você mesmo mais tarde. Em **Meus agentes → \[seu agente] → Base de conhecimento** você pode rastrear seu site revisando as páginas antes de treinar, ou usar um sitemap, uma lista de URLs, documentos, texto ou perguntas frequentes. Veja [Base de conhecimento](https://docs.chatnorris.ai/pt/guias/knowledge-base.md).

***

## Passo 5 — Modelo

### Modelo de IA

**Escolha o modelo de IA.** O assistente sugere três opções, cada uma com seu custo em créditos por mensagem:

* o modelo **RECOMENDADO** (o melhor equilíbrio entre qualidade e custo),
* o mais econômico do seu plano (rápido, ideal para perguntas frequentes e alto volume),
* uma alternativa de outro provedor.

**Ver os N modelos** abre a lista completa, com campo de busca. Os modelos que seu plano não inclui aparecem com **Requer {plan}**. Você pode trocar o modelo quando quiser na configuração do agente. Para mais detalhes sobre qual escolher, consulte o [guia de modelos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md).

### Responder somente com a base de conhecimento

O interruptor **Responder somente com a base de conhecimento** (modo KB-Only) faz com que o agente, se não souber algo, diga isso em vez de inventar:

* O agente **não usa o conhecimento geral do modelo de IA**.
* É ideal para assistentes de suporte em que a precisão é prioridade.

Se você desativá-lo, o modelo pode complementar com seu conhecimento geral quando a base de conhecimento não tiver informações relevantes. Você pode alterá-lo depois em **Configurações → IA**.

### Instruções do agente (system prompt)

O campo **Instruções do agente** vem gerado com o template escolhido e com o que o ChatNorris leu sobre o seu negócio. Você pode editá-lo livremente; **Restaurar template** volta ao texto original, e **Usar valores sugeridos** redefine todo o passo.

**Estrutura recomendada:**

```
Você é [nome/função] da [empresa]. Sua missão é [objetivo principal].
Tom: [formal/amigável/conciso].
Limites: responda apenas perguntas sobre [temas permitidos].
Se não souber algo, diga isso e sugira entrar em contato pelo [canal de suporte].
```

***

## Passo 6 — Widget

Em **Dê um rosto ao seu agente.** você personaliza como seus visitantes verão o widget. As alterações aparecem na hora na **PRÉ-VISUALIZAÇÃO**, que você pode ver **Aberto** ou **Fechado**.

| Campo | Descrição |
| - | - |
| **Cor principal** | Cor do cabeçalho e do botão do widget. Se você analisou seu site, aparece primeiro a cor detectada (**Do seu site**); com **Escolher outra cor** você usa outra. |
| **Texto e ícones** | **Auto** escolhe branco ou escuro para que sempre seja legível; você também pode escolher **Branco** ou **Escuro** manualmente. |
| **Logo** | PNG, JPG, SVG ou WebP, até 2 MB. Se você analisou seu site, o logo detectado é usado até que você envie outro. |
| **Nome do agente** | É assim que o bot se apresenta no widget. Use um nome de pessoa ou de função, não o da empresa. |
| **Mensagem de boas-vindas** | A primeira mensagem que o widget mostra ao abrir. Vem sugerida com o nome do agente e do seu negócio. |

Clique em **Criar agente**.

> [!TIP]
>
> Você pode editar novamente todos esses valores a qualquer momento na aba **Personalizar** do agente. Lá você também encontra opções adicionais (branding, comportamento do widget, visibilidade) — veja [Personalizar o widget](https://docs.chatnorris.ai/pt/guias/widget-personalizacion.md).

***

## Depois do assistente

Ao terminar, o agente fica criado como **rascunho** em **Meus agentes** e você vê a lista **Para publicar**, com quatro passos que são marcados automaticamente à medida que você os conclui:

1. **Base de conhecimento** — é concluído com pelo menos uma fonte. Se você treinou com seu site no passo 4, já está pronto.
2. **Personalizar** — é concluído quando você salva em Personalizar ou envia seu próprio logo ou avatar.
3. **Testar no Playground** — é concluído com a primeira mensagem que você envia no Playground (ou com qualquer conversa real).
4. **Conectar um canal** — é concluído quando você publica o agente: o widget web em **Publicar**, ou WhatsApp, Instagram, Telegram, Messenger, Email ou Google Reviews na mesma aba.

Nessa tela você pode ir para **Meus agentes** ou direto para o Playground com **Testar no Playground →**. A mesma lista **Para publicar** aparece no cartão do agente em **Meus agentes** enquanto ele continuar como rascunho.

> [card] [Base de conhecimento](https://docs.chatnorris.ai/pt/guias/knowledge-base.md)
>
> Treine-o com o conteúdo da sua empresa.

> [card] [Instalar o widget](https://docs.chatnorris.ai/pt/guias/widget-instalacion.md)
>
> Copie o snippet e cole-o no seu site.

> [card] [Conectar canais](https://docs.chatnorris.ai/pt/guias/canales-whatsapp-instagram.md)
>
> Ative-o no WhatsApp, Instagram e outros canais.

> [card] [Personalizar o widget](https://docs.chatnorris.ai/pt/guias/widget-personalizacion.md)
>
> Ajuste cores, logo e mensagens.

> [card] [Ações do agente](https://docs.chatnorris.ai/pt/guias/acciones.md)
>
> Lead Form, Human Handoff, agendas, pagamentos e mais.

> [card] [Configuração avançada](https://docs.chatnorris.ai/pt/guias/configuracion-avanzada-agente.md)
>
> Segurança, variáveis e respostas predefinidas.


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