Como criar seu primeiro agente de voz com IA no Tigy

1. Escolha um objetivo verificável

Para criar o primeiro agente no Tigy AI, escolha uma tarefa cujo resultado possa ser conferido: responder dúvidas sobre serviços ou encaminhar um pedido à equipe, por exemplo. Escreva o pedido inicial, a fonte da resposta, o resultado esperado e os assuntos excluídos. Esse escopo será a referência para as instruções e os testes.

Prepare alguns exemplos de pedidos e respostas antes de configurar o fluxo. Inclua a pergunta que o agente deve fazer quando faltar informação e o caminho para assuntos que ele não pode resolver.

2. Configure a conversa e suas fontes

Crie um agente de prompt: um agente orientado por instruções escritas. Explique seu papel, o tom, as informações permitidas e quando deve encaminhar para uma pessoa. Escreva o que ele deve fazer em situações concretas, em vez de apenas pedir que seja útil.

Adicione documentos revisados e apenas as ferramentas necessárias. Se o agente precisar consultar outro sistema por uma API, peça ao responsável pela integração que confirme os dados necessários, a permissão de acesso e o comportamento em caso de erro. Chaves de acesso ficam na configuração da integração, nunca no texto que o agente pode falar.

3. Teste pelo navegador

Use o teste do agente para conversar como um cliente. Varie as frases e confirme que o fluxo entende a intenção, consulta as fontes e responde de forma adequada. Quando houver uma ação, verifique seu resultado no sistema conectado.

• Pedido esperado com todas as informações.
• Informação incompleta e necessidade de confirmação.
• Interrupção, silêncio e mudança de assunto.
• Falha de integração e encaminhamento para uma pessoa.

4. Conecte o canal e acompanhe

Após validar o agente de prompt no editor do navegador, configure a telefonia para o piloto. Os passos dependem do canal e do provedor; consulte a documentação para os requisitos e faça uma chamada de ponta a ponta antes de liberar o piloto.

Revise chamadas e resultados para ajustar as instruções. Faça uma alteração por vez quando possível e repita os cenários importantes. Assim você consegue relacionar a mudança ao comportamento observado e manter um atendimento consistente.

Um prompt para começar e corrigir

Crie um agente no workspace, abra suas instruções e escreva o objetivo e os limites. O exemplo abaixo atende uma loja fictícia: a primeira versão responde apenas informações aprovadas, sem consultar pedidos individuais. Não associe uma ferramenta que o exemplo ainda não usa.

Salve e abra Test agent no editor. Comece em texto: pergunte o horário, peça uma data de entrega individual e faça uma pergunta fora do escopo. Depois use voz, permita o microfone e confira reconhecimento e turnos. Anote o esperado e o observado. Use esses resultados para decidir a próxima correção.

Se o agente inventar uma entrega, acrescente a regra de que não possui acesso a pedidos individuais e repita a mesma pergunta. Confira também se ainda responde corretamente o horário. Ao adicionar uma ferramenta real depois, atualize as instruções e teste sucesso, retorno vazio e erro antes de um piloto telefônico.

# Papel
Você atende a Loja Exemplo em português.
# Objetivo
Informar o horário aprovado: segunda a sexta, 9h às 18h.
# Conversa
Apresente-se como assistente virtual. Faça uma pergunta por vez.
# Limites
Você não tem acesso a pedidos individuais. Não invente prazos.
Para pedidos ou temas fora do escopo, oriente a pessoa à equipe da loja.
Confirme o próximo passo antes de encerrar.

Revise as instruções como um contrato de atendimento

Separe papel, objetivo, maneira de conversar, ferramentas e limites. Uma regra como “seja prestativo” não explica o que fazer quando a informação falta. Prefira “se não encontrar a resposta nas fontes aprovadas, diga que não conseguiu confirmar e indique o contato da equipe”. A regra deve produzir uma resposta que outra pessoa consiga avaliar.

Confira se os nomes de ferramentas usados nas instruções correspondem aos configurados e selecionados no agente. Escrever “consulte o pedido” não cria uma integração. Quando a consulta ainda não existir, o agente deve orientar o próximo passo sem simular acesso ao sistema.

