DOCS

Criar um agente avançado

Cadastre o agente, defina público e instruções, conecte capacidades e prepare o uso interno ou no chatbot.

Administrador

Criar um agente avançado

Monte um agente pequeno, com um objetivo claro, e amplie as capacidades depois de testar. Neste exemplo, o agente esclarece dúvidas comerciais e pode oferecer uma demonstração.

Acesse o construtor

Acesse Configurar um agente avançado e clique em Novo agente. O cadastro começa pelo formulário; o fluxo visual é aberto pelo botão Abrir Editor de Fluxo.

Preencha o cadastro

  1. Em Nome, informe Atendimento e agenda.
  2. Em O que este agente faz?, descreva o resultado: Responde dúvidas comerciais e ajuda a agendar uma demonstração.
  3. Em Este agente atende, escolha o público.
  4. Se houver uso interno, configure quem poderá encontrá-lo na Central de IA.
  5. Abra o editor de fluxo.
PúblicoComportamento esperado
Clientes pelo chatbotAtua no contexto da conversa externa. Ações seguem a autorização do fluxo, sem pedir ao cliente uma aprovação administrativa do CRM.
Equipe no CRMAtua com o usuário interno. A política de confirmação de alterações pode pedir revisão antes de executar.
Equipe e clientes · configuração avançadaPermite ambos; revise em cada capacidade o público e as confirmações internas.

Disponibilizar na Central de IA é uma configuração separada do público. Ao habilitá-la, escolha todos os usuários do projeto ou usuários/equipes selecionados. A equipe considerada é a equipe organizacional principal da pessoa. O acesso não amplia suas permissões de dados.

Configure o bloco Agente

Abra o bloco Agente. Em Como iniciar a execução, mantenha IA escolhe a capacidade conforme a conversa para este exemplo.

Em Objetivo e instruções, escreva regras do seu atendimento. Por exemplo:

Atenda com cordialidade e entenda a necessidade antes de sugerir uma demonstração.
Responda dúvidas usando as informações disponíveis.
Quando a pessoa demonstrar interesse, ofereça uma conversa com nossa equipe.
Se ela preferir atendimento humano, respeite essa preferência.

As capacidades já orientam seu próprio funcionamento. Não é necessário escrever no objetivo como resolver IDs, validar revisões de agenda ou executar controles internos do sistema.

Adicione somente as capacidades necessárias

Arraste os blocos da biblioteca para o canvas e ligue uma saída do Agente à entrada de cada capacidade opcional:

  • Conhecimento: informações comerciais autorizadas.
  • Agenda conectada: uma agenda e as operações permitidas.
  • Atendimento humano: situações em que a conversa deve voltar à equipe.

Dê nomes que expliquem a ação, como Agenda de demonstrações. Use Quando oferecer esta capacidade para indicar situações do seu negócio. Conectar uma capacidade não obriga o agente a usá-la em todas as mensagens.

Para uma sequência obrigatória, conecte o início guiado a uma etapa executável. A saída Depois · sequência dos blocos pode levar a uma próxima ação. Essa próxima ação deve obter os dados de valores fixos ou do contexto; uma nova pergunta pertence a um bloco de coleta.

Use o seletor de variáveis

Nos campos que aceitam contexto, use o botão de inserir variável. Ele mostra dados conhecidos pelo desenho atual: entradas do bot, respostas coletadas, resultados anteriores e campos de listas identificáveis na configuração.

OrigemExemplo de caminho
Entrada mapeada do botvars.nome
Resposta coletadavalues.email
Campo do registro ativorecord.values.descricao
Resultado de capacidaderesults.consulta
Entidade vinculadaentities.lead.id

Se a lista só for conhecida durante a execução, o editor não consegue antecipar todos os campos. Defina um contrato de campos consistente entre as listas utilizadas e selecione o caminho compatível; confira o valor no teste.

Salve, teste e libere

  1. Salve o desenho.
  2. Abra Testar agente e confira saudação, dúvida, interesse em agendamento e pedido de humano.
  3. Resolva os avisos de configuração.
  4. Marque Agente ativo e salve antes de selecioná-lo no bot.
  5. Para uso externo, conecte ao fluxo do bot.

O editor salva a configuração do agente. Um procedimento compartilhado tem seu próprio salvamento: confira qual cadastro foi alterado antes de fechar.

Se algo não funcionar

SintomaO que conferir
Agente não aparece no botAtivo, público externo e projeto correto.
Não aparece na Central de IAUso interno habilitado, público interno compatível e usuário/equipe permitidos.
A ação ocorre cedo demaisInício guiado, conexões em sequência e instruções do negócio.
Campo necessário não aparece no seletorFonte conhecida pelo editor, resultado anterior e campos da lista disponíveis ao agente.

Próximos passos