Configurar um agente de IA Conversacional no Jitterbit App Builder

Visão Geral

Este guia mostra como configurar a interface de chat no App Builder usando a página Agentes no IDE. Este é o segundo passo para configurar o recurso de IA Conversacional.

Após concluir esta etapa, uma bolha de chat aparece no canto inferior direito da sua aplicação, permitindo que os usuários interajam com seu agente de IA.

Pré-requisitos

Antes de configurar os agentes, você deve ter conectado seu agente de IA ao App Builder como uma fonte de dados da API REST. Consulte Conectar um agente de IA para obter instruções.

Adicionar um agente

1. Acesse o IDE.

2. Em Construir, clique em Agentes (Beta).

   

3. Clique em Criar. O diálogo de configuração do agente é aberto.

4. Configure o agente:

   • Nome: Insira um nome para o agente.

   • Fonte de Dados: Selecione a fonte de dados da API REST que você configurou na etapa anterior.

   • Alvo: Selecione o endpoint a ser usado para a interação do agente.

   • Description: (Opcional) Insira uma descrição do agente.

   • Mensagem de Boas-Vindas: (Opcional) Insira uma mensagem a ser exibida aos usuários quando eles abrirem a interface de chat.

   • Incluir Todas as Mensagens: (Opcional) Ative esta opção para incluir todo o histórico de conversas em cada solicitação enviada ao agente. Se desativado (o padrão), apenas a última mensagem é enviada.

   • É Padrão: Ative esta opção para tornar este o agente padrão para a aplicação. O agente padrão é aquele que se abre quando um usuário clica na bolha de chat .

   • Está Ativo: Ative esta opção para tornar o agente disponível para os usuários.

   • Arquivo de Ícone: (Opcional) Selecione uma imagem para usar como avatar do agente na interface de chat. Clique em Procurar para localizar o arquivo e enviá-lo. Se nenhum ícone for fornecido, a interface de chat exibirá um ícone padrão usando as duas primeiras letras do nome do agente.

5. Prévia do Ícone: Se você selecionou um avatar para o agente no campo Arquivo de Ícone, uma prévia do ícone selecionado é exibida.

6. Clique em Salvar. O balão de chat aparece no canto inferior direito.

   

   Importante

   O balão de chat é visível apenas para usuários pertencentes a um grupo que tem acesso à fonte de dados à qual o agente de IA se conecta. Usuários sem acesso não verão o balão de chat.

Configurar visibilidade do agente

Por padrão, o balão de chat de um agente é visível em todos os aplicativos personalizados e oculto em páginas do sistema. Desde o App Builder 4.62, é possível substituir esse comportamento por agente; por exemplo, para mostrar um agente de Vendas apenas em um aplicativo de Vendas e ocultá-lo em todos os outros aplicativos.

Para configurar a visibilidade de um agente:

1. Acesse o IDE.

2. Em Construir, clique em Agentes (Beta).

3. Localize o registro do agente e clique em Visibilidade. A caixa de diálogo Personalizar Visibilidade do Agente é aberta.

   

4. No dropdown Opções do Sistema, selecione como o agente se comporta nas páginas do sistema do App Builder:

   Opção	Descrição
   Ocultar em Aplicações do Sistema (padrão)	O agente é oculto em todas as páginas do sistema e visível em todos os aplicativos personalizados.
   Mostrar em Aplicações do Sistema	O agente é visível em todas as páginas do sistema (Menu do Site, IDE, Designer, Gerenciamento de Usuários e outras) e em todos os aplicativos personalizados.
   Mostrar apenas no Menu do Site	O agente é visível apenas no Menu do Site, oculto em todas as outras páginas do sistema e visível em todos os aplicativos personalizados.
   Ocultar em Todos os Lugares	O agente é oculto em todas as páginas do sistema e em todos os aplicativos personalizados. O agente é acessível apenas através de painéis de chat personalizados.

5. Em Visibilidade por Aplicativo, configure quais aplicativos personalizados exibem o agente:

   • Por padrão, nenhum aplicativo está selecionado, o que significa que o agente aparece em todos os aplicativos personalizados. Um ícone ao lado de um aplicativo indica que o agente será visível nesse aplicativo; um ícone indica que não será.
   • Para restringir o agente a aplicativos específicos, clique em Selecionar ao lado de cada aplicativo que deseja incluir.

   Dica

   Deixe todos os aplicativos desmarcados para garantir que o agente apareça em todos os aplicativos personalizados atuais e futuros. Selecionar aplicativos individuais significa que o agente não aparecerá em novos aplicativos adicionados ao sistema posteriormente. Esta configuração se aplica apenas quando o agente não está definido como Ocultar em Todos os Lugares em Opções do Sistema.

   Nota

   Quando Ocultar em Todos os Lugares está selecionado em Opções do Sistema, os controles de seleção de aplicativos ficam desativados.

6. Clique em Salvar para aplicar as alterações.

Balão de chat

Após salvar o agente, um balão de chat aparece no canto inferior direito. Você pode arrastá-lo e soltá-lo para reposicioná-lo na tela. Clicar no balão de chat abre uma janela de chat como um painel lateral, deslizando o conteúdo da página para a esquerda:

A janela de chat exibe o seguinte:

• O nome e o logotipo do agente padrão na parte superior.

• A mensagem de boas-vindas configurada para o agente.

• Uma caixa de texto de prompt na parte inferior com um botão de enviar (ou pressione Enter para enviar uma mensagem).

O canto superior direito da janela de chat possui os seguintes controles:

• Ícone de lápis: Abre um novo chat, limpando o histórico de mensagens atual. A mensagem de boas-vindas é exibida novamente.

• Ícone de maximizar: Expande o chat para tela cheia. No modo de tela cheia, uma barra de navegação aparece à esquerda.

• X: Fecha a janela de chat.

Na visualização do painel lateral, clicar no menu hambúrguer no canto superior esquerdo abre a barra de navegação, que exibe o seguinte:

• Agentes: Lista todos os agentes disponíveis. Clique em um agente para alternar para ele.

• Conversas: Exibe o histórico de conversas organizado por data, com cada entrada mostrando o ícone do agente utilizado naquela conversa.

Próximos passos

Após configurar um agente, você pode opcionalmente incorporar a interface de chat diretamente em um layout de página em vez de usar a bolha de chat flutuante . Veja Adicionar um painel de chat para continuar.