Ir para o conteúdo

Agente de Inteligência Competitiva Jitterbit

Visão Geral

O Agente de Inteligência Competitiva Jitterbit (Agente de Inteligência Competitiva) é um agente de IA fornecido através do Jitterbit Marketplace. Este agente automatiza a coleta de inteligência de mercado utilizando busca na web impulsionada por IA para identificar, resumir e entregar notícias relevantes da indústria e atualizações de concorrentes para sua equipe. Este agente utiliza a técnica de Geração Aumentada por Recuperação (RAG), que combina raciocínio de LLM com acesso a ferramentas externas e fontes de dados.

O agente opera em horários configuráveis — diariamente para monitoramento de tendências da indústria 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 briefing diretamente aos destinatários configurados. Nenhuma entrada manual é necessária após a configuração inicial.

O agente realiza as seguintes tarefas:

  • Escaneia a web semanalmente em busca de atualizações de concorrentes, incluindo lançamentos de produtos, mudanças na liderança e comunicados à imprensa.
  • Escaneia a web diariamente em busca de notícias da indústria relacionadas aos tópicos configurados, filtrando histórias de alto impacto das últimas 24–48 horas.
  • Resume os resultados da busca em briefings por email concisos e estruturados adaptados ao contexto da sua empresa.
  • Entrega relatórios de email HTML formatados 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 utilizando busca na web impulsionada por IA e operações agendadas. Um fluxo de trabalho típico segue estas etapas:

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

Diagrama de fluxo

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

--- config: 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 seguintes componentes 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 Intel de Concorrentes 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 o provedor de LLM para busca na web em tempo real e resumo de conteúdo. Para usar o OpenAI, você deve ter uma conta OpenAI com uma chave de API.

Email

O agente entrega briefings de notícias via 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. Acionar os fluxos de trabalho do projeto

Para orientações de 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 o Marketplace.

  2. Localize o agente de IA chamado Agente de Intel de Concorrentes Jitterbit. Para localizar o agente, use a barra de pesquisa ou, no painel Filtros sob Tipo, selecione Agente de IA para limitar a exibição a agentes de IA.

  3. Clique no link Documentação 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 Iniciar Projeto para abrir uma caixa de diálogo de configuração.

    Nota

    Se você ainda não adquiriu o agente de IA, Adquirir este agente será exibido em vez disso. Clique nele para abrir uma caixa de diálogo informativa e, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.

    Dica

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

  5. Na caixa de diálogo Criar um Novo Projeto, selecione um ambiente onde o projeto do Studio será criado e clique em Criar Projeto.

  6. Após a caixa de diálogo de progresso indicar que o projeto foi criado, use o link da caixa de diálogo Ir para o Studio ou abra o projeto diretamente na página Projetos do Studio.

Configurar variáveis do projeto

No projeto do Studio instalado a partir 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 Variáveis do Projeto para abrir a gaveta de configuração.

OpenAI

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

Tópicos e concorrentes

Nome da variável Descrição
industryTrends.topic.list Lista de tópicos separados por vírgula para monitoramento diário de notícias do setor. Por exemplo, IA na manufatura, tendências da cadeia de suprimentos.
competitor.list Lista de nomes de empresas concorrentes separados por vírgula para acompanhamento semanal. Por exemplo, Acme Corp, Global Tech.
domain.list (Opcional) Lista de domínios separados por vírgula para restringir as pesquisas na web. Por exemplo, domain1.com,domain2.com. Requer que domain.filter esteja definido como true.
domain.filter (Opcional) Defina como true para restringir as pesquisas na web aos domínios listados em domain.list.

Email

Nome da variável Descrição
email.to Lista de endereços de email dos destinatários, separados por vírgula.
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. Usado para personalizar o conteúdo dos resumos de notícias.
company.logo URL da imagem do logotipo da sua empresa. Exibido 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 das variáveis de projeto definidos.

Para testar conexões, vá até a aba Endpoints e conectores do projeto na paleta de componentes de design , passe o mouse sobre cada endpoint e clique em Testar.

Nota

O endpoint da 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 de projeto, como company.name e company.logo. Esta etapa é opcional se o modelo padrão atender às suas necessidades.

Para usar um modelo de email HTML personalizado, abra o fluxo de trabalho Comum e localize o script Modelos de Email HTML dentro da operação Scripts Comuns. Substitua o modelo existente pelo seu HTML personalizado.

Nota

Qualquer modelo personalizado deve incluir o seguinte espaço reservado para que o conteúdo gerado pelo LLM seja injetado corretamente:

{{dynamic_email_content}}

Criar agendamentos

O agente requer agendamentos de operação para ser executado automaticamente. O projeto inclui dois agendamentos pré-configurados: Agendamento Diário e Agendamento Semanal.

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

  • Controller | Tendências da Indústria 48h — atribua o Agendamento Diário ou um agendamento diário personalizado.
  • Controller | Monitoramento de Concorrentes 7dias — atribua o Agendamento Semanal ou um agendamento semanal personalizado.

Implantar o projeto

Implantar o projeto do Studio.

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

Revisar fluxos de trabalho do projeto

O projeto do Studio contém quatro fluxos de trabalho que implementam a funcionalidade do Agente de Inteligência de Concorrentes.

Fluxo de Trabalho Categoria Descrição
OpenAI | Pesquisa na Web IA e orquestração Lida com a lógica principal de IA, enviando prompts para a OpenAI e processando os resultados da pesquisa na web retornados.
Utility | Prompts IA e orquestração Constrói prompts para cada trabalho agendado e aciona as operações subsequentes correspondentes.
Utility | Emails Notificações Formata os resultados da pesquisa em conteúdo de email HTML e entrega o briefing aos destinatários configurados.
Comum Utilitários Contém scripts compartilhados usados em todo o projeto.

Este fluxo de trabalho lida com a interação central de IA. Ele envia um prompt estruturado para a API de Respostas da OpenAI, que realiza uma pesquisa na web em tempo real e retorna resultados resumidos. Os resultados são passados para o fluxo de trabalho de entrega de email.

Utility | Prompts

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

Utility | Emails

Este fluxo de trabalho recebe conteúdo resumido do fluxo de trabalho OpenAI | Web Search, injeta-o no modelo de email HTML usando o espaço reservado {{ dynamic_email_content }} e envia o email formatado via SMTP para os endereços configurados em email.to.

Comum

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

Acione os fluxos de trabalho do projeto

O agente é executado automaticamente com base nos horários atribuídos durante a configuração. Para testar o agente manualmente antes de confiar na 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 fluxos de trabalho são acionados por essas operações de controle e não devem ser executados de forma independente.

Solução de problemas

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

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