Antes de comecar
Para configurar um Agente de IA no Z-PRO voce precisa de duas coisas: acesso de administrador ao sistema e uma chave de API de um dos provedores suportados (OpenAI, Anthropic ou Google). Se ainda nao tem a chave, crie uma conta no site do provedor escolhido e gere a chave antes de prosseguir.
Passo 1: acesse o modulo de Agentes de IA
No menu lateral do Z-PRO, clique em Automacao e depois em Agentes de IA. Voce vera a listagem de agentes existentes. Para criar o primeiro, clique no botao Novo Agente.
Passo 2: configure a aba Perfil
A aba Perfil e onde voce define a identidade e o comportamento do agente. Preencha os campos:
- Nome do agente: use um nome interno que identifique a funcao, como Atendimento Inicial ou Qualificacao de Leads.
- Instrucoes do sistema: este e o campo mais importante. Escreva aqui quem e o agente, qual e a empresa, qual e o tom de voz esperado e quais sao as restricoes. Por exemplo: voce e o assistente virtual da empresa. Atenda com cordialidade e responda apenas sobre os produtos e servicos disponíveis.
- Mensagem de boas-vindas: texto enviado automaticamente quando o agente assume a conversa.
- Tempo limite de inatividade: define em quantos minutos de silencio o agente encerra a sessao ou transfere para humano.
Passo 3: configure a aba Provedor
Na aba Provedor, selecione qual modelo de IA sera usado:
- OpenAI: insira a chave de API e escolha o modelo. GPT-4o e uma boa opcao para equilibrio entre qualidade e custo.
- Anthropic (Claude): insira a chave e escolha entre os modelos Claude disponiveis.
- Google (Gemini): insira a chave da API do Google AI Studio e escolha o modelo.
Apos inserir a chave, use o botao de teste para verificar se a conexao esta funcionando antes de salvar.
Passo 4: configure a aba Conhecimento
Aqui voce alimenta o agente com informacoes da empresa. Voce pode importar PDFs, documentos Word, URLs de paginas e pares de pergunta e resposta. O sistema usa busca semantica para localizar os trechos mais relevantes em cada atendimento. Para o primeiro agente, comece com um documento de FAQ ou a descricao dos principais servicos.
Passo 5: configure a aba Roteamento
O roteamento define em quais filas ou conexoes do WhatsApp o agente vai atuar, e o que acontece quando ele nao consegue resolver a solicitacao. Configure pelo menos uma regra de transferencia para humano, indicando para qual fila ou atendente a conversa deve ir caso o agente identifique a necessidade.
Passo 6: configure a aba Ferramentas
As ferramentas ampliam o que o agente pode fazer alem de responder texto. Aqui voce ativa acoes como mover o contato no funil de vendas, aplicar tags, registrar informacoes na ficha do contato e disparar webhooks para sistemas externos. Ative apenas as ferramentas que fazem sentido para o fluxo que voce esta construindo.
Passo 7: salve e teste
Salve o agente e envie uma mensagem de teste pelo WhatsApp conectado a fila configurada. Observe se as respostas estao alinhadas com as instrucoes do perfil e se o agente esta consultando a base de conhecimento corretamente. Ajuste as instrucoes do sistema conforme necessario ate o comportamento estar dentro do esperado.
Dicas para o primeiro agente
Comece simples. Um agente que responde bem a 10 perguntas frequentes ja gera valor imediato. Voce sempre pode expandir a base de conhecimento e ativar mais ferramentas depois que o comportamento basico estiver estavel.
