Agentes

O Agente é o coração do Tropicall. Ele é o assistente de voz com inteligência artificial que atende suas chamadas, conversa com seus clientes e executa tarefas. Pense no agente como o “cérebro” que conecta todos os outros recursos da plataforma.

O que é um Agente?

Um agente é um assistente virtual de voz que você configura para representar sua empresa em ligações telefônicas. Ele:

Atende chamadas automaticamente quando vinculado a um número de telefone
Conversa naturalmente usando inteligência artificial avançada
Segue suas instruções para manter a personalidade e comportamento desejados
Executa tarefas como consultar sistemas, transferir para humanos ou fazer cálculos
Responde perguntas usando documentos da sua base de conhecimento

Cada agente é uma combinação única de personalidade, conhecimento e capacidades que você define.

Como o Agente Conecta Tudo

O agente é o hub central que une todos os recursos do Tropicall:

Recurso	O que faz	Como o agente usa
Instruções	Define personalidade e comportamento	Segue como diretriz principal
Skills	Ensina tarefas específicas	Sabe executar procedimentos
Rules	Estabelece limites e restrições	Respeita o que não pode fazer
Tools	Integra com sistemas externos	Executa ações durante a conversa
Documentos	Fornece conhecimento via RAG	Busca informações para responder
Voz	Define como o agente fala	Responde com a voz configurada

Anatomia de um Agente

Ao criar ou editar um agente, você configura os seguintes campos:

Campos Básicos

name

string

required

Nome do AgenteIdentificador único para reconhecer o agente no dashboard. Use nomes descritivos como “Atendente SAC”, “Agente Vendas” ou “Suporte Técnico N1”.

Máximo: 100 caracteres
Exemplos: Atendente Principal, Vendedor Outbound, Cobrador Ativo

instructions

string

required

Instruções (Prompt do Sistema)O campo mais importante do agente. Define quem ele é, como deve se comportar e qual seu objetivo. É aqui que você “programa” a personalidade e o contexto do agente.

Mínimo: 10 caracteres
Máximo: 5.000 caracteres
Deve incluir: contexto, objetivo, tom de voz e regras gerais

first_message

string

Mensagem Inicial (opcional)A primeira frase que o agente fala ao atender uma chamada. Se não definida, o agente aguarda o cliente falar primeiro.

Exemplos:
- "Olá! Aqui é a Ana da Empresa X. Como posso ajudar?"
- "Bem-vindo à central de atendimento! Em que posso ser útil?"

Configurações de Voz

voice_id

string

required

VozSelecione a voz que o agente usará para falar. O Tropicall oferece vozes em português brasileiro, masculinas e femininas.

Categoria	Disponibilidade	Características
Standard	Todos os planos	Vozes de alta qualidade
Premium	Scale e Enterprise	Vozes mais naturais e expressivas
Clonada	Enterprise	Vozes personalizadas da sua empresa

Ouça o preview de cada voz antes de escolher. Clique no botão de play ao lado de cada opção.

tts_speed

number

default:"1.0"

Velocidade da FalaAjuste a velocidade com que o agente fala. Útil para adequar ao perfil do público.

Velocidade	Uso recomendado
0.5x - 0.8x	Público idoso, informações complexas
0.9x - 1.1x	Uso geral (padrão)
1.2x - 1.5x	Público jovem, informações simples

Templates Pré-configurados

Para facilitar a criação, o Tropicall oferece templates prontos com instruções, skills e rules otimizadas para diferentes casos de uso.

Vendas Ativa
SAC Receptivo
Cobrança Ativa
Cobrança Receptiva
Suporte Técnico

Template: Vendas Ativa (Outbound)

Categoria: ComercialIdeal para ligações de prospecção e telemarketing ativo. O agente é configurado para:

Fazer o primeiro contato com potenciais clientes
Qualificar leads através de perguntas
Agendar reuniões com o time comercial
Lidar com objeções iniciais

Inclui:

3 Skills: Abertura de Cold Call, Qualificação por Telefone, Agendamento de Reunião
3 Rules: Respeitar Pedido de Não Ligar, Identificar Momento Ruim, Limite de Tentativas

Mensagem inicial sugerida:

“Olá, boa tarde! Aqui é [nome] da [empresa]. Estou ligando porque trabalhamos com [segmento] e ajudamos empresas como a sua a [benefício principal]. Consegue falar agora?”

