Funcionário de IA

Importante: Funcionários de IA são agentes autônomos que podem lidar com conversas, acessar ferramentas, recuperar conhecimento e executar ações em nome de sua organização. Eles aprendem com seus dados e se adaptam às necessidades do seu negócio.

​

🔢 Índice

1. What is an AI Employee?
2. Creating Your First AI Employee
3. Configuring AI Employee Settings
4. Adding Knowledge with Datastores
5. Connecting Tools
6. Deploying Your AI Employee
7. Monitoring and Optimization
8. Best Practices

​

1. O que é um funcionário de IA?

​

Visão geral

• Tenha conversas naturais com os usuários
• Responda perguntas usando sua base de conhecimento personalizada
• Execute ações por meio de ferramentas conectadas
• Qualificar leads e coletar informações
• Transferência para agentes humanos quando necessário
• Trabalhe 24 horas por dia, 7 dias por semana, em vários canais

• Compreensão da linguagem natural: compreende a intenção e o contexto do usuário
• Recuperação de conhecimento: pesquisa armazenamentos de dados em busca de informações precisas
• Uso de ferramentas: chama APIs, envia formulários, gera leads
• Multicanal: Funciona em chat na web, WhatsApp, Messenger, Telegram e muito mais
• Transferência para humanos: transfere perfeitamente casos complexos para sua equipe
• Aprendizado contínuo: melhora com conversas e feedback

​

Casos de uso comuns

• Responda perguntas frequentes automaticamente
• Solucionar problemas comuns
• Orientar os usuários através dos processos
• Escalar para agentes humanos quando necessário

• Qualifique leads de entrada
• Agende demonstrações e reuniões
• Responder a perguntas sobre produtos
• Coletar informações de contato

• Assistência de RH aos funcionários
• Automação de helpdesk de TI
• Pesquisa de políticas e documentação
• Suporte de integração

• Recomendações de produtos
• Acompanhamento de pedidos
• Assistência para devolução e reembolso
• Orientação de compras

​

2. Criando seu primeiro funcionário de IA

​

Início rápido

1. Navigate to AI Employees in the sidebar (or visit /agents)
2. Click “Create AI Employee” button
3. Fill in basic information:
   • Name: Descriptive name (e.g., “Customer Support Bot”, “Sales Assistant”)
   • Description: Purpose and responsibilities
   • Avatar: Optional profile image
4. Click “Create”

​

Configuração inicial

• Visão geral: informações básicas e estatísticas rápidas
• Configurações: opções de configuração principais
• Ferramentas: integrações e recursos conectados
• Analytics: métricas e insights de desempenho
• Depuração: registros de conversas e solução de problemas

​

Melhores práticas de nomenclatura

• “Agente de Suporte ao Cliente”
• “Qualificador de leads – Vendas”
• “Bot Assistente de RH”
• “Suporte Técnico IA”

• Nomes genéricos como “Bot 1” ou “Agente”
• Nomes sem contexto
• Nomes excessivamente longos

​

3. Definindo as configurações do funcionário de IA

​

Configurações Gerais

• Nome de exibição mostrado aos usuários
• Pode ser alterado a qualquer momento
• Mantenha-o profissional e claro

• Notas internas sobre o propósito do Funcionário da IA
• Ajuda os membros da equipe a entender seu papel
• Não visível para usuários finais

• Imagem do perfil representando o funcionário da IA
• Aparece em interfaces de chat
• Recomendado: 200x200px, JPG ou PNG

​

Instruções (prompt do sistema)

1. Role Definition:

   You are a friendly customer support agent for Acme Corp.
   Your goal is to help customers quickly resolve issues.

2. Tone and Personality:

   Use a professional yet warm tone.
   Be patient and empathetic.
   Keep responses concise and helpful.

3. Capabilities:

   You can:
   - Answer questions about our products
   - Check order status
   - Process returns
   - Escalate to human agents for complex issues

4. Limitations:

   You cannot:
   - Process payments directly
   - Access customer credit card information
   - Make promises about delivery dates

5. Guidelines:

   Always greet users warmly.
   Ask clarifying questions if needed.
   Provide step-by-step guidance for technical issues.
   Offer to connect to a human agent if you cannot help.

You are Alex, a customer support specialist for ZappWay. 
You help users with questions about our AI automation platform.

PERSONALITY:
- Friendly, professional, and patient
- Use clear, simple language
- Show empathy for user frustrations

CAPABILITIES:
- Answer questions about features and pricing
- Guide users through setup processes
- Troubleshoot common issues
- Recommend relevant documentation
- Collect information for complex issues

