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

# Sua equipe de agentes de IA: tipos e configuração de cada agente

> Os seis tipos de agente predefinidos, o que você configura em cada agente e as opções extras dos agentes qualificadores, de vendas e de perguntas frequentes.

**Central de controle > Equipe de agentes** organiza agentes especializados para que cada um atenda a um tipo específico de necessidade. **Criar agente** parte de um de seis tipos predefinidos:

* **Agente qualificador**: faz perguntas-chave para entender o contato e reunir informações antes de encaminhá-lo.
* **Agente de vendas**: compartilha informações de produtos e serviços: opções, preços, disponibilidade, características.
* **Agente de perguntas frequentes**: responde a perguntas frequentes a partir das informações do seu negócio: horários, preços, processos, políticas.
* **Agente de agendamentos**: coordena compromissos e reservas com base na sua [disponibilidade de calendário](/pt/ai-agent/booking-and-calendars).
* **Agente de suporte**: cuida de dúvidas e problemas de clientes existentes.
* **Agente de faturamento**: responde sobre pagamentos, cobranças, faturas, recibos e métodos de pagamento.

Você não precisa pensar no roteamento. A plataforma lê o propósito de cada agente e decide qual atende cada conversa. Vários agentes podem participar da mesma conversa à medida que a necessidade do cliente muda.

## Como uma mensagem encontra o seu agente

<Steps>
  <Step title="Toda mensagem é roteada">
    Para cada mensagem, a Ciarem lê o tipo de cada agente ativo e o texto de **Em que momento este agente intervém na conversa?**, junto com a conversa até ali, e escolhe um agente com um nível de confiança. Esse texto é toda a descrição do cargo que o roteador vê, então escreva-o para ele.
  </Step>

  <Step title="O agente atual mantém a conversa">
    O agente que atendeu a mensagem anterior fica com as mensagens curtas, ambíguas ou de continuação ("e o anual?", "manda um por um"). A conversa só passa para outro agente diante de um assunto claramente novo que pertence a ele.
  </Step>

  <Step title="As capacidades pesam">
    Só agentes com acesso a catálogos podem enviar fotos ou arquivos de produtos. Só um agente de vendas com o [checkout](/pt/ai-agent/taking-orders) ativado pode registrar um pedido. Quando uma mensagem pede uma informação que a base de conhecimento de um agente cobre, o roteador prefere claramente esse agente. Um agente não pode usar o que não está ativado para ele.
  </Step>
</Steps>

<Warning>
  Um agente sem base de conhecimento nem catálogo ativados recebe essa informação, e responde "não tenho esse detalhe" a toda pergunta específica, e depois segue as regras de transferência. A causa mais comum de um agente que "não sabe nada" é um botão desligado na configuração dele, não um documento que falta.
</Warning>

## O que você configura em cada agente

* **Nome e ícone**: como o agente aparece na caixa de entrada e nos relatórios.
* **Quando este agente deve intervir**: uma descrição em linguagem simples do momento em que ele deve agir, do jeito que você orientaria um funcionário novo: "Interesse em planos, preços ou contratar nossos serviços". Mantenha-a específica; é isso que o roteamento lê.
* **Conhecimento**: ative quais [bases de conhecimento](/pt/ai-agent/knowledge-bases) este agente pode consultar para responder.
* **Acompanhamentos**: "Fazer acompanhamento quando o cliente para de responder". Escolha lembretes aos 15 minutos, 1 hora e/ou 2 horas. Consulte [Acompanhamentos proativos](/pt/ai-agent/follow-ups).
* **Botão de ligar/desligar**: cada agente pode ser ativado ou desativado individualmente pelo seu cartão.

## Configuração por tipo de agente

* Os **agentes qualificadores** têm **Perguntas que o agente vai fazer**. Cada pergunta carrega o texto da pergunta, uma propriedade opcional de **"Salvar a resposta"** (um campo nativo do contato como nome, e-mail, telefone ou cidade, ou qualquer propriedade personalizada que você tenha definido) e **"Quando perguntar"**: *Somente se não houver informação* (pula a pergunta quando a propriedade já está preenchida) ou *Perguntar sempre*. Arraste as perguntas para definir a ordem. As respostas caem no contato automaticamente, então a qualificação preenche o seu CRM enquanto a conversa acontece.
* Os **agentes de vendas** ganham um **link para continuar a compra**, enviado quando o agente detecta intenção de comprar, agendar ou pedir orçamento, além do acesso a catálogos (abaixo).
* **Agentes qualificadores, de vendas e de perguntas frequentes** podem receber **catálogos**: ative cada [catálogo](/pt/using-ciarem/catalogs) que o agente pode consultar e, opcionalmente, permita a ele **Adicionar conteúdo** ou **Editar conteúdo**. Por exemplo, um agente de vendas pode registrar um novo pedido enquanto um agente de perguntas frequentes fica em somente leitura. Agentes sem acesso a um catálogo não conseguem vê-lo.

<img src="https://mintcdn.com/ciaremaai/cNtTcjF_a4GWWvTG/images/pt/ciarem-help-agent-wizard.png?fit=max&auto=format&n=cNtTcjF_a4GWWvTG&q=85&s=39e7c088168bf3a96e152a2a95cb201d" alt="Configurando um agente qualificador: perguntas com uma propriedade para salvar a resposta e quando perguntar, além dos catálogos que ele pode consultar" width="1680" height="1114" data-path="images/pt/ciarem-help-agent-wizard.png" />

## Erros comuns