Ao usar um template, as Skills e Rules sugeridas são criadas automaticamente e vinculadas ao agente. Você pode editá-las depois.

Recursos Vinculáveis

Após criar o agente, você pode enriquecer suas capacidades vinculando recursos:

Skills

Ensine tarefas específicas com blocos de conhecimento reutilizáveis. O agente aprende a executar procedimentos passo a passo.

Rules

Defina limites e restrições de comportamento. Garanta conformidade, ética e segurança nas conversas.

Tools

Conecte a APIs e sistemas externos. O agente pode consultar dados, fazer cálculos ou transferir para humanos.

Documentos

Adicione sua base de conhecimento. O agente busca informações relevantes via RAG para responder perguntas.

Diferença entre Instruções, Skills e Rules

Recurso	Propósito	Escopo	Exemplo
Instruções	Define “quem” o agente é	Único do agente	”Você é um atendente amigável da Empresa X”
Skills	Ensina “o que” o agente sabe fazer	Reutilizável entre agentes	”Como agendar uma reunião”
Rules	Define “o que” o agente NÃO pode fazer	Reutilizável entre agentes	”Nunca revelar dados para terceiros”

Use as Instruções para personalidade e contexto geral. Use Skills para procedimentos específicos. Use Rules para restrições e compliance.

Ciclo de Vida do Agente

Estados do Agente

Um agente pode estar em dois estados:

Estado	Badge	Descrição	Ações disponíveis
Inativo	Cinza	Agente criado mas não está em execução	Editar, Deploy, Excluir
Ativo	Verde	Agente em execução, pronto para atender	Editar*, Parar, Playground, Excluir

*Editar um agente ativo requer um novo deploy para aplicar as alterações.

Fluxo de Trabalho

Criar o Agente

Configure nome, instruções, voz e mensagem inicial. Use um template para acelerar.

Vincular Recursos

Adicione Skills, Rules, Tools e Documentos conforme necessário.

Fazer Deploy

Clique em Deploy para ativar o agente. Ele será iniciado na infraestrutura do Tropicall.

Testar no Playground

Acesse o Playground e selecione o agente para conversar com ele em tempo real.

Vincular a Número

Na página de Números de Telefone, vincule o agente ativo a um número para receber chamadas reais.

Criando seu Primeiro Agente

Opção 1: Criar do Zero

Acesse a página de Agentes

No menu lateral do dashboard, clique em Agentes

Clique em Novo Agente

No canto superior direito, clique no botão Novo Agente

Escolha 'Do Zero'

Na galeria de templates, selecione o card Do Zero e clique em Continuar

Preencha o Nome

Digite um nome descritivo para identificar o agente (ex: “Atendente SAC”)

Escreva as Instruções

Descreva detalhadamente quem é o agente, qual seu objetivo e como deve se comportar

Configure a Mensagem Inicial

Defina a primeira frase que o agente dirá ao atender (opcional)

Selecione a Voz

Ouça os previews e escolha a voz mais adequada para seu caso de uso

Ajuste a Velocidade

Use o slider para definir a velocidade da fala (padrão: 1.0x)

Crie o Agente

Clique em Criar Agente para salvar

Opção 2: Criar a partir de Template

Acesse a página de Agentes

No menu lateral do dashboard, clique em Agentes

Clique em Novo Agente

No canto superior direito, clique no botão Novo Agente

Escolha um Template

Na galeria, passe o mouse sobre os templates para ver detalhes. Selecione o mais adequado e clique em Continuar

Personalize o Nome

O template preenche as instruções e mensagem inicial. Defina um nome único para o agente.

Revise as Instruções

As instruções vêm pré-preenchidas. Personalize conforme seu negócio (troque [empresa], [produto], etc.)

Configure Voz e Velocidade

Selecione a voz e ajuste a velocidade

Crie o Agente

Clique em Criar Agente. As Skills e Rules do template serão criadas e vinculadas automaticamente.

Página de Detalhes do Agente

Ao clicar em um agente na listagem, você acessa a página de detalhes:

Cabeçalho

Exibe informações principais:

Nome e status (Ativo/Inativo)
Data de criação
Voz selecionada
Velocidade da fala
Quantidade de Tools vinculadas

Ações Disponíveis