Procure conflitos internos. “Responda sempre imediatamente” pode contradizer “confirme o código antes de consultar”. “Nunca encaminhe” pode impedir a saída necessária para um pedido fora do escopo. Remova regras absolutas que não combinam com a tarefa. Acrescente exemplos de comportamento esperado apenas onde eles esclarecem uma decisão difícil; muitos exemplos redundantes tornam a manutenção mais trabalhosa.

Salvar, testar e publicar comprovam coisas diferentes

Salvar preserva o trabalho no rascunho. Testar permite observar como o agente responde nas condições da sessão. Publicar disponibiliza uma versão validada para execução. Essas etapas não são intercambiáveis: um rascunho salvo pode estar incompleto, e um teste bem-sucedido não confirma que o número telefônico está associado ao agente certo.

Antes de publicar, confira workspace, fontes selecionadas, ferramentas habilitadas e resultado dos cenários. Corrija erros apresentados pelo editor e revise o histórico depois da publicação. Inicie uma nova conversa pelo canal pretendido para verificar qual configuração chegou ao atendimento.

Guarde a lista de testes e uma nota sobre a alteração. Isso permite distinguir regressão de problema anterior. Se a nova versão falhar, consulte o histórico como referência, corrija o rascunho atual, salve, teste e publique novamente. Uma versão do agente não restaura por si só uma API externa, um documento substituído ou uma rota telefônica alterada.

Dúvidas na primeira configuração

Preciso conectar telefonia antes de escrever o agente? Você pode investigar instruções por texto e voz no editor antes dessa conexão. A validação telefônica vem depois e continua necessária: microfone do navegador, áudio telefônico e transferência têm condições diferentes.

Por que o teste não começa? Confira permissão, alterações salvas, validação e uso disponível no workspace. Uma sessão autenticada não garante créditos ou autorização para executar aquele agente. Use a mensagem apresentada para investigar a causa antes de mudar as instruções.

Quando acrescentar ferramentas? Depois de ter um objetivo que dependa delas e um contrato que você possa testar. Comece com ambiente de teste e dados fictícios para operações de escrita. Uma ferramenta disponível na lista precisa ser selecionada no agente; a resposta falada deve refletir o resultado efetivo da chamada.

Escreva uma ficha de atendimento antes de abrir o editor

Uma ficha curta ajuda a transformar a intenção de automatizar em uma configuração verificável. Registre o público, o motivo do contato, a informação que a empresa aprova e a ação que encerra a tarefa. Para uma loja fictícia, o primeiro objetivo pode ser informar horários e orientar consultas de pedidos. O resultado esperado é uma resposta correta ou um encaminhamento claro, sem acesso imaginário ao sistema de compras.

Escreva também o que fica de fora: negociar preço, confirmar entrega individual e alterar cadastro, por exemplo. Não é necessário começar oferecendo tudo que a equipe humana faz. Um recorte pequeno permite descobrir como o agente lida com perguntas diferentes sem misturar decisões comerciais, dados pessoais e operações de escrita.

Prepare três perguntas frequentes com respostas aprovadas e três exceções com saída definida. Inclua uma frase informal, uma pergunta incompleta e uma premissa errada. A pessoa pode perguntar “vocês ainda fecham às sete?”, mesmo que o horário atual seja outro. O agente precisa corrigir a premissa pela fonte disponível, não concordar por educação.

Ao revisar a ficha com alguém que atende clientes, pergunte se o próximo passo é executável. “Encaminhar para a equipe” precisa de um canal, destino ou processo real. Essa conversa evita configurar uma saída que parece útil no texto, mas não existe na operação.

Escolha entre instruções fixas e documentos consultáveis

Informações pequenas e estáveis podem aparecer nas instruções quando isso facilita a manutenção. Um conjunto maior de serviços e políticas pode ficar em documentos aprovados. Evite manter duas cópias da mesma regra sem um processo de atualização: uma no prompt e outra na base podem divergir depois de uma mudança.

