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

# Agentes de IA

> Crie um agente que atende seus clientes no WhatsApp, saiba quando ele responde e quando chama a equipe.

## Para que serve

O agente de IA responde seus clientes na hora, 24 horas por dia, faz as primeiras perguntas e chama a equipe quando precisa. Você acompanha tudo e pode pausar o agente em qualquer conversa.

Cada caixa é atendida por um agente. O **Principal** atende as caixas que não têm agente escolhido.

Aparece se a agência liberou o módulo Agentes de IA para a organização. Sem ele a tela diz: "Este módulo é liberado pela sua agência. Fale com ela para ativar."

## Quem pode

* **Dono e Admin** configuram os agentes.
* **Supervisor** vê tudo, mas não muda ("Você pode ver tudo, mas não mudar").
* **Operador** não abre a área. Na conversa ele pode **pausar o agente nesta conversa**, **passar a conversa para a equipe** e **devolver a conversa para o agente**.

## Onde clicar

No menu, **Agentes de IA** (`/ia`). Três abas: **Agentes**, **Ao vivo** e **O que o agente sabe**. Os ajustes gerais (**Momentos da conversa**, **Horário**, **Lembretes**, **Ferramentas**, **Avançado**) ficam em **Ajustes dos agentes**.

## Passo a passo

**1. Crie o agente**

Em **Agentes**, clique em **Novo agente** (ou **Criar agente do zero**). O primeiro vira o **Principal**. São seis passos, com a prévia do cliente ao lado.

**2. Quem é**

Defina **Nome que o cliente vê**, a função, **Quem pensa por ela** (a IA que escreve as respostas) e o **Jeito de falar**: **Simpática**, **Direta**, **Formal** ou **Descontraída**.

**3. O que sabe e onde atende**

Escolha os materiais que ele consulta, o que ele **NÃO responde** e **por quais caixas ele responde**.

**4. Quando atende**

Escolha **O dia todo, todos os dias**, **Só nestes horários** ou **Só fora do expediente**, e o que ele diz fora do horário.

**5. Quando chama a equipe**

Marque situações como o cliente pedir uma pessoa, reclamação ou o agente não saber responder depois de 2 tentativas.

**6. Ligar**

Clique em **Ligar agora**, ou em **Salvar desligada** para deixar para depois.

## O que acontece depois

O agente responde quem escreve para as caixas dele. Quando chama a equipe, a conversa vai para a fila com o resumo e ele para de responder nela. Veja o que está acontecendo em **Ao vivo**: **Atendendo agora**, **Passou para a equipe** e **Pausadas**. Em cada conversa há **Pausar o agente nesta conversa**, **Retomar** e **Assumir**.

No Instagram o agente responde curto e só dentro da janela de 24 h.

## Erros comuns

* **Os agentes de IA ainda não estão disponíveis.** O motor ainda não foi liberado para a organização. Nada foi alterado.
* **Falta a chave do provedor de: nome.** Esses agentes deixaram de responder. Cadastre a chave em [Chaves e leitura de mídia da IA](https://docs.stchat.app/subcontas/ia-chaves-e-transcricao.md).
* **O agente ainda não tem quem pense por ele.** Falta cadastrar uma chave.
* **Crie um agente principal antes de ligar os agentes.**
* **Escolha outro agente como principal antes de excluir este.**
* **Desligue os agentes antes de excluir o único agente.**
* **Você chegou ao limite de agentes** (também há limite de etapas, ferramentas e documentos). O número aparece na tela.
* **Nenhum número ativo é atendido por ele** e **Faltam as instruções**. Complete o passo indicado.
* **Só Dono e Admin testam o agente.**
* **O provedor falhou nas últimas respostas.** A conversa vai para a fila da equipe.

## Próximo passo

* [Chaves e leitura de mídia da IA](https://docs.stchat.app/subcontas/ia-chaves-e-transcricao.md)
* [Flows: visão geral](https://docs.stchat.app/subcontas/flows.md)
* [Atribuir e resolver conversas](https://docs.stchat.app/subcontas/atribuir-e-resolver.md)


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