Botão	Quando aparece	O que faz
Deploy	Agente inativo	Ativa o agente para receber chamadas
Parar	Agente ativo	Desativa o agente
Playground	Agente ativo	Abre o Playground com o agente selecionado
Editar	Sempre	Abre o diálogo de edição
Excluir	Sempre	Remove o agente permanentemente

Seções de Recursos

A página de detalhes mostra todas as vinculações organizadas por seção:

Tools: Lista de ferramentas vinculadas com botão para vincular mais
Base de Conhecimento: Documentos vinculados para consulta via RAG
Skills: Habilidades que o agente sabe executar
Rules: Regras e restrições que o agente segue

Cada seção permite:

Vincular novos recursos (botão no canto)
Desvincular recursos existentes (ícone de lixeira)
Visualizar conteúdo de Skills e Rules

Boas Práticas para Instruções

As instruções são o campo mais importante do agente. Aqui está como escrevê-las bem:

Estrutura Recomendada

[IDENTIDADE]
Você é [nome/papel] da [empresa]. Seu objetivo é [objetivo principal].

[CONTEXTO]
[Descreva o cenário de uso, tipo de ligação, perfil do cliente]

[COMPORTAMENTO]
- Como deve se comunicar
- Tom de voz esperado
- Nível de formalidade

[FLUXO]
1. Primeiro passo da conversa
2. Segundo passo
3. ...

[REGRAS GERAIS]
- O que deve fazer
- O que não deve fazer

Exemplo Completo

Você é a Ana, assistente de atendimento da TechStore, uma loja de eletrônicos.
Seu objetivo é ajudar clientes com dúvidas sobre produtos e pedidos.

CONTEXTO:
Os clientes ligam com perguntas sobre especificações de produtos, 
status de pedidos, trocas e devoluções. Você tem acesso ao sistema
de pedidos e catálogo de produtos.

COMPORTAMENTO:
- Seja sempre educada e prestativa
- Use linguagem clara e acessível (evite jargões técnicos)
- Demonstre paciência, mesmo com perguntas repetidas
- Chame o cliente pelo nome quando souber

FLUXO PADRÃO:
1. Cumprimente e pergunte como pode ajudar
2. Identifique a necessidade do cliente
3. Busque a informação ou execute a ação
4. Confirme se resolveu a demanda
5. Ofereça ajuda adicional antes de encerrar

REGRAS:
- Sempre confirme dados sensíveis antes de informar
- Nunca prometa prazos que não pode garantir
- Se não souber algo, diga que vai verificar
- Transfira para humano se o cliente insistir

O que Evitar nas Instruções

Instruções vagas não funcionam bem. Evite:

“Seja um bom atendente” (muito genérico)
“Ajude o cliente” (não especifica como)
“Responda perguntas” (óbvio demais)

Evite

Instruções de uma linha
Falta de contexto
Objetivos vagos
Comportamento não especificado
Regras ausentes

Prefira

Instruções detalhadas (200-500 palavras)
Contexto claro do negócio
Objetivos específicos e mensuráveis
Comportamento explícito
Regras claras de conduta

Deploy e Ativação

Fazendo Deploy

Para que um agente atenda chamadas, ele precisa estar ativo:

Acesse o Agente

Na página de Agentes, clique no agente que deseja ativar

Clique em Deploy

No cabeçalho, clique no botão verde Deploy

Aguarde a Ativação

O sistema inicia o agente na infraestrutura. Isso leva alguns segundos.

Confirme o Status

Quando o badge mudar para Ativo (verde), o agente está pronto.

Parando o Agente

Para desativar um agente em execução:

Acesse o Agente

Na página de Agentes, clique no agente ativo

Clique em Parar

No cabeçalho, clique no botão Parar

Confirme

O agente será desativado e não atenderá mais chamadas

Ao parar um agente vinculado a um número de telefone, as chamadas para aquele número não serão mais atendidas até você reativar o agente ou vincular outro.

Editando um Agente Ativo

Se você editar um agente que já está ativo:

As alterações são salvas no banco de dados
O agente em execução não é atualizado automaticamente
Um aviso aparece informando que é necessário um novo deploy
Clique em Deploy novamente para aplicar as alterações

Esta abordagem evita interrupções acidentais. Você decide quando aplicar as mudanças.

Resolução de Problemas

Problemas Comuns

