Como construir um aplicativo inteligente no Jitterbit Harmony

Visão geral

Este guia mostra como construir um aplicativo inteligente no Jitterbit Harmony usando o App Builder. Um aplicativo inteligente é um aplicativo do App Builder que utiliza um agente de IA exposto através de um endpoint de API REST.

Embora este guia se concentre em agentes de IA criados com o Studio e expostos via API Manager, os mesmos passos de integração se aplicam a qualquer serviço de IA que forneça um endpoint de API REST, incluindo serviços de IA de terceiros.

Importante

Esses passos são uma continuação dos guias de como construir um agente reativo, construir um agente contextual, e construir um agente com RAG.

Conectar agentes de IA a aplicativos

Depois de criar um agente de IA no Studio, você pode expô-lo através de uma API personalizada do Jitterbit para torná-lo acessível aos aplicativos do App Builder.

A API personalizada fornece um endpoint REST padrão que os aplicativos do App Builder podem chamar para acionar o agente de IA e receber uma resposta. A mesma API personalizada pode ser usada por vários aplicativos ou sistemas externos além do App Builder (como Slack).

Construir um aplicativo inteligente

Faça login na sua instância do App Builder.
Crie uma nova fonte de dados REST para conectar-se ao agente de IA via um endpoint de API:
1. Vá para Action Drawer > IDE.
2. Em Conectar, clique em Servidores de Dados.
3. Clique em + Servidor e insira os detalhes de configuração na caixa de diálogo. A URL deve ser a URL do serviço API da API Manager que você criou em construir um agente de IA reativo.
4. Clique em Salvar, e então feche a caixa de diálogo.
Configure o endpoint da API para o agente de IA:
1. Acesse a configuração do endpoint clicando no ícone Endpoints da nova fonte de dados REST na lista Data Servers.
2. (Opcional) No painel Web Service Parameters, adicione quaisquer parâmetros necessários para todos os endpoints, como parâmetros de cabeçalho para autenticação da API.
3. No painel Endpoints, adicione o endpoint:
  1. Clique em + Endpoint.
  2. No campo Name, insira um nome descritivo para referenciar este endpoint no App Builder.
  3. No campo Endpoint, insira o caminho do serviço ou endpoint da sua API.
  4. Selecione o Method (por exemplo, GET ou POST).
  5. Salve o endpoint.
4. No painel Endpoint Parameters, configure parâmetros que permitam que sua aplicação passe valores dinâmicos para a API. Você pode adicionar parâmetros manualmente ou clicar em Discover para importar automaticamente o esquema de parâmetros e a estrutura de resposta do agente de IA.
Dica

Para mais informações sobre como conectar-se a APIs REST no App Builder, veja REST APIs in Jitterbit App Builder.
(Opcional) Crie um novo aplicativo:
1. No Action Drawer > Site Menu, clique em + App. A caixa de diálogo Create New Application é aberta.
2. Insira um Name para o aplicativo.
3. Clique em Create App. O aplicativo é construído e o novo app é aberto na sua página inicial.
Adicione a fonte de dados da API REST do agente de IA ao seu aplicativo:
1. Vá para Action Drawer > App Workbench e abra a aba Data Layer > Data Sources.
2. No painel Data Sources, clique em + Source. A caixa de diálogo Add a Source to your application é aberta.
3. Selecione Link to existing source, em seguida clique em Next.
4. Selecione a fonte de dados REST que você acabou de criar, em seguida clique em Link 1 Source. Clique em Done.
Crie uma página de front-end criando tabelas, painéis, controles, etc. na camada de UI. Projete a página de front-end de forma que permita ao usuário inserir os parâmetros de endpoint necessários para o agente de IA e exibir a resposta do endpoint da API:

