COMO CRIAR UM AGENTE DE IA NO TOOLZZ AI?
Sobre
Os agente de IA são uma forma simples e eficiente de automatizar interações com usuários usando inteligência artificial.
Eles podem ser usados para atendimento e suporte, treinamento de colaboradores, FAC e dúvidas, vendas, processo seletivo
entre muitas outras atividades.
Você vai aprender como criar esses agentes de IA do zero, definindo fluxos, conectando APIs e até treinando seu cérebro
com documentos ou informações específicas da sua empresa.
Como funciona
Na prática, ele é um agente que conversa com pessoas de forma automática e, quando integrado com IA, consegue
interpretar perguntas, entender contextos e oferecer respostas mais inteligentes. Em resumo, você pode criar seu próprio
ChatGPT no seu site e treinar a IA com seu conteúdo.
São três principais etapas de criação e configuração:
- Agente
- Cérebro
- Visual
Dentro dessas etapas você encontrará funcionalidades avançadas que podem incrementar ainda mais seu agente de IA.
Passo a passo
1º passo: no menu lateral, clique na opção "Agentes de IA".
Depois, clique no botão "+ Criar Agente de IA" localizado no canto superior direito da tela.
💡Dica: se você estiver criando seu primeiro agente de IA, verá este mesmo botão no centro da tela.
2º passo: escolha se deseja criar um agente de IA "Básico" ou "Avançado" clicando em uma das opções e depois clique me
"Continuar".
❗Informação importante: nas duas opções você terá acesso a todas as funcionalidades e configurações do agente de IA. A
diferença é o layout inicial do formulário: na opção "Básico" alguns campos de configurações avançadas ficam ocultos,
mas você pode expandir o menu para acessá-los.
Agente
Na etapa de configuração "Agente" você vai personalizar itens da identidade e poderá ativar recursos avançados que
potencializam a atuação do agente de IA.
Personalidade do Bot
3º passo: preencha o formulário com as informações solicitadas.
- Nome do bot: dê um nome para identificar seu bot;
- Breve descrição do bot: escreva uma pequena descrição sobre o objetivo ou funcionalidade desse bot;
- Tags: escreva o nome da tag, aguarde o carregamento e depois aperte "Enter" no seu teclado para criar a tag;
- Adicionar logo: clique nesse campo e faça o upload de uma foto para identificar o bot. Você pode enviar arquivos no
formato SVG, PNG ou JPG. A proporção ideal de 1:1 e o tamanho máximo de 20MB.
💡Dica: essas informações refletem apenas na página onde ficam listados os agentes de IA, dentro da plataforma, ou seja,
servem somente para identificar cada agente.
Recurso do agente
Recurso do agente é mais uma seção da página "Agente". Nela você encontrará funcionalidades opcionais que podem ser
ativadas para tornar o agente de IA mais poderoso e adaptado a diferentes necessidades.
4º passo: clique no botão de seta para baixo para expandir a seção.
5º passo: você pode ativar quantas funcionalidades desejar. Para isso, clique nas chaves de ativação de cada uma das
funcionalidades "Funções", "Habilidades", "IA Store", "Voice" e "WhatsApp". Repare que elas ficarão coloridas.
Botões com os nomes das funcionalidades, aparecerão no menu superior. Neles você encontrará formulários de configurações
relativos a cada uma delas.
Vamos falar mais sobre elas ao longo deste artigo.
Analytics
O Toolzz Analytics permite analisar detalhadamente as fontes usadas pela IA nas respostas, além de acompanhar o custo
por pergunta e o total em períodos específicos. Isso facilita o controle orçamentário e a gestão eficiente dos recursos.
6º passo: se quiser vincular o Analytics ao agente de IA, clique na chave de ativação.
❗Informação importante: o Toolzz Analytics é oferecido como um add-on, ou seja, é uma funcionalidade adicional que não
está inclusa nos planos do Toolzz AI e precisa ser contratada à parte.
- Se ainda não possui o Analytics, precisará realizar a contratação adicionando a funcionalidade ao seu plano. Veja o
passo a passo em COMO CONTRATAR O PLUGIN DO ANALYTICS NO TOOLZZ AI.
- Se você já possui o plugin do Analytics, já pode começar a configurar a funcionalidade.
Ao ativar a chave, repare que ela ficou colorida e campo "Credenciais" apareceu. Clique em "Escolha uma credencial"
e crie ou selecione uma credencial do Analytics.
❗Informação importante: primeiro você precisa criar uma Chave API dentro do Analytics e, depois, inserir essa chave em
uma credencial no Toolzz AI. Se ainda não sabe como fazer isso, veja o passo a passo em: COMO CRIAR UMA CREDENCIAL DO
TOOLZZ ANALYTICS NO TOOLZZ AI.
7º passo: após finalizar todas as configurações da parte de "Agente", clique no botão "Continuar", localizado no canto
direito superior da página, para passar para a próxima etapa.
Cérebro do Bot
Nesta parte você precisará configurar a fonte de conhecimento da IA, como: a inteligência artificial que será usada, o
prompt (roteiro da personalidade do bot), além de uma base de dados que o bot vai usar para responder os usuários.
É aqui que se define o conteúdo que o agente de IA vai consultar para entender e responder corretamente às perguntas dos
usuários.
Modelo
Escolha o modelo de inteligência artificial que você usará no seu agente de IA.
8º passo: em "Credenciais", clique em "Escolha uma credencial".
É possível escolher entre três opções de IA: Gemini, Open AI e Anthropic. Clique na opção desejada e preencha o
formulário com o nome e a chave da IA.
Se quiser ver mais detalhes sobre o assunto, acesse nosso tutorial **COMO CRIAR UMA CREDENCIAL DA OPEN AI NO TOOLZZ AI.
**
E as documentações oficiais da **Gemini **e Anthropic.
9º passo: se a conexão for validada, você conseguirá escolher um modelo de IA.
❗Informações importantes
- Os modelos vão variar de acordo com o tipo de credencial (Gemini, Open AI ou Anthropic).
- Cada modelo possui capacidades diferentes em termos de velocidade, custo e nível de sofisticação, permitindo que
você escolha o mais adequado para a sua necessidade.
Comportamento do Bot
Definir o comportamento do agente de IA, ou seja, criar um prompt, é uma etapa essencial para garantir uma experiência
consistente e eficiente. Esse comando inicial direciona a IA sobre como se portar, o que fazer e o que evitar,
influenciando diretamente a forma como ela se comunica com os usuários.
Um bom prompt funciona como um "manual de conduta". Quanto mais completo for, mais alinhado estará com os objetivos da
empresa e mais natural será sua comunicação com os usuários. Ele pode incluir:
- O papel da IA: qual função ela está desempenhando (ex: atendente, assistente comercial, suporte técnico etc.);
- Tom de voz: como ela deve se comunicar (ex: formal, descontraído, amigável, técnico etc.);
- Regras de conduta: o que pode ou não dizer (ex: evitar gírias, palavrões, ironia, ou assuntos sensíveis);
- Público-alvo: quem são as pessoas com quem a IA vai interagir (ex: clientes finais, equipe interna, fornecedores);
- Estilo de linguagem: uso de emojis, contrações, mensagens curtas ou explicações detalhadas;
- Limitações e orientações específicas: se deve evitar certos tópicos, redirecionar para humanos em determinadas
situações, ou sempre oferecer um link de ajuda, por exemplo.
Exemplo de prompt bem estruturado:
"Você é o assistente virtual da plataforma de educação corporativa Toolzz. Sua função é orientar os usuários no uso da
plataforma, indicando artigos e tutoriais da central de ajuda sempre que possível.
Adote uma linguagem simples, clara e acessível. Seja educado, proativo e amigável, mas mantenha uma postura profissional
— evite piadas, ironias e termos informais.
Use frases diretas e objetivas. Emojis são permitidos com moderação para transmitir simpatia.
Nunca invente respostas: se não souber a solução, oriente o usuário a buscar ajuda com o time de suporte humano.
Não fale sobre política, religião ou qualquer assunto fora do contexto da plataforma. Nunca utilize palavrões ou
linguagem ofensiva.
Sempre se apresente no início da conversa e, quando possível, chame o usuário pelo nome para personalizar o
atendimento."
Esse é um exemplo de um prompt mais simples, mas você pode consultar o artigo MELHORES PRÁTICAS PARA ESCREVER O
COMPORTAMENTO DO AGENTE DE IA (PROMPT) para aprender mais.
10º passo: escreva o prompt na caixa de texto.
Se quiser, você pode usar os botões complementares para te ajudar na construção do seu prompt:
- Escreva ao menos uma frase com o objetivo do seu prompt e clique no ícone de varinha mágica para que a própria
plataforma crie um prompt mais detalhado.
- Escreva um prompt e clique no ícone de estrela para que a própria plataforma melhore este prompt.
- Clique no ícone com o desenho de quatro setas opostas para expandir a caixa de texto do prompt.
Clique em "Salvar" para salvar as alterações realizadas ou em "Cancelar" para voltar para tela do formulário de
construção do agente de IA.
Base de Conhecimento
A base de conhecimento, ou Dataset, será o cérebro do agente IA.
Quando falamos em "criar uma base de conhecimento" e "treinar sua IA", estamos basicamente dizendo que queremos ensinar
um sistema de inteligência artificial (IA) sobre um determinado assunto específico.
O agente de IA usa os arquivos do dataset para pesquisar, extrair e analisar informações relevantes em resposta às
perguntas dos usuários.
11º passo: se você já criou datasets, clique na caixa de seleção do ou dos itens que deseja utilizar neste agente de IA.
Você pode selecionar todo um dataset ou apenas pastas especificas.
Se você ainda não criou um dataset no Toolzz AI, clique no botão "+ Criar Dataset" e siga o passo a passo do artigo COMO
CRIAR A BASE DE CONHECIMENTO (DATASET) PARA A IA NO TOOLZZ AI.
Configurações avançadas
As configurações avançadas permitem controlar com mais precisão o comportamento da IA, a qualidade das respostas, os
dados considerados na busca e os limites de segurança.
Essas opções ajudam a personalizar o estilo de interação, otimizar recursos e garantir eficiência mesmo diante de erros
ou alto volume de informação.
❗Informação importante: essas configurações já vêm ajustadas para a maioria dos usos. Se você não tem necessidades
específicas ou familiaridade técnica, o ideal é manter a configuração padrão, que equilibra bem desempenho, segurança e
qualidade.
12º passo: clique no botão de seta para baixo para expandir a seção.
É possível ajustar qualquer um dos itens das configurações avançadas de duas maneiras:
- Clicar no círculo branco na barra de ajuste e arrastá-lo para a posição desejada. Repare que o número dentro do
retângulo muda automaticamente.
- Clicar no retângulo com o número, apagá-lo e digitar o novo número desejado.
🚨Atenção: para configurar "Fallback" e "Segurança" é preciso clicar na chave de ativação dessas opções.
Visite o artigo COMO AJUSTAR AS CONFIGURAÇÕES AVANÇADAS DO AGENTE DE AI para ver explicações, exemplos e o passo a passo
de como configurar cada um dos itens relacionados às opções de "Comportamento da IA", "Busca Avançada", "Fallback" e
"Segurança".
13º passo: após finalizar todas as configurações da parte de "Cérebro", clique no botão "Continuar", localizado no canto
direito superior da página, para passar para a próxima etapa.
Recurso do agente - Habilidades
As habilidades servem para definir o que cada agente de IA é capaz de fazer durante as interações com os usuários. Elas
são funcionalidades que você pode escolher ativar, permitindo que a IA execute ações específicas como ler um arquivo,
analisar uma página de web ou reconhecer uma imagem. Com isso, é possível personalizar a atuação do agente de acordo com
os objetivos do seu projeto.
14º passo: se você ativou a chave "Habilidades" na parte de "Recurso do Agente", na aba "Agente", como ensinamos aqui, e
realizou as configurações anteriores, acesse a aba da funcionalidade.
⚠️ Se você não ativou as habilidades e não pretende utilizar este recurso agora, avance para a próxima seção deste
artigo.
Acesse o artigo **COMO CONFIGURAR AS HABILIDADES DA SUA IA NO TOOLZZ AI **e aprenda como funciona cada uma das
habilidades.
Recurso do agente - Voice
O Voice transforma a interação com o agente de IA em uma conversa por áudio em tempo real, como uma ligação. Em vez de
digitar, o usuário fala e ouve as respostas da IA, tornando a comunicação mais natural, rápida e acessível. Ideal para
quem busca uma experiência mais fluida e próxima do atendimento humano.
15º passo: se você ativou a chave do "Voice" na parte de "Recurso do Agente", na aba "Agente", como ensinamos aqui, e
realizou as configurações anteriores, acesse a aba da funcionalidade.
⚠️ Se você não ativou o Voice e não pretende utilizar este recurso agora, avance para a próxima seção deste artigo.
❗Informação importante: o voice é oferecido como um add-on, ou seja, é uma funcionalidade adicional que não está inclusa
nos planos do Toolzz AI e precisa ser contratada à parte.
- Se ainda não possui o Voice, precisará realizar a contratação clicando no botão de upgrade. Acesse o artigo COMO
CONTRATAR O ADD-ON DO VOICE NO TOOLZZ AI e veja o passo a passo.
- Se você já possui o add-on do Voice, já pode começar a configurar a funcionalidade. Acesse o artigo COMO CRIAR E
CONFIGURAR O VOICE PARA SUA IA NO TOOLZZ AI e aprenda todo o passo a passo.
Visual
Chamamos a janela de bate-papo que aparece na tela e permite os usuários interagirem diretamente com agente de IA de
widget. Na parte de configuração do visual você vai personalizar esse widget.
Isso engloba elementos visuais e interativos como caixas de texto, cor do texto, botões, ícones, imagem do avatar,
primeira mensagem a IA, voz da IA e etc.
Para ver com detalhes o passo a passo de como customizar todos estes elementos, acesse o artigo COMO CRIAR E
PERSONALIZAR O WIDGET DO AGENTE DE IA NO TOOLZZ AI.
💡Dica: se você já criou algum widget no Toolzz AI e ele ainda não está sendo usado em nenhum agente de IA, a opção
'Selecionar widget' ficará disponível nas configurações de 'Visual'. Assim, você poderá escolher um dos widgets
disponíveis, que esteja ativado, para ser usado no seu agente de IA.
16º passo: após realizar todas as configurações, clique no botão "Criar widget".
Depois disso, o código de incorporação do widget será gerado. Ele deve ser adicionado ao seu site para que o o ícone do
chatbot apareça no canto da tela e possa e possa ser acessado pelos visitantes.
Você também terá acesso ao link de compartilhamento (embed e web) do chatbot. Ele permite que você disponibilize o seu
agente de IA de forma rápida e simples, sem precisar integrá-lo diretamente em um site. Esse link pode ser enviado para
os usuários ou usado em diferentes canais para que qualquer pessoa possa interagir com o agente de IA.
Para saber todos os detalhes e o passo a passo de como incorporar e compartilhar seu agente de IA, acesse o artigo de
ajuda sobre CÓDIGO E LINK DE INCORPORAÇÃO DO WIDGET.
17º passo: não se esqueça de clicar no botão "Concluir", localizado no canto superior direito da tela, para salvar todas
as configurações.
Pronto! Agora você já sabe, detalhadamente, todos os passos para criar um agente de IA.