Para documentos, confira duas etapas independentes. O arquivo precisa terminar o processamento no workspace e depois ser selecionado nas fontes do agente. Uma pessoa pode ter enviado o manual corretamente, mas testar um agente que não o consulta. Antes de revisar as instruções, confirme essa associação.

Use um documento pequeno para a primeira verificação. Pergunte algo que está no início, algo de outra seção e algo ausente. Confira se a resposta corresponde ao texto aprovado e se a ausência leva ao caminho definido. A terceira pergunta é importante porque mede o comportamento quando a fonte não basta.

Não coloque uma lista de pedidos de clientes no material compartilhado para simular consulta. Dados individuais precisam de um acesso autorizado e atualizado. A base deve explicar a política da loja; o sistema de pedidos deve fornecer o estado da compra quando essa capacidade for acrescentada.

Faça o primeiro teste sem operações de escrita

Antes de conectar sistemas, confira apresentação, entendimento e limites. Em um exercício fictício, pergunte o horário aprovado, solicite o estado de uma compra e peça um desconto. O primeiro pedido deve receber informação; os outros precisam respeitar as capacidades disponíveis. Isso estabelece uma referência simples para a conversa.

No teste por texto, registre a pergunta, o comportamento esperado e a resposta observada. Não avalie apenas se a mensagem parece boa. Procure promessas de acesso, consulta ou confirmação que a configuração ainda não permite. Se o agente diz que verificou um pedido sem ferramenta, corrija esse comportamento antes de acrescentar integrações.

Depois passe para voz com as mesmas intenções. Fale de forma natural, faça uma pausa e corrija uma informação. Confira se o agente permite terminar a pergunta e se a explicação continua compreensível quando ouvida. O texto pode estar correto e ainda ser longo ou difícil de acompanhar no áudio.

Escolha uma falha e faça uma alteração relacionada à causa. Repita o caso e uma pergunta que já funcionava. Essa comparação ajuda a evitar que uma correção muito ampla faça o agente recusar todos os pedidos. Preserve os exemplos para os próximos testes, com dados fictícios.

Acrescente uma ferramenta quando souber como conferir seu efeito

Antes de acrescentar uma consulta, combine com a equipe de integração quais informações o agente precisa pedir e quais resultados poderá receber. Para consultar um pedido, confirme seu número e as regras de acesso. Conhecer um número não dá direito de consultar qualquer compra.

Use registros fictícios em um ambiente de teste. Prepare um pedido encontrado, um pedido ausente e um sistema indisponível. Confira se o agente explica cada resultado corretamente: uma conexão que respondeu sem dados não comprova que o pedido existe; um pedido em separação não comprova a data de entrega.

Se a ferramenta cria registros, teste uma situação em que a confirmação demora ou se perde. A equipe de integração precisa permitir verificar o que aconteceu antes de repetir a ação, pois o registro pode já ter sido criado.

Abra o sistema de destino e confira o resultado, além de ouvir a conversa. A frase “solicitação registrada” deve corresponder a um registro real, com uma referência que a equipe consiga localizar.

Organize a revisão do primeiro dia de operação

Separe conversas resolvidas, encaminhadas e pendentes. Revise ao menos uma amostra de cada grupo, conforme o volume e o risco. Chamadas encerradas não devem ser consideradas automaticamente concluídas. A pessoa pode ter desistido ou precisar de outro contato.

Classifique o problema pelo componente: conteúdo, instrução, reconhecimento, ferramenta, canal ou trabalho posterior. Cada causa pede um responsável e uma evidência. Atualizar o prompt não resolve um número associado ao agente errado, nem uma fila externa que ninguém acompanha.

Registre a correção planejada e o cenário que comprovará seu resultado. Ao publicar outra versão, inicie uma nova conversa no canal real. Preserve também os testes anteriores para detectar regressões. O conjunto cresce a partir de situações que a operação realmente encontrou.

Expanda uma capacidade por vez quando o processo atual estiver explicável. Você deve conseguir dizer o que foi resolvido, o que ficou pendente e como a equipe assumiu as exceções. Essa disciplina oferece uma base melhor para o segundo agente ou a próxima integração do que aumentar o escopo apenas porque a primeira demonstração foi agradável.