Competitive Intelligence Monitor - Track Changes Over Time

Agent using the Parallel Monitor API at a 1-day frequency to create topic monitors, list active ones, and report detected change events with sources.

The Monitor API watches a topic on a schedule and records events when something changes. This turns “research once” into “stay informed”.

competitive_intel_monitor.py

"""
Competitive Intelligence Monitor - Track Changes Over Time
==========================================================

The Monitor API watches a topic on a schedule and records events when
something changes. This turns "research once" into "stay informed".

Here an agent sets up a monitor, lists what is active, and reports on any
events the monitor has detected - the core loop of a standing intelligence
desk.

Note: monitors run server-side on their own schedule, so a freshly created
monitor will not have events yet. Re-run later to see detected changes.

Prerequisites:
- pip install parallel-web
- export PARALLEL_API_KEY=<your-api-key>
"""

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.parallel import ParallelTools

# ---------------------------------------------------------------------------
# Tools - Monitor API
# ---------------------------------------------------------------------------
monitor_tools = ParallelTools(
    enable_search=False,
    enable_extract=False,
    enable_monitor=True,
    default_monitor_frequency="1d",
)

# ---------------------------------------------------------------------------
# Create the Agent
# ---------------------------------------------------------------------------
intel_agent = Agent(
    model=OpenAIResponses(id="gpt-5.4"),
    tools=[monitor_tools],
    markdown=True,
    instructions=[
        "You run a competitive-intelligence desk.",
        "Use create_monitor to start tracking a topic, list_monitors to see "
        "what is active, and get_monitor_events to report detected changes.",
        "Summarize events clearly and cite the sources behind each change.",
    ],
)

# ---------------------------------------------------------------------------
# Run the Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    intel_agent.print_response(
        "Start monitoring new AI model and product launches by frontier labs, "
        "then show me what is currently being tracked.",
        stream=True,
    )

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno openai parallel-web
   
3. Export your API keys

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   export PARALLEL_API_KEY="your_parallel_api_key_here"
   

   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   $Env:PARALLEL_API_KEY="your_parallel_api_key_here"
   
4. Run the example

   Save the code above as competitive_intel_monitor.py, then run:

   python competitive_intel_monitor.py
   

Full source: cookbook/integrations/parallel/08_competitive_intel_monitor.py