Ir para o conteúdo

Agente de Inteligência Competitiva da Jitterbit

Visão geral

A Jitterbit oferece o Agente de Inteligência Competitiva aos clientes através do Jitterbit Marketplace. Este agente automatiza a coleta de inteligência de mercado usando busca na web com inteligência artificial para identificar, resumir e entregar notícias relevantes do setor e atualizações de concorrentes para sua equipe. O agente usa a técnica de Geração com Recuperação Aumentada (RAG), que combina raciocínio de LLM com acesso a ferramentas e fontes de dados externas.

O agente funciona em cronogramas configuráveis — diariamente para monitoramento de tendências do setor e semanalmente para rastreamento de concorrentes. Cada execução realiza uma busca na web direcionada, resume os resultados em um email HTML estruturado e entrega o relatório diretamente aos destinatários configurados. Nenhuma entrada manual é necessária após a configuração inicial.

O agente executa as seguintes tarefas:

  • Realiza varredura na web semanalmente em busca de atualizações de concorrentes, incluindo lançamentos de produtos, mudanças de liderança e comunicados à imprensa.
  • Realiza varredura na web diariamente em busca de notícias do setor relacionadas aos tópicos configurados, filtrando histórias de alto impacto das últimas 24–48 horas.
  • Resume resultados de busca em relatórios de email concisos e estruturados adaptados ao contexto de sua empresa.
  • Entrega relatórios de email em HTML formatado automaticamente aos destinatários configurados.

Este documento explica como configurar e operar este agente de IA. Ele cobre arquitetura, pré-requisitos e etapas para instalar, configurar e operar o agente de IA.

Arquitetura do agente de IA

Este agente de IA automatiza a entrega de inteligência de mercado usando busca na web com inteligência artificial e operações agendadas. Um fluxo de trabalho típico segue estas etapas:

  1. Um cronograma de operação diário ou semanal dispara a operação do controlador apropriada.
  2. Um prompt de busca é construído com base nos tópicos ou concorrentes configurados.
  3. O prompt é enviado para a OpenAI, que executa uma busca na web em tempo real e retorna resultados resumidos.
  4. Os resultados são formatados em um email HTML estruturado usando o modelo pré-definido do projeto e seu contexto de empresa.
  5. O email formatado é enviado aos destinatários configurados via SMTP.

Diagrama de fluxo de trabalho

O diagrama a seguir mostra o fluxo de trabalho principal de tratamento de solicitações para esta integração.

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 20 nodeSpacing: 80 --- flowchart LR classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px SCHED@{ shape: delay, label: "Operation schedule
(daily or weekly)" } JSP@{ shape: hex, label: "
Competitor Intel
Agent" } OAI[fas:fa-brain
OpenAI
Responses API] EMAIL[fas:fa-envelope
Email recipients] SCHED -->|1. Trigger| JSP JSP -->|2. Web search prompt| OAI OAI -->|3. Search results| JSP JSP -->|4. Send formatted email| EMAIL

Pré-requisitos

Você precisa dos componentes a seguir para usar este agente de IA.

Componentes do Harmony

Você deve ter uma licença do Jitterbit Harmony com acesso aos seguintes componentes:

  • Jitterbit Studio
  • Agente de Inteligência Competitiva da Jitterbit adquirido como um complemento de licença

Endpoints suportados

O agente de IA se conecta aos seguintes endpoints. Você pode acomodar outros sistemas modificando as configurações de endpoint e fluxos de trabalho do projeto.

Modelo de linguagem grande (LLM)

O agente de IA usa OpenAI como provedor de LLM para busca na web em tempo real e resumo de conteúdo. Para usar a OpenAI, você deve ter uma conta OpenAI com uma chave de API.

Email

O agente entrega boletins informativos de notícias por email usando SMTP. Você deve ter acesso a um servidor SMTP e credenciais válidas para a conta usada para enviar emails.

Instalação, configuração e operação

Siga estas etapas para instalar, configurar e operar este agente de IA:

  1. Baixar e instalar o projeto
  2. Configurar variáveis do projeto
  3. Testar conexões
  4. Adicionar modelos de email (opcional)
  5. Criar cronogramas
  6. Implantar o projeto
  7. Revisar fluxos de trabalho do projeto
  8. Disparar os fluxos de trabalho do projeto

Para orientação sobre solução de problemas, consulte Solução de problemas.

Baixar e instalar o projeto

Siga estas etapas para instalar o projeto do Studio para o agente de IA:

  1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

  2. Localize o agente de IA chamado Jitterbit Competitor Intel Agent. Para localizá-lo, use a barra de pesquisa ou, no painel Filters, em Type, selecione AI Agent para limitar a exibição apenas aos agentes de IA.

  3. Clique no link Documentation do agente para abrir sua documentação em uma aba separada. Mantenha a aba aberta para consultar depois de iniciar o projeto.

  4. Clique em Start Project para abrir um diálogo de configuração.

    Nota

    Se ainda não adquiriu o agente de IA, Get agent será exibido. Clique nele para abrir um diálogo informativo e, em seguida, clique em Submit para que um representante entre em contato sobre a compra do agente de IA.

    Dica

    O diálogo de configuração inclui um aviso para não importar o modelo antes de aplicar personalizações de endpoint. Esse aviso não se aplica a este agente de IA e pode ser ignorado. Siga a ordem de etapas recomendada nesta documentação.

  5. No diálogo Create a New Project, selecione um ambiente onde o projeto do Studio será criado e clique em Create Project.

  6. Após o diálogo de progresso indicar que o projeto foi criado, use o link do diálogo Go to Studio ou abra o projeto diretamente da página Projects do Studio.

Configurar variáveis do projeto

