Jitterbit Competitor Intel Agent
Overview
The Jitterbit Competitor Intel Agent (Competitor Intel Agent) is an AI agent provided through Jitterbit Marketplace. This agent automates market intelligence gathering by using AI-powered web search to identify, summarize, and deliver relevant industry news and competitor updates to your team. This agent uses the Retrieval-Augmented Generation (RAG) technique, which combines LLM reasoning with access to external tools and data sources.
The agent runs on configurable schedules — daily for industry trend monitoring and weekly for competitor tracking. Each run performs a targeted web search, summarizes the results into a structured HTML email, and delivers the briefing directly to configured recipients. No manual input is required after the initial setup.
The agent performs the following tasks:
- Scans the web weekly for competitor updates, including product launches, leadership changes, and press releases.
- Scans the web daily for industry news related to configured topics, filtering for high-impact stories from the past 24–48 hours.
- Summarizes search results into concise, structured email briefings tailored to your company context.
- Delivers formatted HTML email reports automatically to configured recipients.
This document explains how to set up and operate this AI agent. It covers architecture, prerequisites, and steps to install, configure, and operate the AI agent.
AI agent architecture
This AI agent automates market intelligence delivery using AI-powered web search and scheduled operations. A typical workflow follows these steps:
- A daily or weekly operation schedule triggers the appropriate controller operation.
- A search prompt is built based on the configured topics or competitors.
- The prompt is sent to OpenAI, which performs a real-time web search and returns summarized results.
- The results are formatted into a structured HTML email using the project's pre-defined template and your company context.
- The formatted email is sent to the configured recipients via SMTP.
Workflow diagram
The following diagram shows the main request-handling workflow for this integration.
(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
Prerequisites
You need the following components to use this AI agent.
Harmony components
You must have a Jitterbit Harmony license with access to the following components:
- Jitterbit Studio
- Jitterbit Competitor Intel Agent purchased as a license add-on
Supported endpoints
The AI agent connects to the following endpoints. You can accommodate other systems by modifying the project's endpoint configurations and workflows.
Large language model (LLM)
The AI agent uses OpenAI as the LLM provider for real-time web search and content summarization. To use OpenAI, you must have an OpenAI account with an API key.
The agent delivers news briefings via email using SMTP. You must have access to an SMTP server and valid credentials for the account used to send email.
Installation, configuration, and operation
Follow these steps to install, configure, and operate this AI agent:
- Download and install the project
- Configure project variables
- Test connections
- Add email templates (optional)
- Create schedules
- Deploy the project
- Review project workflows
- Trigger the project workflows
For troubleshooting guidance, see Troubleshooting.
Download and install the project
Follow these steps to install the Studio project for the AI agent:
-
Log in to the Harmony portal at https://login.jitterbit.com and open Marketplace.
-
Locate the AI agent named Jitterbit Competitor Intel Agent. To locate the agent, use the search bar or, in the Filters pane under Type, select AI Agent to limit the display to AI agents.
-
Click the agent's Documentation link to open its documentation in a separate tab. Keep the tab open to refer back to after starting the project.
-
Click Start Project to open a configuration dialog.
Note
If you have not yet purchased the AI agent, Get this agent is displayed instead. Click it to open an informational dialog, then click Submit to have a representative contact you about purchasing the AI agent.
Tip
The configuration dialog includes a warning not to import the template before applying endpoint customizations. That warning does not apply to this AI agent and can be ignored. Follow the recommended order of steps in this documentation instead.
-
In the Create a New Project dialog, select an environment where the Studio project will be created, then click Create Project.
-
After the progress dialog indicates the project is created, use the dialog link Go to Studio or open the project directly from the Studio Projects page.
Configure project variables
In the Studio project installed from Marketplace, set values for the following project variables.
To configure project variables, use the project's actions menu and select Project Variables to open the configuration drawer.
OpenAI
| Variable name | Description |
|---|---|
openAI.apiKey |
Your OpenAI API key. |
gpt.model |
The OpenAI model to use. For example, gpt-4o. |
Topics and competitors
| Variable name | Description |
|---|---|
industryTrends.topic.list |
Comma-separated list of topics for daily industry news monitoring. For example, AI in manufacturing, supply chain trends. |
competitor.list |
Comma-separated list of competitor company names for weekly tracking. For example, Acme Corp, Global Tech. |
domain.list |
(Optional) Comma-separated list of domains to restrict web searches to. For example, domain1.com,domain2.com. Requires domain.filter to be set to true. |
domain.filter |
(Optional) Set to true to restrict web searches to the domains listed in domain.list. |
| Variable name | Description |
|---|---|
email.to |
Comma-separated list of recipient email addresses. |
email.from |
The sender email address. |
email.smtp.host |
The SMTP server host address. |
email.smtp.username |
The SMTP account username. |
email.smtp.password |
The SMTP account password. |
Company
| Variable name | Description |
|---|---|
company.name |
Your company name. Used to tailor the content of news summaries. |
company.logo |
URL of your company logo image. Displayed in the email template. For example, https://example.com/logo.png. |
company.supportEmail |
Your company's support email address. Displayed in the email footer. For example, support@yourcompany.com. |
Test connections
Test the endpoint configurations to verify connectivity using the defined project variable values.
To test connections, go to the design component palette's Project endpoints and connectors tab, hover over each endpoint, and click Test.
Note
The OpenAI endpoint may return a 421: Could not connect to url https://api.openai.com error. If this occurs, test using the complete URL https://api.openai.com/v1/responses. After confirming a successful result, revert the endpoint URL back to https://api.openai.com.
Add email templates
The project includes a default email template that can be personalized using project variables such as company.name and company.logo. This step is optional if the default template meets your needs.
To use a custom HTML email template, open the Common workflow and locate the HTML Email Templates script within the Common Scripts operation. Replace the existing template with your custom HTML.
Note
Any custom template must include the following placeholder so that LLM-generated content is injected correctly:
{{dynamic_email_content}}
Create schedules
The agent requires operation schedules to run automatically. The project includes two pre-configured schedules: Daily Schedule and Weekly Schedule.
To assign a schedule to an operation, use the operation's actions menu and select Settings > Schedules. Assign schedules to the following operations:
Controller | Industry Trends 48h— assign the Daily Schedule or a custom daily schedule.Controller | Competitor Watch 7day— assign the Weekly Schedule or a custom weekly schedule.
Deploy the project
Deploy the Studio project.
To deploy the project, use the project's actions menu and select Deploy.
Review project workflows
The Studio project contains four workflows that implement the Competitor Intel Agent functionality.
| Workflow | Category | Description |
|---|---|---|
| OpenAI | Web Search | AI and orchestration | Handles the main AI logic, sending prompts to OpenAI and processing the returned web search results. |
| Utility | Prompts | AI and orchestration | Builds prompts for each scheduled job and triggers the corresponding downstream operations. |
| Utility | Emails | Notifications | Formats search results into HTML email content and delivers the briefing to configured recipients. |
| Common | Utilities | Contains shared scripts used across the project. |
OpenAI | Web Search
This workflow handles the core AI interaction. It sends a structured prompt to the OpenAI Responses API, which performs a real-time web search and returns summarized results. The results are passed downstream to the email delivery workflow.
Utility | Prompts
This workflow constructs the search prompts based on the configured topic list or competitor list and triggers the scheduled controller operations. It serves as the entry point for both daily and weekly runs.
Utility | Emails
This workflow receives summarized content from the OpenAI | Web Search workflow, injects it into the HTML email template using the {{ dynamic_email_content }} placeholder, and sends the formatted email via SMTP to the addresses configured in email.to.
Common
This workflow contains reusable scripts, including the HTML Email Templates script that defines the default email format. Customize this script to replace the default template with a custom design.
Trigger the project workflows
The agent runs automatically based on the schedules assigned during setup. To test the agent manually before relying on scheduled execution, run the following operations:
Controller | Industry Trends 48hController | Competitor Watch 7day
To run an operation manually, hover over the operation and select Run.
All other workflows are triggered by these controller operations and are not intended to be run independently.
Troubleshooting
If you encounter issues, review the following logs for detailed troubleshooting information:
For additional assistance, contact Jitterbit support.