PROCESS:
1. Greet the user warmly
2. Understand their question or issue
3. Search the knowledge base for accurate information
4. Provide clear, step-by-step solutions
5. Confirm the issue is resolved
6. Offer additional help if needed

WHEN TO ESCALATE:
- Technical bugs or errors
- Billing or payment issues
- Custom enterprise requests
- User explicitly requests human agent

Always end conversations by asking if there's anything else you can help with.

​

Seleção de modelo

​

🧠 OpenAI — Modelos GPT

• GPT-5.4 Mini
• GPT 5.4 Nano
• Bate-papo GPT-5.3 mais recente
• Códice GPT-5.3 -GPT-5.5
• Bate-papo GPT-5.2 mais recente
• Bate-papo GPT-5.2 -GPT-5.2
• Bate-papo GPT-5.1 -GPT-5.1
• GPT-5 Mini -GPT-5Nano -GPT-5 -GPT-4o -GPT-4o Mini

​

🔶 Antrópico — Claude

• Claude Soneto 4.6 -Claude Opus 4.5
• Soneto de Claude 4.5
• Claude 4.5 Haiku
• Soneto de Claude 4
• Soneto de Claude 3.5
• Claude 3.5 Haiku

​

🔵DeepSeek

​

🟡 Google — Gêmeos

• Google Gemini 3.5 Flash -Google Gêmeos 3.1 Pro
• Imagem Flash do Google Gemini 3.1
• Google Gemini 3.1 Flash Lite -Google Gêmeos 3 Pro
• Imagem Pro do Google Gemini 3
• Google Gêmeos 3 Flash -Google Gemini-Pro 2.5 -Google Gemini-Flash 2.5 -Google Gemini-Flash 2.0

​

🔷 Meta — Lhama

• Meta: Lhama-4 Maverick
• Meta: Batedor Lhama-4

​

🟣 Perplexidade

• Perplexidade: Sonar-Pro

​

⚫ xAI — Grok

• xAI: Grok 4.3
• xAI: Grok Build 0.1
• xAI: Grok 4

​

🟤 Amazonas — Nova

• Amazon: Nova-Premier
• Amazon: Nova 2 Lite

​

🟠 OpenRouter

​

🟢Mistral

• Mistral Grande 2512
• Mixtral 8x22B
• Mixtral 8x7B
• Mistral pequeno criativo

​

🫧 Líquido

• Líquido: LFM 2 24B
• Líquido: LFM2 8B

Nota:

• GPT-5.4: modelo mais recente e mais capaz da família GPT-5
• GPT-5.4 Mini / Nano: Rápido e econômico para tarefas mais simples
• Os modelos GPT-5 não suportam ajuste manual de temperatura — eles vêm pré-configurados com reconhecimento automático de temperatura

• Comece com GPT-5.4 Mini para a maioria dos casos de uso
• Use GPT-5.4 para conversas altamente sutis ou complexas
• Use GPT-5.4 Nano para consultas diretas e de alto volume

​

Configuração de temperatura

• 0,0 - 0,3: Muito consistente, determinístico (bom para perguntas e respostas factuais)
• 0,4 - 0,7: Criatividade e consistência equilibradas (recomendado)
• 0,8 - 1,0: Mais criativo e variado (bom para IA conversacional)

• Suporte ao cliente: 0,3 (precisa de respostas consistentes e precisas)
• Assistente de Vendas: 0,6 (equilíbrio entre personalidade e precisão)
• Escritor criativo: 0,9 (respostas mais variadas e envolventes)

Importante:

• Os modelos GPT-5 não suportam ajuste manual de temperatura, pois vêm configurados com reconhecimento automático de temperatura.

​

Configurações de visibilidade

• Público: qualquer pessoa com o link pode conversar
• Privado: somente usuários autenticados na sua organização

​

4. Adicionando conhecimento com datastores

​

Por que adicionar conhecimento?

• A IA depende apenas de dados gerais de treinamento
• Pode fornecer informações desatualizadas ou incorretas
• Não é possível responder perguntas específicas da empresa

• Respostas baseadas na sua documentação real
• Sempre atualizado com seu conteúdo
• Fornece informações precisas e relevantes

​

Conectando um armazenamento de dados

• Pelo menos um armazenamento de dados criado com conteúdo
• Consulte a documentação do Datastore para configuração

