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 Registrar 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

Acesse o IDE.
Em Construir, clique em Registrar Agentes.
Clique em Registrar. O diálogo de configuração do agente será aberto.
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.
- Descrição: (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 mensagem mais recente é enviada.
- É Padrão: Ative esta opção para tornar este o agente padrão da 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.
Prévia do Ícone: Se você selecionou um avatar para o agente no campo Arquivo de Ícone, uma prévia do ícone selecionado é exibida.
Clique em Salvar. O balão de chat aparece no canto inferior direito. Na caixa de diálogo de configuração, uma mensagem aparece lembrando você de usar o botão Mapeamentos para configurar os mapeamentos. Veja a próxima seção, Configurar mapeamentos de tipo de uso.

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 está conectado. Usuários sem acesso não verão o balão de chat.

Configurar mapeamentos de tipo de uso

Os mapeamentos de tipo de uso informam ao App Builder quais colunas da fonte de dados do seu agente de IA contêm a mensagem do usuário, a resposta do agente e outros dados da sessão. A interface de chat requer esses mapeamentos para se comunicar corretamente com o agente. Se você já configurou os mapeamentos manualmente na área de Servidores de Dados, pule esta seção e prossiga para Configurar visibilidade do agente.

Após criar um agente, clique em Mapeamentos na caixa de diálogo de configuração. Uma nova caixa de diálogo se abre, mostrando o nome do agente e o servidor de dados na parte superior, e uma tabela com as seguintes colunas:

Caixa de diálogo de Mapeamentos

Direção: Identifica se uma determinada coluna é usada para entrada ou saída.
Nome: O nome da coluna.
Valores de Teste de Endpoint: Mostra os valores de exemplo usados durante a descoberta do endpoint, fornecidos apenas para contexto. Esses valores não são utilizados ao testar o registro do agente.
Mapeamento: Para cada linha na tabela, use este dropdown para atribuir o tipo de uso apropriado. As opções disponíveis dependem do valor na coluna Direção:
- As colunas de Saída recebem dados do endpoint. O único mapeamento disponível é Resposta do Agente, a resposta em texto recebida de volta do agente personalizado.

As colunas de Entrada enviam dados para o endpoint. Os mapeamentos disponíveis são:

| Mapeamento            | Descrição                                                            |
|-----------------------|----------------------------------------------------------------------|
| **Prompt do Usuário** | A mensagem de chat ou prompt enviado para o agente personalizado.     |
| **ID do Usuário**     | Envia o ID único do usuário logado.                                  |
| **Email**             | Envia o email do usuário logado.                                    |
| **Nome de Usuário**   | Envia o nome de usuário do usuário logado.                           |
| **ID da Conversa**    | Envia o ID único da conversa de chat atual.                          |

Após configurar os mapeamentos, clique em Validar no topo da caixa de diálogo. A validação executa um teste contra o endpoint e relata quaisquer problemas de configuração. Se o teste do endpoint falhar, os resultados são exibidos no painel superior para ajudar a diagnosticar o problema.

Configurar visibilidade do agente

Por padrão, a bolha de chat de um agente é visível em todos os aplicativos personalizados e oculta 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:

Acesse o IDE.
Em Construir, clique em Registrar Agentes.
Localize o registro do agente e clique em Visibilidade. A caixa de diálogo Personalizar Visibilidade do Agente é aberta.

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 todas as aplicações personalizadas. |
| **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 todas as aplicações personalizadas. |
| **Mostrar apenas no Menu do Site**     | O agente é visível apenas no [Menu do Site](/pt/app-builder/how-to/site-menu/), oculto em todas as outras páginas do sistema e visível em todas as aplicações personalizadas. |
| **Ocultar em Todos os Lugares**        | O agente é oculto em todas as páginas do sistema e em todas as aplicações personalizadas. O agente é acessível apenas através de [painéis de chat](/pt/app-builder/documentation/conversational-ai/chat-panel/) personalizados. |

Sob 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.
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:

Painel lateral de chat

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.
Chats: Exibe o histórico de chats organizado por data, com cada entrada mostrando o ícone do agente utilizado naquela conversa.

Barra de navegação do chat

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.