Pular para o conteúdo principal

Como criar um Agente

Este tutorial vai demonstrar a criação de um agente genérico, passo-a-passo.

Acessando o menu de agentes​

No menu lateral, acesse Agentes e clique em "+ Criar agente", no canto superior direito. Neste tutorial usamos a opção Criação avançada, que permite configurar cada aba do agente.

Informações gerais​

Nome do agente​

É o nome que seu agente terá na lista de agentes da sua equipe. Escolha um nome que ajude a identificar para que ele serve.

Descrição​

Descreva, em poucas palavras, para que serve o agente. Caso tenha dificuldade, você pode usar a função Magic, disponível no canto inferior direito do campo.

Grupo​

Define quem na sua organização pode ver esse agente.

Mensagem de apresentação​

É a primeira mensagem que seu agente enviará ao usuário ao iniciar uma nova conversa. Podemos pensar nela como uma saudação. Por exemplo, se salvarmos uma apresentação como "Olá, como posso ajudar?", o agente sempre iniciará suas conversas com essa mensagem.

Botões de resposta rápida​

Os botões do agente são atalhos que o usuário pode clicar em vez de digitar. O objetivo deles é direcionar o fluxo da conversa, guiando o usuário para que faça as perguntas ou declarações desejadas.

Nome do botão: o texto que será exibido no próprio botão. Ele indica ao usuário a ação que será tomada ao clicar.

Valor do botão: a mensagem enviada ao agente quando o botão é clicado. Aqui você determina como a conversa segue em resposta à interação do usuário.

Exemplo: se você criou um botão com o nome "Financeiro" e quer que o usuário seja levado para a parte de boletos, escreva no campo Valor do botão: "Quero falar sobre boletos dentro da área do financeiro, pergunte-me o que eu quero saber sobre isso".

Você também pode criar sub-botões dentro de um botão principal. Por exemplo, para criar opções dentro do botão "Financeiro", digite no campo Valor do botão: "Quero falar sobre uma das seguintes opções: boleto, contas em atraso ou cancelar a conta. Pergunte-me sobre qual eu quero falar".

Marque Manter botões fixos no chat para que os botões continuem visíveis durante toda a conversa, e não somente no início.

Conhecimentos​

O conhecimento pode ser pensado como uma pasta ou um banco de dados personalizado, que contém as informações nas quais seu agente se baseia para responder. Esse campo é opcional, mas, sem ele, o agente não terá acesso a um conhecimento específico extraído de um arquivo ou site, por exemplo. Para saber mais, veja Conhecimento.

Competências & MCPs​

A competência é uma lista de habilidades que o agente pode executar, como fazer chamadas de API ou abrir chamados. Esse campo também é opcional, mas, sem ele, o agente não terá acesso a nenhuma habilidade já criada. Para saber mais, veja Competências.

Nessa aba você também pode criar habilidades e servidores MCP exclusivos do agente e ativar as ferramentas nativas (gerar imagens, gerar documentos e categorizar conversas).

Subagentes​

Selecione outros agentes que este agente pode consultar ou para quem pode transferir a conversa, e descreva quando cada um deve ser chamado.

Personalidade​

Comportamento​

O comportamento é um pré-treinamento em que informamos ao agente de que maneira ele deve agir, qual tom de voz e personalidade assumir e quais passos tomar em um atendimento. Se deseja saber mais, veja Comportamento.

Restrições​

Descreva o que o agente nunca deve fazer, dizer ou revelar.

Tipo de voz​

É a voz usada quando o usuário pede para ouvir a resposta do agente.

Como a voz deve soar​

Descreva o idioma e o sotaque, o estilo e o tom da fala. A IA usa essa descrição para manter a voz consistente em todas as respostas.

Modelo de IA​

Modelo de IA​

A escolha do modelo de linguagem define a qualidade das respostas e o consumo de créditos: modelos mais avançados dão respostas melhores, mas consomem mais créditos por mensagem. Para saber mais sobre os modelos e qual o melhor para cada situação, veja Modelos.

Usar minha própria chave de API​

Opção para usar a chave da sua própria conta em vez de consumir créditos da plataforma.

Ajustes de geração de respostas​

São opcionais: os valores padrão funcionam bem para a maioria dos agentes. Os ajustes disponíveis variam conforme o modelo escolhido, como o esforço de raciocínio e a criatividade das respostas. Os detalhes estão em Personalização das Configurações do Modelo.

Status e privacidade​

Agente ativo​

Quando desligado, o agente para de responder a todos os usuários.

Ocultar dados pessoais​

Opcional. Mascara automaticamente CPF, telefone, e-mail e outros dados sensíveis que apareçam nas conversas.

Moderar mensagens dos usuários​

Opcional. Bloqueia automaticamente conteúdo ofensivo, ilegal ou impróprio enviado pelos usuários.

Conclusão​

Feito tudo isso, clique em Salvar. Para começar a interagir, acesse Agentes no menu lateral, encontre o seu agente na lista e clique em Conversar. Simples assim!