🛠️Meus Agentes A.I.
Ecossistema de agentes inteligentes projetado para oferecer suporte personalizado aos usuários da plataforma.
O que é o Agente A.I.?
O Chat IA é uma solução de atendimento inteligente que permite criar assistentes virtuais personalizados para sua empresa. Ele pode ser treinado com suas informações específicas e utilizar diferentes modelos de inteligência artificial para fornecer respostas precisas e contextualizadas.
Com agentes de A.I. você pode realizar diversos tipos de atendimento aos seus membros de forma autônoma, 24 horas por dia, 7 dias por semana, sem depender de respostas manuais. Eles auxiliam na tomada rápida de decisões, contam com personalização a partir dos conteúdos que você escolher e podem ser integrados com diversos sistemas.
Passo a Passo: Configurando um Agente
Acessar a Configuração do seu Agente A.I.
Faça seu login no Curseduca e navegue até a seção Agente A.I., no painel administrativo, conforme a imagem:
Se você ainda não tem o seu Agente, basta clicar em 'Quero ativar agentes de IA agora". Fale com a nossa equipe e adquira o seu.
Já tem o seu agente? Venha descobrir o mundo de possibilidade que ele tem.
Aba - Agentes
Nesta primeira tela você poderá:
Acompanhar seu plano e a quantidade de agentes ativos
Os créditos ativos e utilizados
Interações por agente: Quantidade de interações por agentes no período de tempo.
Dashboard
A guia “Dashboards” transforma todas as interações do Agente em gráficos simples de interpretar. Sendo possível acompanhar o uso, engajamento e qualidade sem precisar de planilhas ou consultas técnicas.
Sendo possivel acompanhar: interações, avaliações, tokens por agente (Quantidade de tokens utilizados por agente no período de tempo), Distribuição de tokens utilizados por agente no período de tempo.
Criando o seu Agente A.I.
Clique em "Criar Agente AI"
Definir Informações Básicas
Imagem de perfil: Selecione uma imagem para personalizar o seu agente. Pode ser um personagem, a logo da sua empresa, entre outros.
Nome de Exibição: Escolha um nome claro para identificar o agente. Este nome aparecerá no topo do chat.
Descrição: Adicione uma descrição complementar ao nome, que especifique a funcionalidade do seu agente. Essa descrição aparecerá para membros e administradores.
Escolher o Formato do Agente
Selecione um dos formatos disponíveis:
Chat Nativo
Nossa solução principal de Chat IA oferece: -Personalização completa -Controle total sobre o contexto -Integração perfeita com sua base de conhecimento -Monitoramento de uso e métricas
Incorporação
Uma solução inovadora para integrar outros assistentes mantendo o controle de acesso. -Sistema que permite incorporar qualquer URL de chat ou assistente externo -Mantém a experiência do usuário dentro do seu ambiente -Preserva o controle de acesso e segurança
Em seguida basta clicar em “Criar Agente A.I”
Prontinho, seu Agente AI foi criado.
Configurando seu agente
Agora vamos para as próximas configurações. Na aba ‘Aparência’:
Informações Básicas
Embora anteriormente você já tenha implementado estas configurações, aqui, nesta aba, você poderá editar e ou aprimorar. Podendo:
alterar a imagem do perfil e carregar uma nova,
alterar o nome de exibição do seu Agente
descrever a função do chat
Personalização geral
Cores: Escolha as cores do tema do chat (claro ou escuro) e, a cor de resposta do membro (essa será a cor de fundo da caixa de resposta do membro).
Personalização widget
Ícones e Cores
Personalize o ícone: Basta clicar no ícone e escolher algum que já esteja pré definido na plataforma ou é possível carregar uma imagem.
Cor do botão: Selecione uma cor para o botão que irá aparecer no canto inferior esquerdo da área de membros.
Configurar Mensagens e Instruções
Na aba de ‘configurações’
Vamos ajustar as seguintes configurações:
Mensagem Inicial: Defina uma mensagem automática que aparecerá quando o Agente for acionado (ex: "Olá! Como posso ajudar?").
Instruções (Prompt): Insira o prompt que guiará as respostas do Agente, incluindo tom de voz, estrutura e temperatura (ex: "Responda como um agente de CS, sendo cordial e objetivo").
Selecionar o Modelo de IA
Escolha entre os modelos disponíveis:
Cuseduca (Gemini) é um modelo disponibilizado por nós.
Já as opções:
Gemini e OpenAI é necessário ter a sua conta em uma destas plataformas e arcar com os custos referentes a cada uma delas.
Validação de chaves customizadas da OpenAI e Gemini
Insira a chave de API no campo indicado
Para OpenAI: a chave deve começar com
sk-Para Gemini: a chave deve começar com
AIza(O sistema já verifica automaticamente se o formato está correto.)
Aguarde a validação automática Após inserir a chave, o sistema: ✅ Verifica se o formato corresponde ao modelo selecionado ✅ Envia uma solicitação de teste para validar se a chave está ativa e com créditos disponíveis
Confira o resultado da validação
Se a chave for válida, o botão “Salvar alterações” será liberado automaticamente.
Se a chave for inválida (mesmo com formato correto), aparecerá a mensagem: “Chave API inválida para o modelo selecionado.”
Salve a configuração Clique em “Salvar alterações” para finalizar.
Por que isso é necessário?
Evita erros de digitação e chaves mal formatadas
Garante que a integração com o modelo de IA funcione corretamente
Assegura que a chave possui créditos e está ativa antes de permitir o uso
Melhora a segurança e a experiência de configuração
Definir disponibilidade e exibição
‘áreas de membros’: Selecione quais áreas de membros devem ter acesso ao seu Agente
'grupo de acesso': Mostra todos os grupos de acesso onde este agente está ativo e disponível para os membros.
Ao configurar o Agente de IA, você pode definir grupos de acesso (Essa configuração fica dentro do próprio grupo de acesso) para controlar quais alunos poderão interagir com o agente. Para fazer isso, basta abrir a configuração do grupo de acesso desejado e ativar o Agente A.I. nele.
Home > Grupos de Acesso > Editar > Produtos
Caso nenhum grupo de acesso seja selecionado, a plataforma entende que a liberação deve ser automática para todos os grupos.
Isso significa que:
Mesmo que você escolha apenas uma área de membros para disponibilizar o agente;
Se você não configurar um grupo de acesso, qualquer aluno que tenha acesso àquela área poderá interagir com o Agente de IA.
Recomendamos sempre definir um grupo de acesso específico quando a intenção for restringir o uso do agente.
Locais de Exibição
Widget no canto direito da plataforma.
Página Agente AI uma página dedicada ao agente (mostra todos os agentes disponíveis).
Permissão
Habilite e configure a permissão de visibilidade dos agentes. Você poderá deixar o seu agente aberto apenas para membros matriculados ou para o público em geral.
Adicionar Dados para Treinamento
Na aba de ‘Dados’ alimente o Agente com informações relevantes para melhorar suas respostas:
Arquivos: Faça upload de documentos com conhecimentos específicos para complementar as informações.
Formatos aceitos: .pdf, .doc, .docx
‘Texto’: Redija seu próprio texto para oferecer mais informações e contexto ao seu chat.
‘Vídeos’: Filtre o(s) vídeo(s) que você gostaria de vincular a esse agente, em seguida selecione-os. Coletamos os dados dos vídeos por meio da transcrição por IA do Cplayer. (Para essa função, é necessário utilizar a IA de transcrição do Cplayer).
Conectar
A aba “Conectar” mostra como levar o Agente para fora da plataforma ou integrar-se a outros canais. Ela é dividida em dois cartões principais:
Incorporação: Gera um trechinho de código (script) que você cola no HTML de qualquer site. Assim, o mesmo chat que aparece na área de membros pode ser exibido na página institucional, blog, landing page, entre outros.
Pré-requisitos: o Agente precisa estar com widget ativo e configurado como “acesso público”.
Integração (WhatsApp via Z-API) Conecta o Agente a um número de WhatsApp. Ele passa a responder mensagens recebidas nesse número automaticamente, usando o mesmo conhecimento que tem no chat. Depois de preencher as três chaves e clicar em “Gerar link de webhook”, o sistema cria um link já copiado para a área de transferência. Esse link deve ser configurado na conta Z-API para finalizar a integração.
Como integrar a Z-API? Siga o passo a passo
Configuração:
Na aba conectar, clique em integração e em “Z-API”
Ao clicar em “Habilitar“ você será redirecionado para o preenchimento de credenciais do Z-API
O ID e Token da instância podem ser coletados na listagem de instâncias no Z-API (https://app.z-api.io/app/instances):
Já o token do cliente deve ser coletado na aba “Segurança“ (https://app.z-api.io/app/security):
Após o preenchimento, clique em “Gerar link do webhook“
A partir disso será gerado um link de webhook e será copiado automaticamente para área de transferência. Use esse link gerado para configurar os webhooks da respectiva instância no z-api
Pontos de atenção:
O administrador é responsável pela contratação da plataforma z-api. A Curseduca oferece apenas a possibilidade de integração.
A Z-API é uma plataforma não oficial do WhatsApp, então números cadastrados podem estar sujeitos a restrições pela plataforma. No entanto, ressaltamos que essa possibilidade não está sob nosso controle.
Em nossa parte, não há cobranças adicionais por essa integração – apenas é necessário contratar o plano da própria plataforma Z-API.
As mensagens trocadas via WhatsApp consomem créditos exatamente do mesmo jeito que mensagens trocadas pelo chat da plataforma.
Com as configurações feitas, basta clicar em ‘salvar alterações’
Aparecerá um histórico das alterações realizadas. Verifique se os elementos alterados estão corretos, em seguida salve. Caso tenha algo que você editou errado e queira retornar, basta clicar em ‘cancelar’
Nos 3 pontinhos, você pode:
visualizar o agente
copiar o link do agente para colocar no seu menu, por exemplo
Ou, excluir o agente (escolha essa opção apenas se você tiver certeza disso).
Testar e Publicar
Visualize seu agente
Ajuste o prompt ou os dados conforme necessário.
Funcionalidades Avançadas
Histórico
A aba “Histórico” é o arquivo de todas as conversas realizadas com o Agente. Ela existe para que gestores possam rever atendimentos, entender dúvidas mais frequentes e acompanhar a qualidade das respostas – tudo em um só lugar.
Em poucos cliques você navega pelas interações, abre qualquer diálogo e usa essas informações para melhorar conteúdos ou ajustar o comportamento do seu agente.
Dashboards
A guia “Dashboards” transforma uso, alcance e feedback em gráficos claros, permitindo decisões rápidas para melhorar engajamento e qualidade do seu Agente.
Interações diárias
São curvas que evoluem dia a dia:
Mensagens trocadas (azul escuro)
Conversas iniciadas (azul médio)
Usuários únicos (azul claro)
Entenda picos de uso, compare dias da semana e identifique tendências de crescimento ou queda do chat.
Cartões-resumo
Interações: total de mensagens no período escolhido.
Interações únicas: quantas pessoas diferentes falaram com o Agente.
Média de sessões por usuário: quantas vezes, em média, cada pessoa voltou a conversar. Indica recorrência.
Taxa de likes – porcentagem de respostas avaliadas positivamente pelos usuários. É o termômetro da qualidade.
Avaliações
Acompanhe a satisfação em tempo real:
Após cada sessão de interação com o Chat AI, os membros são solicitados para avaliar a utilidade da resposta.
Likes 👍, Dislikes 👎 e “Sem reação”.
Período
Ajuste o seu dashboard de acordo com o período que você deseja analisar.
Selecione a opção e clique em 'confirmar'
Dúvidas e Informações adicionais
Estrutura de Planos
Os planos são baseados em dois fatores:
Número de agentes
Volume de tokens (milhões)
Para valores específicos de tokens, consulte seu CS.
Treinamento Ilimitado: Você pode treinar seu assistente quantas vezes quiser
Cobrança: Apenas as trocas de mensagens são contabilizadas
Posso ter múltiplos Agentes ativos simultaneamente? Sim, mas evite sobrepor widgets. Recomenda-se centralizar funcionalidades semelhantes em um único agente.
Importante saber
O agente A.I. Não é um atendente humano. Pode (e deve) ser treinado para responder sobre plataforma, planos de assinatura, políticas internas e perguntas frequentes.
O agente não é uma solução genérica. O desempenho depende diretamente do treinamento com suas informações específicas (arquivos, vídeos e instruções). Quanto mais contexto você fornecer, melhor a qualidade das respostas. Sem treinamento, ele responde apenas com conhecimento-base do modelo, que pode ser insuficiente ou impreciso para o seu negócio.
Não se trata de um sistema totalmente autônomo Exige configuração inicial (definir modelo, carregar dados, criar instruções, estilo). Recomendamos supervisão regular para ajustar rotas de conversação, monitorar métricas e manter a relevância.
Last updated