1. Open AI Employee settings
2. Navigate to Tools tab
3. Click “Add Tool”
4. Select “Datastore Tool”
5. Choose datastores to connect:
   • Click “Select Datastores”
   • Choose one or multiple datastores
   • Click “Save”
6. Tool is now active

• Armazenamento de dados de documentação do produto
• Armazenamento de dados de perguntas frequentes
• Armazenamento de dados de documentos de política

​

Configuração da ferramenta Datastore

• Resultados máximos: quantos pedaços recuperar (padrão: 5)
• Limite de similaridade: pontuação mínima de relevância (0-1)
• Prioridade: qual armazenamento de dados pesquisar primeiro (se houver vários)

• Conecte datastores relevantes e focados
• Mantenha os datastores atualizados regularmente
• Use no máximo 3 a 5 armazenamentos de dados por funcionário de IA

• Conectando mais de 10 datastores (retarda as respostas)
• Incluindo conteúdo irrelevante
• Informações duplicadas em datastores

​

5. Ferramentas de conexão

​

Ferramentas Disponíveis

​

Ferramenta de armazenamento de dados

• Pesquise bases de conhecimento para obter informações
• Necessário para: Responder a perguntas específicas da empresa
• Consulte: Guia de ferramentas do Datastore

​

Ferramenta HTTP

• Faça solicitações de API para sistemas externos
• Necessário para: Integração com serviços personalizados
• Consulte: Guia de ferramentas HTTP

​

Ferramenta Formulário

• Apresentar e coletar dados estruturados por meio de formulários
• Necessário para: captura de leads, envio de tickets
• Consulte: Guia de ferramentas de formulário

​

Solicitar ferramenta humana

• Escalar a conversa para o agente humano
• Necessário para: questões complexas que necessitam de toque humano
• Consulte: Guia de transferência humana

​

Marcar como ferramenta resolvida

• Marcar conversa como concluída
• Necessário para: gerenciamento limpo de conversas
• Consulte: Guia Marcar como Resolvido

​

Ferramenta de geração de leads

• Criar e qualificar leads automaticamente
• Necessário para: Automação de vendas
• Consulte: Guia de geração de leads

​

Adicionando ferramentas

1. Go to AI Employee → Tools tab
2. Click “Add Tool”
3. Select tool type from list
4. Configure tool settings
5. Click “Save”

• URL do terminal: terminal da API a ser chamado
• Método: GET, POST, PUT, DELETE
• Cabeçalhos: Autenticação e tipo de conteúdo
• Modelo de Corpo: Dados a serem enviados

​

Exemplos de uso de ferramentas

Tools: 
- Datastore Tool (Help docs)
- Request Human Tool (Escalation)
- Mark as Resolved Tool

Tools:
- Datastore Tool (Product info)
- Form Tool (Lead capture)
- Lead Generation Tool
- HTTP Tool (CRM integration)

Tools:
- Datastore Tool (Product catalog)
- HTTP Tool (Order lookup API)
- Form Tool (Return requests)

​

6. Implantando seu funcionário de IA

​

Opções de implantação

​

Widget de bate-papo na web

• Suporte ao site
• Páginas de produtos
• Páginas de destino
• Sites de documentação

​

Plataformas de mensagens

​

Plataformas de comércio eletrônico

​

Integração de API

​

Teste antes da implantação

• [] Teste conversas com AI Employee
• [] Verifique se a recuperação do armazenamento de dados funciona
• Verificar execuções de ferramentas (formulários, APIs)
• [] Testar o fluxo de transferência humana
• [] Experimente casos extremos e cenários de erro
• [] Confirmar respostas correspondentes às instruções
• [] Teste em dispositivos móveis (para chat na web)

1. Go to AI Employee detail page
2. Use Test Chat interface (right panel)
3. Try various user questions and scenarios
4. Check debug logs for tool usage
5. Refine instructions based on results

​

7. Monitoramento e Otimização

​

Painel analítico

• Total de conversas: número de chats atendidos
• Mensagens enviadas/recebidas: volume de atividades
• Taxa de resolução: % de conversas resolvidas sem intervenção humana
• Tempo médio de resposta: a rapidez com que a IA responde
• Uso de ferramentas: quais ferramentas são chamadas com mais frequência
• Ocorrências da base de conhecimento: frequência de pesquisa no armazenamento de dados

​

Depuração e registros

• Transcrições completas de conversas
• Chamadas e respostas de ferramentas
• Pesquisas e resultados do armazenamento de dados
• Mensagens de erro
• Tempo de processamento para cada etapa