Problema	Causa Provável	Solução
Agente não atende chamadas	Não está ativo	Faça deploy do agente
Agente não aparece no Playground	Não está ativo	Faça deploy do agente
Alterações não aplicaram	Falta novo deploy	Clique em Deploy após editar
Agente não usa uma Tool	Tool não vinculada	Vincule a Tool na página do agente
Respostas fora do contexto	Instruções vagas	Melhore as instruções com mais detalhes
Agente não encontra informações	Documento não vinculado	Vincule o documento ao agente
Agente não segue uma regra	Rule não vinculada	Vincule a Rule ao agente
Erro ao fazer deploy	Problema temporário	Aguarde 1 minuto e tente novamente

Checklist de Verificação

Antes de colocar um agente em produção, verifique:

Excluindo um Agente

Excluir um agente é uma ação permanente e irreversível. Todos os vínculos com Tools, Documents, Skills e Rules serão removidos.

Acesse o Agente

Na página de detalhes do agente

Clique em Excluir

No cabeçalho, clique no ícone de lixeira vermelho

Confirme

Leia o aviso e confirme a exclusão

O que acontece ao excluir:

O agente é removido permanentemente
Vínculos com Tools, Documents, Skills e Rules são desfeitos
Se estava vinculado a um número, o número fica sem agente
Skills e Rules não são excluídas (continuam disponíveis para outros agentes)
Documentos não são excluídos (continuam na sua base de conhecimento)

Próximos Passos

Agora que você entende como funcionam os agentes, explore os recursos complementares:

Skills

Ensine tarefas específicas aos seus agentes

Rules

Defina limites e restrições de comportamento

Tools

Integre seus agentes com sistemas externos

Documentos

Adicione conhecimento via RAG

Números de Telefone

Vincule agentes a números para receber chamadas

Playground

Teste seus agentes em tempo real

Começando

Recursos

​Agentes

​O que é um Agente?

​Como o Agente Conecta Tudo

​Anatomia de um Agente

​Campos Básicos

​Configurações de Voz

​Templates Pré-configurados

​Template: Vendas Ativa (Outbound)

​Template: SAC Receptivo (Inbound)

​Template: Cobrança Ativa (Outbound)

​Template: Cobrança Receptiva (Inbound)

​Template: Suporte Técnico Receptivo (Inbound)

​Recursos Vinculáveis

Skills

Rules

Tools

Documentos

​Diferença entre Instruções, Skills e Rules

​Ciclo de Vida do Agente

​Estados do Agente

​Fluxo de Trabalho

​Criando seu Primeiro Agente

​Opção 1: Criar do Zero

​Opção 2: Criar a partir de Template

​Página de Detalhes do Agente

​Cabeçalho

​Ações Disponíveis

​Seções de Recursos

​Boas Práticas para Instruções

​Estrutura Recomendada

​Exemplo Completo

​O que Evitar nas Instruções

Evite

Prefira

​Deploy e Ativação

​Fazendo Deploy

​Parando o Agente

​Editando um Agente Ativo

​Resolução de Problemas

​Problemas Comuns

​Checklist de Verificação

​Excluindo um Agente

​Próximos Passos

Skills

Rules

Tools

Documentos

Números de Telefone

Playground

Agentes

O que é um Agente?

Como o Agente Conecta Tudo

Anatomia de um Agente

Campos Básicos

Configurações de Voz

Templates Pré-configurados

Template: Vendas Ativa (Outbound)

Template: SAC Receptivo (Inbound)

Template: Cobrança Ativa (Outbound)

Template: Cobrança Receptiva (Inbound)

Template: Suporte Técnico Receptivo (Inbound)

Recursos Vinculáveis

Diferença entre Instruções, Skills e Rules

Ciclo de Vida do Agente

Estados do Agente

Fluxo de Trabalho

Criando seu Primeiro Agente

Opção 1: Criar do Zero

Opção 2: Criar a partir de Template

Página de Detalhes do Agente

Cabeçalho

Ações Disponíveis

Seções de Recursos

Boas Práticas para Instruções

Estrutura Recomendada

Exemplo Completo

O que Evitar nas Instruções

Deploy e Ativação

Fazendo Deploy

Parando o Agente

Editando um Agente Ativo

Resolução de Problemas

Problemas Comuns

Checklist de Verificação

Excluindo um Agente

Próximos Passos