Por exemplo:
1. Crie uma tabela de sessão gerenciada e adicione colunas para o prompt e a resposta:
2. Crie um objeto de negócios que selecione essas colunas:
3. Crie uma página com um painel que utilize este objeto de negócios. Adicione as duas colunas para prompt e resposta:
4. Visualize sua página:
Na regra de negócios da página, configure um evento que acionará a chamada da API e armazenará em cache a resposta:
1. Vá para Action Drawer > App Workbench e abra a aba Business Layer > Rules.
2. Clique em Events na regra de negócios para a página e adicione um evento de regra ou use o evento intrínseco Save.
3. Na Rule Event Detail, adicione as seguintes ações:
  1. Uma ação com o propósito de API Call. Passe os parâmetros de endpoint da fonte de dados do seu aplicativo para o endpoint da API:
  2. Uma ação com o propósito de XP Update / Insert. Salve a resposta atualizando um valor na fonte de dados do seu aplicativo ou inserindo a resposta em uma tabela:
Experimente inserindo um prompt na sua página e veja a resposta:

Aprimorar aplicações inteligentes

O exemplo anterior demonstra uma integração simples: passando um prompt do usuário para um agente de IA e exibindo a resposta. É possível expandir essa capacidade aproveitando a camada de lógica de negócios e os serviços em segundo plano do App Builder para criar aplicações mais inteligentes e automatizadas. Aqui estão algumas maneiras de fazer isso:

Integrar IA em fluxos de trabalho como gatilhos de decisão
Em vez de esperar por uma ação do usuário, você pode invocar o agente de IA dentro dos eventos de lógica de negócios da sua aplicação. A resposta do agente atua então como um ponto de decisão ou gatilho para ações subsequentes.

Exemplo

Passe dados de um novo registro de vendas ou de um ticket de suporte recebido dentro da definição da regra ou como critérios de vinculação para o agente de IA. A saída do agente (por exemplo, uma classificação ou uma pontuação de risco) dita os próximos passos no fluxo de trabalho do App Builder, como o roteamento automático de um ticket de alta prioridade.
Agendar agentes de IA usando serviços em segundo plano
Automatize a inteligência configurando os serviços em segundo plano do App Builder para executar o agente de IA periodicamente em uma programação noturna ou horária. Isso permite o processamento e a análise proativa de dados sem interação direta do usuário.

Exemplo

Um serviço em segundo plano executa um agente de IA todas as noites para resumir os relatórios financeiros do dia e sinalizar quaisquer transações anômalas.
Usar entradas e saídas estruturadas com agentes de IA
Vá além de prompts de texto simples trocando dados estruturados com o agente de IA. Isso garante que a análise seja ricamente contextual e que a saída seja imediatamente acionável:
- Entrada estruturada: Passe um registro completo ou um conjunto complexo de dados (geralmente como JSON) em vez de apenas uma pergunta ou texto simples. Isso leva a respostas altamente personalizadas e mais precisas.
- Saída estruturada: Configure o agente para retornar sua resposta como um objeto estruturado (JSON, tags HTML, etc.). O App Builder pode então analisar campos específicos dessa saída, como uma pontuação de confiança, um resumo gerado ou um ID de ação recomendada, e mapeá-los diretamente para campos da aplicação ou variáveis de fluxo de trabalho.
Automatize tarefas complexas encadeando agentes
Para tarefas complexas, o App Builder pode atuar como um orquestrador que encadeia múltiplos agentes de IA ou mistura agentes de IA com serviços de negócios existentes:
- Encadeamento de agentes: A saída de um primeiro agente de IA (por exemplo, um agente que extrai dados de um documento) é automaticamente passada como entrada para um segundo agente de IA (por exemplo, um agente que resume os dados extraídos).
- Fluxos de trabalho híbridos: O agente de IA lida com a parte cognitiva complexa de um processo (por exemplo, recomendando uma estratégia de precificação), enquanto os serviços padrão do App Builder lidam com a parte transacional (por exemplo, usando um conector de banco de dados para executar a atualização de preço recomendada).

Ao integrar o agente de IA na lógica de negócios e de fundo do seu aplicativo, você pode construir aplicativos inteligentes poderosos, proativos e automatizados.