<AccordionGroup>
  <Accordion title="Dois agentes que reivindicam o mesmo momento" icon="code-branch" defaultOpen>
    Vendas: "perguntas sobre nossos serviços". Perguntas frequentes: "perguntas sobre o negócio". O roteador não tem com que separá-los, então a conversa pula entre dois agentes com conhecimento e estilo diferentes.

    | ❌ Sobrepostos                                                                                 | ✅ Momentos distintos                                                                                                                                                                                 |
    | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Vendas: "Perguntas sobre nossos serviços." Perguntas frequentes: "Perguntas sobre o negócio." | Vendas: "Interesse em comprar: planos, preços, o que está incluído, como contratar." Perguntas frequentes: "Horários, localização, políticas, como um serviço funciona, dúvidas de clientes atuais." |
  </Accordion>

  <Accordion title="Descrever o comportamento em vez do momento" icon="triangle-exclamation">
    "Seja simpático, responda rápido e sempre tente fechar a venda" é um briefing, não um gatilho. Nenhuma mensagem de cliente combina com isso. É a mesma confusão de escrever instruções na [base de conhecimento](/pt/ai-agent/knowledge-bases): o comportamento vive na [Configuração básica](/pt/ai-agent/basic-configuration) e nas [correções](/pt/ai-agent/playground). Este campo é o *quando*.

    | ❌                                              | ✅                                                                                                        |
    | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
    | "Seja simpático e sempre feche a venda."       | "O cliente pergunta sobre planos, preços ou como contratar."                                             |
    | "Ajude os clientes com o que eles precisarem." | "Problemas com um serviço ativo: algo não funciona, uma reclamação, uma mudança em um pedido existente." |
  </Accordion>

  <Accordion title="Um agente para tudo, ou agentes demais no primeiro dia" icon="layer-group">
    Um único agente para tudo não consegue fazer perguntas de qualificação *e* vender a partir de um catálogo *e* marcar compromissos. É o tipo que desbloqueia as ferramentas. Seis agentes com uma descrição de uma linha e sem conhecimento conectado também não ajudam: o roteador tem mais opções e o cliente recebe as mesmas respostas. Comece com dois ou três que tenham um trabalho de verdade, uma base de conhecimento e os catálogos de que precisam. Adicione outro quando a caixa de entrada mostrar uma necessidade distinta.
  </Accordion>

  <Accordion title="Nada ativado para o agente" icon="toggle-off">
    O agente foi criado e a base de conhecimento existe, mas o botão de **Conhecimento** desse agente nunca foi ligado, ou o catálogo nunca foi concedido. Toda pergunta específica recebe "não tenho esse detalhe".

    | ❌                                                         | ✅                                                                                                                                                                                                   |
    | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Agente de vendas sem catálogo e sem base de conhecimento. | Agente de vendas com o catálogo *Serviços* concedido e a base de conhecimento *Políticas* ativada. O cartão **Base de conhecimento** da Central de controle avisa quando faltam fontes aos agentes. |
  </Accordion>

  <Accordion title="Perguntas de qualificação demais" icon="list-ol">
    Dez perguntas antes de o cliente receber qualquer ajuda parecem um formulário, e as pessoas vão embora. Pergunte só o que muda o que você fará em seguida, salve cada resposta em uma propriedade do contato e use **Somente se não houver informação** para que contatos que voltam não sejam perguntados de novo.

    | ❌                                                                                                                                              | ✅                                                                                                                                                                                       |
    | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Nome, e-mail, telefone, empresa, cargo, cidade, orçamento, prazo, como nos conheceu, melhor horário para ligar, todas em **Perguntar sempre**. | Nome (salvo em nome), cidade (salva em cidade), o que precisa (salvo em uma propriedade personalizada), cada uma em **Somente se não houver informação**. O resto, uma pessoa pergunta. |
  </Accordion>

  <Accordion title="O tipo errado para o trabalho" icon="shapes">
    Um agente de suporte a quem você pede para vender não tem catálogo de onde vender: catálogos só podem ser concedidos a agentes qualificadores, de vendas e de perguntas frequentes. Um agente de perguntas frequentes a quem você pede para agendar não tem calendário: agendar vem com o agente de agendamentos e um [calendário conectado](/pt/ai-agent/booking-and-calendars). Escolha o tipo pelo que o agente precisa *fazer*. O tipo decide quais ferramentas ele pode ter.
  </Accordion>
</AccordionGroup>

## Quando algo parece errado

| O agente…                                       | Quase sempre porque                                                                                           | Solução                                                                           |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Diz que não tem essa informação                 | Nenhuma base de conhecimento ou catálogo ativado para esse agente, ou o fato não está na base de conhecimento | Ligue o botão na configuração do agente, ou adicione o fato                       |
| Fica alternando entre dois agentes              | Os textos de "em que momento intervém" deles se sobrepõem                                                     | Dê a cada um um momento distinto                                                  |
| Nunca usa o agente que você criou               | O texto dele não combina com como os clientes escrevem, ou o agente está pausado                              | Reescreva com as palavras do cliente; confira o botão no cartão dele              |
| Faz a mesma pergunta toda vez                   | A pergunta está em **Perguntar sempre**, ou a resposta não é salva em uma propriedade                         | Salve-a em uma propriedade com **Somente se não houver informação**               |
| Diz que não consegue enviar imagens ou arquivos | O agente não tem acesso a catálogos                                                                           | Conceda o catálogo a um agente de vendas, qualificador ou de perguntas frequentes |

A outra aba desta tela, **Regras de transferência**, decide quando um agente deve parar e passar a conversa para uma pessoa. Veja [Transferência para uma pessoa e regras de transferência](/pt/ai-agent/human-handoff-and-escalation).
