Ir para o conteúdo

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 criado com o Studio e que é exposto por meio de uma API do API Manager.

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.

Construir um aplicativo inteligente

  1. Faça login na sua instância do App Builder.

  2. Crie uma nova fonte de dados REST para conectar-se ao agente de IA por meio de 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 no 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.

      server

    4. Clique em Salvar, e depois feche o diálogo.

  3. Configure o endpoint da API para o agente de IA:

    1. Clique em Detalhes para a nova fonte de dados REST.
    2. Nos painéis Endpoints e Parâmetros do Endpoint, adicione endpoints e parâmetros conforme apropriado. Você também pode usar o botão Descobrir para preencher automaticamente os parâmetros do endpoint e a saída do agente de IA.

    web service

  4. (Opcional) Crie um novo aplicativo:

    1. No Action Drawer > Menu do Site, clique em + App. O diálogo Criar Novo Aplicativo é aberto.
    2. Insira um Nome para o aplicativo.
    3. Clique em Criar App. O aplicativo é construído e o novo app é aberto na sua página inicial.
  5. Adicione a fonte de dados REST da API 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.

    data sources

  6. Construa 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:

      create table

    2. Crie um objeto de negócio que selecione essas colunas:

      rule builder

    3. Crie uma página com um painel que utilize este objeto de negócio. Adicione as duas colunas para prompt e resposta:

      page properties

      controls

    4. Visualize sua página:

      home

  7. Na regra de negócio da página, configure um evento que acionará a chamada da API e armazenará em cache a resposta:

    event

    1. Vá para Action Drawer > App Workbench e abra a aba Business Layer > Rules.
    2. Clique em Events na regra de negócio da 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:
  8. Uma ação com o propósito de Chamada de API. Passe os parâmetros do endpoint da fonte de dados do seu aplicativo para o endpoint da API:

    rule builder

  9. Uma ação com o propósito de Atualização / Inserção de XP. Salve a resposta atualizando um valor na fonte de dados do seu aplicativo ou inserindo a resposta em uma tabela:

    rule builder

  10. Experimente inserindo um prompt na sua página e veja a resposta:

    test

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. Você pode 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 do seu aplicativo. A resposta do agente então atua 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 encaminhar automaticamente 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 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.

  • Use entradas e saídas estruturadas com agentes de IA
    Vá além de simples prompts de texto 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 de aplicativo 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.