1. Go to AI Employee → Debug tab
2. Select a conversation from list
3. Review step-by-step execution
4. Identify issues (wrong tool, bad retrieval, etc.)
5. Adjust configuration accordingly

​

Upload de arquivo de conversa

• Documentos PDF
• Imagens (JPG, PNG)
• Arquivos de texto
• Documentos do Word

​

Fontes de resposta

• Constrói confiança (citações visíveis)
• Ajuda os usuários a encontrar documentos originais
• Melhora a transparência

​

Sugestões de mensagens

• “Verificar status do pedido”
• “Devolver um item”
• “Fale com um humano”
• “Recomendações de produtos”

1. AI Employee settings
2. Message Suggestions section
3. Add suggested messages
4. Save

​

Melhoria Contínua

• Revise os registros de conversas
• Verifique as taxas de resolução
• Identificar pontos de falha comuns
• Atualizar datastores com novo conteúdo

• Analisar tendências analíticas
• Refine system instructions
• Adicione novas ferramentas, se necessário
• Atualizar a base de conhecimento de forma abrangente

• Revisão geral das instruções
• Avaliar o desempenho do modelo
• Considere o ajuste fino
• Revise o ROI e o impacto

​

8. Melhores práticas

​

Redação de instruções

When a user asks about pricing, always mention our 7-day free trial first,
then provide pricing tiers with feature breakdowns.

Help users with pricing questions.

Example conversation:
User: "How much does it cost?"
You: "Great question! We offer a 7-day free trial to get started. After that, we have three plans:
- Growth: $29/month for up to 1,000 conversations
- Pro: $99/month for up to 15,000 conversations
- Enterprise: Custom pricing for unlimited conversations
Which plan sounds right for you?"

DO NOT:
- Make promises about delivery dates
- Offer discounts without approval
- Share confidential information
- Provide medical advice

​

Organização da Base de Conhecimento

• Crie datastores focados por tópico
• Exemplo: “Perguntas frequentes sobre faturamento”, “Documentação do produto”, “Políticas”

• Remova informações desatualizadas imediatamente
• Adicione novo conteúdo regularmente
• Documentação da versão claramente

• Use títulos claros
• Divida as informações em seções digeríveis
• Incluir palavras-chave que os usuários podem pesquisar
• Evite jargões sem explicações

​

Configuração da ferramenta

• Mais ferramentas = mais complexidade
• A IA deve decidir qual ferramenta usar
• Comece mínimo, adicione ferramentas conforme necessário

• Verifique se os endpoints da API funcionam
• Verifique a autenticação
• Teste o tratamento de erros
• Monitore os limites de taxa de API

​

Experiência do usuário

"Hi! I'm Alex, your AI assistant. I can help you with:
✓ Product questions
✓ Order tracking
✓ Account issues

For billing or technical bugs, I'll connect you to our team."

"I'm not sure I can help with that. Would you like me to:
1. Connect you to a human agent
2. Search our help center
3. Try rephrasing your question"

"I found your order #12345. Would you like me to:
- Check its status
- Process a return
- Contact support about it"

​

Segurança e privacidade

• Não inclua senhas ou chaves de API nas instruções
• Use variáveis de ambiente para credenciais
• Limitar o acesso ao armazenamento de dados às informações necessárias
• Cumpra os regulamentos GDPR/privacidade

1. AI Employee settings
2. Rate Limiting section
3. Set limits per user/IP

​

📞 Suporte e Recursos

​

Obtendo ajuda

• Botão de ajuda no painel
• Chat ao vivo (disponível nos planos Pro+)

• Visão geral das ferramentas
• [Transferência Humana](/agente/transferência humana)
• [Ajuste fino](/agent/ajuste fino)
• Guia de depuração

• Documentação de widgets
• Guias de integração
• Referência de API

​

Opinião

• Use o botão de feedback no painel
• E-mail: support@zappway.ai
• Incluir:
  • ID do funcionário AI
  • ID da conversa (se aplicável)
  • Comportamento esperado vs real

​

✅ Referência rápida

​

Ações Essenciais

​

Lista de verificação de configuração

✓ Name and description set
✓ Avatar uploaded
✓ Instructions written clearly
✓ Model selected (GPT-5 recommended)
✓ Temperature configured (0.6 recommended)
✓ Datastore tool connected
✓ Knowledge bases populated
✓ Additional tools added as needed
✓ Tested with sample conversations
✓ Rate limits configured
✓ Deployed to target channels

> **Important:**
> - **GPT-5** models do not support manual temperature adjustment, as they come configured with automatic temperature recognition..

---