No projeto do Studio instalado do Marketplace, defina valores para as seguintes variáveis do projeto.

Para configurar variáveis do projeto, use o menu de ações do projeto e selecione Project Variables para abrir o drawer de configuração.

OpenAI

Nome da variável Descrição
openAI.apiKey Sua chave de API do OpenAI.
gpt.model O modelo OpenAI a usar. Por exemplo, gpt-4o.

Tópicos e concorrentes

Nome da variável Descrição
industryTrends.topic.list Lista separada por vírgulas de tópicos para monitoramento diário de notícias do setor. Por exemplo, AI in manufacturing, supply chain trends.
competitor.list Lista separada por vírgulas de nomes de empresas concorrentes para rastreamento semanal. Por exemplo, Acme Corp, Global Tech.
domain.list (Opcional) Lista separada por vírgulas de domínios para restringir buscas na web (até 5 domínios). Por exemplo, domain1.com,domain2.com. Requer que domain.filter seja definido como true.
domain.filter (Opcional) Defina como true para restringir buscas na web aos domínios listados em domain.list.

Email

Nome da variável Descrição
email.to Lista separada por vírgulas de endereços de email dos destinatários.
email.from O endereço de email do remetente.
email.smtp.host O endereço do host do servidor SMTP.
email.smtp.username O nome de usuário da conta SMTP.
email.smtp.password A senha da conta SMTP.

Empresa

Nome da variável Descrição
company.name O nome da sua empresa. Utilizado para personalizar o conteúdo dos resumos de notícias.
company.logo URL da imagem do seu logotipo. Exibida no modelo de email. Por exemplo, https://example.com/logo.png.
company.supportEmail O endereço de email de suporte da sua empresa. Exibido no rodapé do email. Por exemplo, support@yourcompany.com.

Testar conexões

Teste as configurações de endpoint para verificar a conectividade usando os valores de variáveis do projeto definidos.

Para testar conexões, acesse a aba Project endpoints and connectors da paleta de componentes de design, passe o mouse sobre cada endpoint e clique em Test.

Nota

O endpoint OpenAI pode retornar um erro 421: Could not connect to url https://api.openai.com. Se isso ocorrer, teste usando a URL completa https://api.openai.com/v1/responses. Após confirmar um resultado bem-sucedido, reverta a URL do endpoint para https://api.openai.com.

Adicionar modelos de email

O projeto inclui um modelo de email padrão que pode ser personalizado usando variáveis do projeto como company.name e company.logo. Esta etapa é opcional se o modelo padrão atender às suas necessidades.

Para usar um template de email HTML personalizado, abra o workflow Common e localize o script HTML Email Templates na operação Common Scripts. Substitua o template existente pelo seu HTML personalizado.

Nota

Qualquer template personalizado deve incluir o seguinte placeholder para que o conteúdo gerado por LLM seja injetado corretamente:

{{dynamic_email_content}}

Create schedules

O agente requer agendamentos de operação para ser executado automaticamente. O projeto inclui dois agendamentos pré-configurados: Daily Schedule e Weekly Schedule.

Para atribuir um agendamento a uma operação, use o menu de ações da operação e selecione Settings > Schedules. Atribua agendamentos às seguintes operações:

  • Controller | Industry Trends 48h — atribua o Daily Schedule ou um agendamento diário personalizado.
  • Controller | Competitor Watch 7day — atribua o Weekly Schedule ou um agendamento semanal personalizado.

Deploy the project

Implante o projeto do Studio.

Para implantar o projeto, use o menu de ações do projeto e selecione Deploy.

Review project workflows

O projeto do Studio contém quatro workflows que implementam a funcionalidade do Competitor Intel Agent.

Workflow Categoria Descrição
OpenAI | Web Search IA e orquestração Gerencia a lógica principal de IA, enviando prompts para OpenAI e processando os resultados de busca na web retornados.
Utility | Prompts IA e orquestração Constrói prompts para cada trabalho agendado e ativa as operações downstream correspondentes.
Utility | Emails Notificações Formata resultados de busca em conteúdo de email HTML e entrega o briefing aos destinatários configurados.
Common Utilitários Contém scripts compartilhados usados em todo o projeto.

Este workflow gerencia a interação principal com IA. Envia um prompt estruturado para a OpenAI Responses API, que realiza uma busca na web em tempo real e retorna resultados resumidos. Os resultados são passados para o workflow de entrega de email.

Utility | Prompts

Este workflow constrói os prompts de busca com base na lista de tópicos configurada ou na lista de concorrentes e ativa as operações do controlador agendadas. Ele serve como ponto de entrada para execuções diárias e semanais.

Utility | Emails

Este workflow recebe conteúdo resumido do workflow OpenAI | Web Search, o injeta no template de email HTML usando o placeholder {{ dynamic_email_content }} e envia o email formatado via SMTP para os endereços configurados em email.to.

Common

Este workflow contém scripts reutilizáveis, incluindo o script HTML Email Templates que define o formato de email padrão. Personalize este script para substituir o template padrão por um design personalizado.

Trigger the project workflows

O agente é executado automaticamente com base nos agendamentos atribuídos durante a configuração. Para testar o agente manualmente antes de depender da execução agendada, execute as seguintes operações:

  • Controller | Industry Trends 48h
  • Controller | Competitor Watch 7day

Para executar uma operação manualmente, passe o mouse sobre a operação e selecione Run.

Todos os outros workflows são acionados por essas operações do controlador e não devem ser executados independentemente.

Solução de problemas

Se encontrar problemas, analise os seguintes logs para obter informações detalhadas de solução de problemas:

Para assistência adicional, entre em contato com o suporte do Jitterbit.