O Seu Primeiro Agente
Este tutorial orienta-o na criação, configuração e teste do seu primeiro agente de voz de IA. No final, terá um agente funcional que consegue responder a perguntas sobre o seu negócio.
O Que Vamos Construir
Um agente de voz que:
- Saúda os autores das chamadas profissionalmente
- Responde a perguntas usando a informação do seu negócio
- Fornece horário de funcionamento e contactos
- Sabe quando transferir para um humano
Tempo estimado: 15-20 minutos
Pré-requisitos
Antes de começar, certifique-se de que tem:
- Criada a sua conta Hanc.AI (Configuração da Conta)
- Iniciada sessão na plataforma
- Informação básica sobre o seu negócio pronta
Passo 1: Criar um Novo Agente
Há dois caminhos para criar um agente: Baseado em Modelo (recomendado para iniciantes) ou De Raiz.
Caminho A: Baseado em Modelo (Recomendado)
As Funções de Modelo fornecem configurações pré-construídas que o fazem começar rapidamente. A Hanc.AI oferece 24 modelos de função prontos a usar em duas categorias.
1.1 Navegar para Agentes de Voz
- Clique em "Agentes de Voz" na barra lateral esquerda
- Se for a sua primeira vez, um tour de integração guiá-lo-á pela interface passo a passo
1.2 Iniciar a Criação do Agente
Clique no botão "Criar Agente de Voz". Aparece uma janela com duas opções:
- Começar de Raiz — cria um agente em branco que configura manualmente (ver Caminho B abaixo)
- Funções de Modelo — 24 modelos de função organizados em duas categorias
Também pode construir um agente com o Hanc Studio — descreva o que precisa e ele monta-lhe um agente pronto (função, fluxo de trabalho, base de conhecimento e integrações).
1.3 Explorar as Funções de Modelo
As Funções de Modelo estão organizadas em duas categorias:
Orientadas para o Cliente (14 funções):
| Modelo | Melhor Para |
|---|---|
| Agente de Vendas | Chamadas de vendas, apresentação, fecho de negócios |
| Rececionista | Saudar autores de chamadas, encaminhamento, consultas gerais |
| Consultor | Chamadas de descoberta, avaliação de necessidades, aconselhamento |
| Agente de Suporte | Suporte ao cliente, resolução de problemas |
| Agente de Encomendas | Colocação de encomendas, acompanhamento, modificações |
| Encaminhador de Chamadas | Dirigir os autores das chamadas ao departamento ou pessoa certos |
| Agente de Lembretes | Lembretes de consultas, seguimentos, notificações |
| Agente de Feedback | Recolher feedback e inquéritos de clientes |
| Agente de Cobranças | Lembretes de pagamento, seguimento de faturas |
| Qualificador de Leads | Qualificar leads de entrada, recolher informação de potenciais clientes |
| Guia | Instruções passo a passo, integração, tutoriais |
| Promotor | Consciencialização de produto, campanhas, envolvimento de topo de funil |
| Atendedor Automático | Atendimento automático de chamadas, entrega de informação básica |
| Apresentador | Apresentações de produto ou serviço, demonstrações |
Orientadas para o Colaborador (10 funções):
| Modelo | Melhor Para |
|---|---|
| Secretário | Gestão interna de chamadas, agendamento, recolha de mensagens |
| Recrutador | Triagem de candidatos, agendamento de entrevistas |
| Integrador | Integração de novos colaboradores, orientação |
| Coordenador | Coordenação de equipa, agendamento de reuniões |
| Controlador | Monitorização de processos, atualizações de estado, verificações de conformidade |
| Helpdesk Interno | Suporte de TI, FAQ interno, assistência a colaboradores |
| Recolha de Dados | Recolher dados estruturados dos membros da equipa |
| Agente de Aprovação | Encaminhar aprovações, recolher validações |
| Agente de Compras | Pedidos de compra, consultas a fornecedores |
| Despachante | Atribuição de tarefas, alocação de recursos, despacho |
Para este tutorial: Selecione qualquer modelo que corresponda ao seu caso de uso.
As Funções de Modelo incluem prompts pré-escritos, mensagens de saudação e protocolos de conversa otimizados para funções específicas. Pode personalizar tudo após a criação.
1.4 Ver os Detalhes do Modelo
Clique em qualquer cartão de modelo para abrir uma vista de detalhe que mostra:
- Descrição da função e do que o agente faz
- Benefícios de usar este modelo
- Capacidades que o agente terá
- Seletor de idioma — primeiro escolhe um idioma (ex.: English, Deutsch), depois uma variante regional (ex.: United States, Áustria, Suíça) e a voz correspondente
- Descarregar como documento Word — exporta as perguntas do Assistente de Configuração como um ficheiro
.docxno idioma que escolheu, para que a sua equipa possa preenchê-lo offline. Uma vez preenchido, o mesmo assistente de Configuração Guiada pode reler o documento e preencher automaticamente cada campo correspondente — consulte Preencher via documento Word abaixo
Cada modelo é fornecido em 25 idiomas suportados com prompts de qualidade nativa e opções de voz para cada um. A função de Rececionista em alemão usa uma base alemã real, não uma tradução de um modelo em inglês.
Preencher via documento Word
Se preferir recolher a informação de negócio offline (ou dividir o trabalho pelos colegas), use o caminho do documento Word:
- Clique em Descarregar como documento Word na janela de detalhe da função — obtém um
.docxcorrespondente à função e ao idioma que escolheu. - Preencha tantas secções quantas tiver respostas. Ignore o que não souber.
- Clique em Configuração Guiada para abrir o assistente para a mesma função.
- Dentro do assistente, clique em Carregar documento preenchido e selecione o ficheiro. O assistente processa as suas respostas e mostra uma confirmação do tipo "12 de 18 campos preenchidos a partir do documento."
- Reveja e ajuste os campos pré-preenchidos, depois continue pelo assistente normalmente.
Pode voltar a carregar o documento a qualquer momento — cada carregamento atualiza os campos correspondentes com os valores mais recentes do seu ficheiro.
1.5 Escolher Como Criar
A partir da vista de detalhe do modelo, tem dois botões:
- Implementar Agente — Cria o agente instantaneamente com as predefinições do modelo. Pode preencher os detalhes do seu negócio mais tarde usando o Assistente de Configuração. Esta é a forma mais rápida de começar.
- Configuração Guiada — Abre um assistente passo a passo onde preenche os detalhes do seu negócio (nome da empresa, serviços, contactos, etc.) antes de o agente ser criado.
Implementar Agente é ótimo se quiser explorar o agente primeiro e configurá-lo mais tarde. Configuração Guiada é melhor se tiver a informação do seu negócio pronta e quiser um agente mais completo desde o início.
1.6 Configuração Guiada (se escolhida)
Se clicou em Configuração Guiada, um assistente orienta-o no preenchimento de detalhes específicos do seu negócio:
- Nome da empresa, serviços, contactos
- Horário de funcionamento, localização, preços
- Instruções e políticas específicas
Importante: Pode ignorar campos ou secções inteiras que não se apliquem ao seu negócio. No entanto, pelo menos uma secção tem de estar totalmente concluída antes de poder avançar.
Depois de concluir o assistente, o seu agente é criado com todos os detalhes que forneceu.
Caminho B: De Raiz
Para controlo total desde o início:
- Clique em "Criar Agente de Voz"
- Selecione "Começar de Raiz"
- É criado um agente em branco com um prompt predefinido
- Configurará tudo manualmente no passo seguinte
Passo 2: Após a Criação
Assim que o seu agente for criado, verá um banner de sucesso com os próximos passos sugeridos. Um tour de integração guiá-lo-á pelos separadores de configuração do agente, destacando definições e funcionalidades-chave.
O seu agente vem com duas variáveis de recolha predefinidas — Email e Telefone — para que possa recolher informações de contacto dos autores das chamadas desde logo. Pode personalizá-las ou removê-las no separador Ações.
O Assistente de Configuração
Procure o ícone de varinha brilhante junto ao nome do seu agente — este é o Assistente de Configuração. Ajuda-o a preencher os restantes detalhes secção a secção.
Como funciona o Assistente de Configuração:
- O progresso é acompanhado como "X/Y secções concluídas" para que saiba sempre o que falta
- Cada secção cobre uma área diferente de configuração: Configuração do Agente, Perfil da Empresa, Serviços, Especialistas, Localizações e mais
- Pode ignorar campos ou secções inteiras de que não precisa (mínimo 1 campo por secção)
- Percorra as secções por qualquer ordem, ao seu ritmo
Se usou Implementar Agente, o Assistente de Configuração é a sua principal forma de adicionar detalhes de negócio após a criação. Se usou Configuração Guiada, algumas secções já estarão preenchidas.
Editar manualmente o prompt ou os ficheiros da Base de Conhecimento desativa o Assistente de Configuração. Se isto acontecer, aparece um botão "Repor para Modelo" que lhe permite restaurar a funcionalidade do assistente.
Separadores do Agente
A página de configuração do seu agente tem estes separadores:
| Separador | O Que Contém |
|---|---|
| Painel | Visão geral da atividade e estatísticas do agente |
| Modelo | Definições de prompt, voz, idioma e modelo de IA |
| Base de Conhecimento | Ficheiros e informação que o agente usa para responder a perguntas |
| Definições | Definições de chamada, primeira mensagem, limites de duração da chamada |
| Ações | Ações pós-chamada (email, SMS, webhooks) |
| Widgets | Configuração do widget web para incorporação no seu site |
Passo 3: Configurar as Definições do Agente
3.1 Prompt
O prompt define a personalidade, o comportamento e o fluxo de conversa do seu agente.
Se usou um modelo, o prompt está pré-preenchido. Reveja-o e personalize-o para o seu negócio.
Se começou de raiz, escreva o seu prompt:
## Função
És um assistente virtual amigável da [Nome do Seu Negócio].
Ajudas os clientes com perguntas sobre os nossos serviços, horário e marcação de consultas.
## Estilo de Comunicação
- Fala de forma clara e concisa
- Sê educado e profissional
- Mantém as respostas curtas (1-3 frases quando possível)
- Faz uma pergunta de cada vez
## Regras Importantes
1. Fornece apenas informação de que tens a certeza
2. Se não souberes algo, diz "Não tenho essa informação, mas posso ligá-lo à nossa equipa"
3. Nunca inventes preços, disponibilidade ou outros detalhes específicos
4. Transfere para um humano se o cliente estiver aborrecido ou tiver um problema complexo
Inclua sempre a instrução: "Nunca inventes informação." Isto evita que a IA invente detalhes falsos sobre o seu negócio.
3.2 Base de Conhecimento
A base de conhecimento dá ao seu agente os factos de que precisa para responder a perguntas.
- Vá ao separador Base de Conhecimento nas definições do agente
- Crie uma nova base de conhecimento ou selecione uma existente
- Carregue ficheiros com a informação do seu negócio
Formatos de ficheiro aceites: .txt, .md, .docx, .pdf, .html, .csv
O que incluir:
- Serviços e preços
- Horário de funcionamento e localização
- Perguntas frequentes
- Políticas (cancelamento, pagamento, etc.)
- Informação da equipa
O agente conhece APENAS o que está na base de conhecimento. Se faltar informação, o agente não consegue responder a essas perguntas. Acrescente todos os detalhes importantes.
3.3 Voz
Escolha uma voz que corresponda à sua marca:
- Selecione o idioma
- Explore as vozes disponíveis (masculina/feminina, estilos diferentes)
- Pré-visualize as vozes antes de selecionar
3.4 Definições de Chamada
Configure o comportamento da chamada:
- Primeira mensagem (saudação quando o agente atende)
- Definições de idioma
- Limites de duração da chamada
3.5 Ferramentas
Adicione ferramentas que o agente pode usar durante as chamadas:
- Google Calendar para agendamento de consultas
- Integrações de API personalizadas
3.6 Ações
Configure ações pós-chamada que disparam depois de uma conversa terminar:
- Enviar resumos por email
- Enviar notificações por SMS
- Acionar webhooks
- Fazer chamadas de API
3.7 Widget
Configure o widget web para incorporação no seu site:
- Aparência e cores
- Posição e comportamento
- Marca personalizada
3.8 Guardar as Definições
Clique em "Guardar" ou "Atualizar" para guardar a sua configuração.
Passo 4: Testar o Seu Agente
Agora vamos ver o seu agente em ação!
4.1 Testar via Widget Web
- Encontre o seu agente na lista de Agentes de Voz
- Clique em "Falar com o agente" ou no botão de teste/chamada
- Permita o acesso ao microfone no seu browser
- Comece a falar
4.2 Testar via Número de Telefone
Se tiver um número de telefone ligado:
- Atribua o seu agente ao número (nas definições de Números de Telefone)
- Ligue para o número a partir de qualquer telefone
4.3 Cenários de Teste
Teste 1: Saudação básica
- Aguarde a saudação do agente
- Diga: "Olá"
- O agente deve responder naturalmente
Teste 2: Horário de funcionamento
- Diga: "Qual é o vosso horário de funcionamento?"
- O agente deve fornecer o seu horário a partir da base de conhecimento
Teste 3: Pergunta sobre serviço
- Diga: "Que serviços oferecem?"
- O agente deve listar os seus serviços
Teste 4: Pergunta sobre preço
- Diga: "Quanto custa [o seu serviço]?"
- O agente deve dar o preço se estiver na base de conhecimento
Teste 5: Pergunta desconhecida
- Diga: "Qual é o sentido da vida?"
- O agente deve dizer educadamente que não tem essa informação
4.4 Terminar o Teste
Clique em "Terminar chamada" ou feche a janela de teste quando terminar.
Passo 5: Refinar o Seu Agente
Com base nos testes, pode querer melhorar:
Problemas e Correções Comuns
| Problema | Solução |
|---|---|
| O agente fala demasiado | Acrescente ao prompt: "Mantém as respostas em 1-2 frases" |
| O agente é demasiado formal | Ajuste o tom do prompt: "Sê amigável e conversacional" |
| O agente não conhece a informação | Verifique se a base de conhecimento tem a informação |
| O agente inventa coisas | Enfatize no prompt: "NUNCA inventes informação" |
| Idioma errado | Verifique se a definição de Idioma corresponde às suas necessidades |
| Voz demasiado rápida/lenta | Ajuste as definições de velocidade da voz |
Iterar e Melhorar
- Testar → Identificar problemas → Ajustar prompt/definições → Testar novamente
- Acrescente mais FAQ à base de conhecimento com base nas chamadas de teste
- Refine o prompt com base em conversas reais
Passo 6: Implementar o Seu Agente (Opcional)
Depois de satisfeito com os testes, pode implementar o seu agente:
Opção A: Ligar um Número de Telefone
- Vá a Números de Telefone
- Compre um número ou importe um existente
- Atribua o seu agente ao número
- As chamadas para esse número são agora tratadas pelo seu agente
Opção B: Adicionar o Widget de Site
- Vá às definições do seu agente
- Encontre o separador Widgets
- Copie o código de incorporação
- Adicione-o ao seu site
Lista de Verificação: O Seu Agente Está Pronto?
Antes de ir para produção, verifique:
- A primeira mensagem é clara e acolhedora
- O prompt define o comportamento corretamente
- A base de conhecimento tem informação precisa
- O agente lida bem com perguntas comuns
- O agente admite quando não sabe algo
- A voz soa adequada para a sua marca
- O idioma está definido corretamente
- As chamadas de teste produzem bons resultados
O Que Vem a Seguir?
Parabéns! Criou o seu primeiro agente de voz.
Continue a aprender:
- Aprofundamento em Agentes de Voz — Configuração avançada de agentes
- Boas Práticas da Base de Conhecimento — Criar melhores bases de conhecimento
- Números de Telefone — Ligar números de telefone reais
- Funções de Modelo — Prompts e configurações prontos a usar
- Campanhas — Configurar campanhas de chamadas de saída
Resolução de Problemas
O agente não inicia a chamada de teste
- Verifique as permissões de microfone do browser
- Experimente um browser diferente
- Assegure uma ligação estável à internet
O agente não responde
- Aguarde alguns segundos — pode haver um atraso de processamento
- Fale com clareza e não demasiado depressa
- Verifique se o agente não está em pausa/inativo
O agente dá informação errada
- Verifique se o conteúdo da base de conhecimento está correto
- Confirme se a base de conhecimento está ligada ao agente
- Reveja o prompt à procura de instruções conflituantes
A qualidade da voz é fraca
- Verifique a sua ligação à internet
- Experimente uma voz diferente
- Reduza o ruído de fundo
Precisa de Ajuda?
- Consulte o Guia de Resolução de Problemas
- Contacte support@hanc.ai